Compartilhar via


az acr task

Gerencie uma coleção de etapas para a criação, teste e sistema operacional & Framework aplicação de patch de imagens de contêiner usando Os Registros de Contêiner do Azure.

Comandos

Nome Description Tipo Status
az acr task cancel-run

Cancele uma execução especificada de um Registro de Contêiner do Azure.

Core GA
az acr task create

Crie uma série de etapas para compilar, testar e os contêineres de aplicação de patch da Estrutura de & do sistema operacional. As tarefas dão suporte a gatilhos de confirmações do git e atualizações de imagem base.

Core GA
az acr task credential

Gerenciar credenciais para uma tarefa. Consulte https://aka.ms/acr/tasks/cross-registry-authentication para obter mais informações.

Core GA
az acr task credential add

Adicione uma credencial de logon do Registro personalizada à tarefa.

Core GA
az acr task credential list

Liste todas as credenciais personalizadas do Registro para a tarefa.

Core GA
az acr task credential remove

Remova a credencial de uma tarefa.

Core GA
az acr task credential update

Atualize a credencial de logon do Registro para uma tarefa.

Core GA
az acr task delete

Exclua uma tarefa de um Registro de Contêiner do Azure.

Core GA
az acr task identity

Identidades Gerenciadas para Tarefa. Consulte https://aka.ms/acr/tasks/task-create-managed-identity para obter mais informações.

Core GA
az acr task identity assign

Atualize a identidade gerenciada para uma tarefa.

Core GA
az acr task identity remove

Remova identidades gerenciadas para uma tarefa.

Core GA
az acr task identity show

Exiba as identidades gerenciadas para a tarefa.

Core GA
az acr task list

Liste as tarefas de um Registro de Contêiner do Azure.

Core GA
az acr task list-runs

Liste todas as execuções executadas para um Registro de Contêiner do Azure, com a capacidade de filtrar por uma Tarefa específica.

Core GA
az acr task logs

Mostrar logs para uma execução específica. Se nenhuma ID de execução for fornecida, mostre logs para a última execução criada.

Core GA
az acr task run

Dispare manualmente uma tarefa que, de outra forma, poderia estar aguardando confirmações do git ou gatilhos de atualização de imagem base.

Core GA
az acr task show

Obtenha as propriedades de uma tarefa nomeada para um Registro de Contêiner do Azure.

Core GA
az acr task show-run

Obtenha as propriedades de uma execução especificada de uma Tarefa do Registro de Contêiner do Azure.

Core GA
az acr task timer

Gerenciar gatilhos de temporizador para uma tarefa.

Core GA
az acr task timer add

Adicione um gatilho de temporizador a uma tarefa.

Core GA
az acr task timer list

Listar todos os gatilhos de temporizador para uma tarefa.

Core GA
az acr task timer remove

Remova um gatilho de temporizador de uma tarefa.

Core GA
az acr task timer update

Atualize o gatilho do temporizador para uma tarefa.

Core GA
az acr task update

Atualize uma tarefa para um Registro de Contêiner do Azure.

Core GA
az acr task update-run

Corrija as propriedades de execução de uma Tarefa do Registro de Contêiner do Azure.

Core GA

az acr task cancel-run

Cancele uma execução especificada de um Registro de Contêiner do Azure.

az acr task cancel-run --registry
                       --run-id
                       [--resource-group]

Exemplos

Cancelar uma execução

az acr task cancel-run -r myregistry --run-id runId

Parâmetros Exigidos

--registry -r

O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

--run-id

O identificador de execução exclusivo.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az acr task create

Crie uma série de etapas para compilar, testar e os contêineres de aplicação de patch da Estrutura de & do sistema operacional. As tarefas dão suporte a gatilhos de confirmações do git e atualizações de imagem base.

az acr task create --name
                   --registry
                   [--agent-pool]
                   [--arg]
                   [--assign-identity]
                   [--auth-mode {Default, None}]
                   [--base-image-trigger-enabled {false, true}]
                   [--base-image-trigger-name]
                   [--base-image-trigger-type {All, Runtime}]
                   [--cmd]
                   [--commit-trigger-enabled {false, true}]
                   [--context]
                   [--cpu]
                   [--file]
                   [--git-access-token]
                   [--image]
                   [--is-system-task]
                   [--log-template]
                   [--no-cache {false, true}]
                   [--no-push {false, true}]
                   [--platform]
                   [--pull-request-trigger-enabled {false, true}]
                   [--resource-group]
                   [--schedule]
                   [--secret-arg]
                   [--set]
                   [--set-secret]
                   [--source-acr-auth-id]
                   [--source-trigger-name]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

Exemplos

Crie uma tarefa sem o local de origem.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null

Crie uma tarefa com a definição da entrada padrão e com um gatilho de temporizador que executa a tarefa na parte superior de cada hora usando o nome do gatilho padrão. 'Ctrl + Z'(Windows) ou 'Ctrl + D'(Linux) encerra o fluxo de entrada.

cat task.yaml | az acr task create -n hello-world -r myregistry -f - -c /dev/null \
    --schedule "0 */1 * * *"
az acr task create -n hello-world -r myregistry -f - -c /dev/null --schedule "0 */1 * * *"

Crie uma tarefa linux a partir de um repositório público do GitHub que compila a imagem hello-world sem gatilhos e usa um argumento de build.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    -c https://github.com/Azure/acr-builder.git -f Dockerfile \
    --commit-trigger-enabled false --base-image-trigger-enabled false \
    --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git

Crie uma tarefa do Linux usando um branch específico de um repositório privado do Azure DevOps que cria a imagem hello-world na arquitetura do Arm (variante V7) e tem gatilhos habilitados.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    -c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder \
    -f Dockerfile --git-access-token <Personal Access Token> --platform linux/arm/v7

Crie uma tarefa do Linux a partir de um repositório público do GitHub que compila a imagem hello-world com um gatilho de solicitação de pull e confirmação git habilitado. Observe que essa tarefa não usa o Registro de Origem (myregistry), portanto, podemos definir explicitamente o modo de autenticação como Nenhum para ela.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry  -f Dockerfile \
    --no-push true --auth-mode None -c https://github.com/Azure-Samples/acr-build-helloworld-node.git \
    --pull-request-trigger-enabled true --git-access-token 000000000000000000000000000000000

Crie uma tarefa do Windows a partir de um repositório público do GitHub que compila a imagem do Construtor de Contêineres do Azure na arquitetura Amd64 com apenas o gatilho de imagem base habilitado.

az acr task create -t acb:{{.Run.ID}} -n acb-win -r myregistry \
    -c https://github.com/Azure/acr-builder.git -f Windows.Dockerfile \
    --commit-trigger-enabled false --platform Windows/amd64

Crie uma tarefa de várias etapas do Linux de um repositório público do GitHub com identidades gerenciadas atribuídas pelo sistema e atribuídas pelo usuário e imagem base, confirmação do git, solicitação de pull e gatilhos de temporizador que executam a tarefa ao meio-dia de segunda a sexta-feira com o nome do gatilho do temporizador fornecido.

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    --pull-request-trigger-enabled true --schedule "dailyTimer:0 12 * * Mon-Fri" \
    -c https://github.com/Azure-Samples/acr-tasks.git#:multipleRegistries -f testtask.yaml \
    --assign-identity [system] "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"

Crie uma tarefa sem o local de origem em um registro de permissão de repositório baseado em ABAC e especifique uma identidade gerenciada atribuída pelo sistema usada para autenticação com o registro de origem.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id [system]

Crie uma tarefa sem o local de origem em um registro de permissão de repositório baseado em ABAC e especifique uma identidade gerenciada atribuída pelo usuário usada para autenticação com o registro de origem.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"

Crie uma tarefa sem o local de origem em um registro de permissão de repositório baseado em ABAC com identidades gerenciadas atribuídas pelo sistema e atribuídas pelo usuário e especifique a identidade gerenciada atribuída pelo sistema usada para autenticação com o registro de origem.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id [system]
    --assign-identity [system] "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"

Parâmetros Exigidos

--name -n

O nome da tarefa.

--registry -r

O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--agent-pool
Versão Prévia

O nome do pool de agentes.

--arg

Argumento de build no formato '--arg name[=value]'. Há suporte para múltiplos passando '--arg name[=value]' várias vezes. IMPORTANTE: esse parâmetro não deve incluir senhas, tokens de acesso ou informações confidenciais de qualquer tipo. Esse valor de parâmetro ficará visível para a equipe do ACR para fins de depuração.

--assign-identity

Atribua identidades gerenciadas à tarefa. Use '[system]' para se referir à identidade atribuída pelo sistema ou a uma ID de recurso para se referir a uma identidade atribuída pelo usuário. Consulte https://aka.ms/acr/tasks/task-create-managed-identity para obter mais informações.

--auth-mode

Modo de autenticação do registro de origem.

Propriedade Valor
Valores aceitos: Default, None
--base-image-trigger-enabled

Indica se o gatilho de imagem base está habilitado.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
Valor padrão: True
Valores aceitos: false, true
--base-image-trigger-name

O nome do gatilho de imagem base.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
Valor padrão: defaultBaseimageTriggerName
--base-image-trigger-type

O tipo do gatilho automático para atualizações de dependência de imagem base.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
Valor padrão: Runtime
Valores aceitos: All, Runtime
--cmd

Comandos a serem executados. Isso também dá suporte a parâmetros adicionais de execução do Docker (https://docs.docker.com/engine/reference/commandline/run/) ou até mesmo a outros comandos do Docker (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Indica se o gatilho de confirmação do controle do código-fonte está habilitado.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
Valor padrão: True
Valores aceitos: false, true
--context -c

A URL completa para o repositório de código-fonte (requer sufixo '.git' para um repositório github) ou uma tarball remota (por exemplo, 'http://server/context.tar.gz') ou o repositório de um artefato OCI em um registro de contêiner do Azure (por exemplo, 'oci://myregistry.azurecr.io/myartifact:mytag'). Se '/dev/null' for especificado, o valor será definido como Nenhum e ignorado. Esse é um argumento necessário se a tarefa não for uma tarefa do sistema.

--cpu

A configuração da CPU em termos de número de núcleos necessários para a execução.

Propriedade Valor
Valor padrão: 2
--file -f

Caminho relativo do arquivo de tarefa/docker para a pasta raiz do código-fonte. Os arquivos de tarefa devem ser sufixos com '.yaml' ou canalizados da entrada padrão usando '-'.

--git-access-token

O token de acesso usado para acessar o provedor de controle do código-fonte.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
--image -t

O nome e a marca da imagem usando o formato: '-t repositório/image:tag'. Há suporte para várias marcas passando -t várias vezes.

--is-system-task
Versão Prévia

Indica se o recurso de tarefa é uma tarefa do sistema. O nome da tarefa deve ser 'quicktask'. Aplicável somente ao registro habilitado para CMK.

Propriedade Valor
Valor padrão: False
--log-template
Versão Prévia

O repositório e o modelo de marca para executar o artefato de log usando o formato: 'log/reppo:tag' (por exemplo, 'acr/logs:{.Run.ID}}'). Aplicável somente ao registro habilitado para CMK.

--no-cache

Indica se o cache de imagens está habilitado.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--no-push

Indica se a imagem criada deve ser enviada por push para o Registro.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--platform

A plataforma em que o build/tarefa é executado, por exemplo, "windows" e "linux". Quando é usado em comandos de build, ele também pode ser especificado no formato 'os/arch/variant' para a imagem resultante. Por exemplo, linux/arm/v7. As partes 'arch' e 'variant' são opcionais.

--pull-request-trigger-enabled

Indica se o gatilho de solicitação de pull do controle do código-fonte está habilitado. O gatilho é desabilitado por padrão.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
Valor padrão: False
Valores aceitos: false, true
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--schedule

Agendar um gatilho de temporizador representado como uma expressão cron. Um nome de gatilho opcional pode ser especificado usando --schedule name:schedule formato. Múltiplos com suporte passando --schedule várias vezes.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
--secret-arg

Argumento de build secreto no formato '--secret-arg name[=value]'. Há suporte para múltiplos passando '--secret-arg name[=value]' várias vezes. Esse valor de parâmetro não é exibido para a equipe do ACR e é mais adequado para informações confidenciais.

--set

Valor da tarefa no formato '--set name[=value]'. Múltiplos com suporte passando --set várias vezes.

--set-secret

Valor da tarefa secreta no formato '--set-secret name[=value]'. Múltiplos com suporte passando --set-secret várias vezes.

--source-acr-auth-id

Atribua a identidade gerenciada usada para logon do registro de origem. Use '[system]' para se referir à identidade atribuída pelo sistema ou a uma ID de recurso para se referir a uma identidade gerenciada atribuída pelo usuário.

--source-trigger-name

O nome do gatilho de origem.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
Valor padrão: defaultSourceTriggerName
--status

O status atual da tarefa.

Propriedade Valor
Valor padrão: Enabled
Valores aceitos: Disabled, Enabled
--target

O nome do estágio de build de destino.

--timeout

O tempo limite em segundos.

Propriedade Valor
Valor padrão: 3600
--update-trigger-endpoint
Versão Prévia

A URL completa do ponto de extremidade para receber notificações de gatilho de atualização de imagem base.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
--update-trigger-payload-type
Versão Prévia

Indica se os metadados devem ser incluídos sobre o gatilho de imagem base no conteúdo junto com o token de gatilho de atualização, quando uma notificação é enviada.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
Valor padrão: Default
Valores aceitos: Default, Token
--values

O caminho do arquivo de valores/parâmetros da tarefa em relação ao contexto de origem.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az acr task delete

Exclua uma tarefa de um Registro de Contêiner do Azure.

az acr task delete --name
                   --registry
                   [--resource-group]
                   [--yes]

Exemplos

Exclua uma tarefa de um Registro de Contêiner do Azure.

az acr task delete -n MyTask -r myregistry

Parâmetros Exigidos

--name -n

O nome da tarefa.

--registry -r

O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az acr task list

Liste as tarefas de um Registro de Contêiner do Azure.

az acr task list --registry
                 [--resource-group]

Exemplos

Listar tarefas e mostrar os resultados em uma tabela.

az acr task list -r myregistry -o table

Parâmetros Exigidos

--registry -r

O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az acr task list-runs

Liste todas as execuções executadas para um Registro de Contêiner do Azure, com a capacidade de filtrar por uma Tarefa específica.

az acr task list-runs --registry
                      [--image]
                      [--name]
                      [--resource-group]
                      [--run-status {Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout}]
                      [--top]

Exemplos

Liste todas as execuções de um registro e mostre os resultados em uma tabela.

az acr task list-runs -r myregistry -o table

A lista é executada para uma tarefa e mostra os resultados em uma tabela.

az acr task list-runs -r myregistry -n MyTask -o table

Liste as últimas 10 execuções bem-sucedidas para um registro e mostre os resultados em uma tabela.

az acr task list-runs -r myregistry --run-status Succeeded --top 10 -o table

Lista todas as execuções que criaram a imagem 'hello-world' para um registro e mostram os resultados em uma tabela.

az acr task list-runs -r myregistry --image hello-world -o table

Parâmetros Exigidos

--registry -r

O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--image -t

O nome da imagem. Pode incluir uma marca no formato 'name:tag' ou digest no formato 'name@digest'.

--name -n

O nome da tarefa.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--run-status

O status atual da execução.

Propriedade Valor
Valores aceitos: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout
--top

Limite o número de execuções mais recentes nos resultados.

Propriedade Valor
Valor padrão: 15
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az acr task logs

Mostrar logs para uma execução específica. Se nenhuma ID de execução for fornecida, mostre logs para a última execução criada.

az acr task logs --registry
                 [--image]
                 [--name]
                 [--no-format]
                 [--resource-group]
                 [--run-id]

Exemplos

Mostrar logs para a última execução criada no Registro.

az acr task logs -r myregistry

Mostrar logs para a última execução criada no registro, filtrado por tarefa.

az acr task logs -r myregistry -n MyTask

Mostrar logs para uma execução específica.

az acr task logs -r myregistry --run-id runId

Mostrar logs para a última execução criada no registro que criou a imagem 'hello-world'.

az acr task logs -r myregistry --image hello-world

Parâmetros Exigidos

--registry -r

O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--image -t

O nome da imagem. Pode incluir uma marca no formato 'name:tag' ou digest no formato 'name@digest'.

--name -n

O nome da tarefa.

--no-format

Indica se os logs devem ser exibidos em formato bruto.

Propriedade Valor
Valor padrão: False
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--run-id

O identificador de execução exclusivo.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az acr task run

Dispare manualmente uma tarefa que, de outra forma, poderia estar aguardando confirmações do git ou gatilhos de atualização de imagem base.

az acr task run --name
                --registry
                [--agent-pool]
                [--arg]
                [--context]
                [--file]
                [--log-template]
                [--no-format]
                [--no-logs]
                [--no-wait]
                [--resource-group]
                [--secret-arg]
                [--set]
                [--set-secret]
                [--target]
                [--update-trigger-token]

Exemplos

Disparar uma execução de tarefa.

az acr task run -n MyTask -r myregistry

Dispare uma tarefa executada substituindo o contexto e o arquivo passados durante a criação de tarefas com um repositório remoto.

az acr task run -n MyTask -r myregistry -c https://github.com/Azure-Samples/acr-build-helloworld-node.git -f Dockerfile

Dispare uma tarefa executada substituindo o contexto e o arquivo passados durante a criação de tarefas com um contexto local.

az acr task run -n MyTask -r myregistry -c . -f Dockerfile

Dispare uma tarefa executada adicionando ou substituindo argumentos de build definidos durante a criação de tarefas.

az acr task run -n MyTask -r myregistry --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git

Parâmetros Exigidos

--name -n

O nome da tarefa.

--registry -r

O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--agent-pool
Versão Prévia

O nome do pool de agentes.

--arg

Argumento de build no formato '--arg name[=value]'. Há suporte para múltiplos passando '--arg name[=value]' várias vezes. IMPORTANTE: esse parâmetro não deve incluir senhas, tokens de acesso ou informações confidenciais de qualquer tipo. Esse valor de parâmetro ficará visível para a equipe do ACR para fins de depuração.

--context -c

A URL completa para o repositório de código-fonte (requer sufixo '.git' para um repositório github) ou uma tarball remota (por exemplo, 'http://server/context.tar.gz') ou o repositório de um artefato OCI em um registro de contêiner do Azure (por exemplo, 'oci://myregistry.azurecr.io/myartifact:mytag'). Se '/dev/null' for especificado, o valor será definido como Nenhum e ignorado. Esse é um argumento necessário se a tarefa não for uma tarefa do sistema.

--file -f

Caminho relativo do arquivo de tarefa/docker para a pasta raiz do código-fonte. Os arquivos de tarefa devem ser sufixos com '.yaml' ou canalizados da entrada padrão usando '-'.

--log-template
Versão Prévia

O repositório e o modelo de marca para executar o artefato de log usando o formato: 'log/reppo:tag' (por exemplo, 'acr/logs:{.Run.ID}}'). Aplicável somente ao registro habilitado para CMK.

--no-format

Indica se os logs devem ser exibidos em formato bruto.

Propriedade Valor
Valor padrão: False
--no-logs

Não mostre logs depois de enfileirar o build com êxito.

Propriedade Valor
Valor padrão: False
--no-wait

Não aguarde a conclusão da execução e retorne imediatamente depois de enfileirar a execução.

Propriedade Valor
Valor padrão: False
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--secret-arg

Argumento de build secreto no formato '--secret-arg name[=value]'. Há suporte para múltiplos passando '--secret-arg name[=value]' várias vezes. Esse valor de parâmetro não é exibido para a equipe do ACR e é mais adequado para informações confidenciais.

--set

Valor da tarefa no formato '--set name[=value]'. Múltiplos com suporte passando --set várias vezes.

--set-secret

Valor da tarefa secreta no formato '--set-secret name[=value]'. Múltiplos com suporte passando --set-secret várias vezes.

--target

O nome do estágio de build de destino.

--update-trigger-token
Versão Prévia

O conteúdo que será passado de volta junto com a notificação de gatilho de imagem base.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az acr task show

Obtenha as propriedades de uma tarefa nomeada para um Registro de Contêiner do Azure.

az acr task show --name
                 --registry
                 [--resource-group]
                 [--with-secure-properties]

Exemplos

Obtenha as propriedades de uma tarefa, exibindo os resultados em uma tabela.

az acr task show -n MyTask -r myregistry -o table

Obtenha as propriedades de uma tarefa, incluindo propriedades seguras.

az acr task show -n MyTask -r myregistry --with-secure-properties

Parâmetros Exigidos

--name -n

O nome da tarefa.

--registry -r

O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--with-secure-properties

Indica se as propriedades seguras de uma tarefa devem ser retornadas.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az acr task show-run

Obtenha as propriedades de uma execução especificada de uma Tarefa do Registro de Contêiner do Azure.

az acr task show-run --registry
                     --run-id
                     [--resource-group]

Exemplos

Obtenha os detalhes de uma execução, exibindo os resultados em uma tabela.

az acr task show-run -r myregistry --run-id runId -o table

Parâmetros Exigidos

--registry -r

O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

--run-id

O identificador de execução exclusivo.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az acr task update

Atualize uma tarefa para um Registro de Contêiner do Azure.

az acr task update --name
                   --registry
                   [--agent-pool]
                   [--arg]
                   [--auth-mode {Default, None}]
                   [--base-image-trigger-enabled {false, true}]
                   [--base-image-trigger-type {All, Runtime}]
                   [--cmd]
                   [--commit-trigger-enabled {false, true}]
                   [--context]
                   [--cpu]
                   [--file]
                   [--git-access-token]
                   [--image]
                   [--log-template]
                   [--no-cache {false, true}]
                   [--no-push {false, true}]
                   [--platform]
                   [--pull-request-trigger-enabled {false, true}]
                   [--resource-group]
                   [--secret-arg]
                   [--set]
                   [--set-secret]
                   [--source-acr-auth-id]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

Exemplos

Atualize as atualizações de imagem base para disparar em todas as imagens dependentes de um dockerfile de vários estágios e o status de uma tarefa em um Registro de Contêiner do Azure.

az acr task update -n MyTask -r myregistry --base-image-trigger-type All --status Disabled

Atualize a plataforma para a etapa Build da tarefa para o Windows (pré-desenvolvimento do Linux).

az acr task update -n MyTask -r myregistry --platform Windows

Atualizar os gatilhos e o contexto da tarefa para um Registro de Contêiner do Azure.

az acr task update -n hello-world -r myregistry -f Dockerfile \
    --commit-trigger-enabled false --pull-request-trigger-enabled true \
    -c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder

Atualize uma tarefa para um Registro de Contêiner do Azure. (autogenerated)

az acr task update --image MyImage --name MyTask --registry myregistry \
    --context https://github.com/Azure-Samples/acr-build-helloworld-node.git

Atualize a tarefa usando a identidade gerenciada atribuída pelo sistema para autenticação com o registro de origem no Registro de Contêiner do Azure.

az acr task update -n MyTask -r myregistry --source-acr-auth-id [system]

Atualize a tarefa usando a identidade gerenciada atribuída pelo usuário para autenticação com o registro de origem no Registro de Contêiner do Azure.

az acr task update -n MyTask -r myregistry --source-acr-auth-id "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"

Parâmetros Exigidos

--name -n

O nome da tarefa.

--registry -r

O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--agent-pool
Versão Prévia

O nome do pool de agentes.

--arg

Argumento de build no formato '--arg name[=value]'. Há suporte para múltiplos passando '--arg name[=value]' várias vezes. IMPORTANTE: esse parâmetro não deve incluir senhas, tokens de acesso ou informações confidenciais de qualquer tipo. Esse valor de parâmetro ficará visível para a equipe do ACR para fins de depuração.

--auth-mode

Modo de autenticação do registro de origem.

Propriedade Valor
Valores aceitos: Default, None
--base-image-trigger-enabled

Indica se o gatilho de imagem base está habilitado.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
Valores aceitos: false, true
--base-image-trigger-type

O tipo do gatilho automático para atualizações de dependência de imagem base.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
Valores aceitos: All, Runtime
--cmd

Comandos a serem executados. Isso também dá suporte a parâmetros adicionais de execução do Docker (https://docs.docker.com/engine/reference/commandline/run/) ou até mesmo a outros comandos do Docker (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Indica se o gatilho de confirmação do controle do código-fonte está habilitado.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
Valores aceitos: false, true
--context -c

A URL completa para o repositório de código-fonte (requer sufixo '.git' para um repositório github) ou uma tarball remota (por exemplo, 'http://server/context.tar.gz') ou o repositório de um artefato OCI em um registro de contêiner do Azure (por exemplo, 'oci://myregistry.azurecr.io/myartifact:mytag'). Se '/dev/null' for especificado, o valor será definido como Nenhum e ignorado. Esse é um argumento necessário se a tarefa não for uma tarefa do sistema.

--cpu

A configuração da CPU em termos de número de núcleos necessários para a execução.

--file -f

Caminho relativo do arquivo de tarefa/docker para a pasta raiz do código-fonte. Os arquivos de tarefa devem ser sufixos com '.yaml' ou canalizados da entrada padrão usando '-'.

--git-access-token

O token de acesso usado para acessar o provedor de controle do código-fonte.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
--image -t

O nome e a marca da imagem usando o formato: '-t repositório/image:tag'. Há suporte para várias marcas passando -t várias vezes.

--log-template
Versão Prévia

O repositório e o modelo de marca para executar o artefato de log usando o formato: 'log/reppo:tag' (por exemplo, 'acr/logs:{.Run.ID}}'). Aplicável somente ao registro habilitado para CMK.

--no-cache

Indica se o cache de imagens está habilitado.

Propriedade Valor
Valores aceitos: false, true
--no-push

Indica se a imagem criada deve ser enviada por push para o Registro.

Propriedade Valor
Valores aceitos: false, true
--platform

A plataforma em que o build/tarefa é executado, por exemplo, "windows" e "linux". Quando é usado em comandos de build, ele também pode ser especificado no formato 'os/arch/variant' para a imagem resultante. Por exemplo, linux/arm/v7. As partes 'arch' e 'variant' são opcionais.

--pull-request-trigger-enabled

Indica se o gatilho de solicitação de pull do controle do código-fonte está habilitado. O gatilho é desabilitado por padrão.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
Valores aceitos: false, true
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--secret-arg

Argumento de build secreto no formato '--secret-arg name[=value]'. Há suporte para múltiplos passando '--secret-arg name[=value]' várias vezes. Esse valor de parâmetro não é exibido para a equipe do ACR e é mais adequado para informações confidenciais.

--set

Valor da tarefa no formato '--set name[=value]'. Múltiplos com suporte passando --set várias vezes.

--set-secret

Valor da tarefa secreta no formato '--set-secret name[=value]'. Múltiplos com suporte passando --set-secret várias vezes.

--source-acr-auth-id

Atribua a identidade gerenciada usada para logon do registro de origem. Use '[system]' para se referir à identidade atribuída pelo sistema ou a uma ID de recurso para se referir a uma identidade gerenciada atribuída pelo usuário.

--status

O status atual da tarefa.

Propriedade Valor
Valores aceitos: Disabled, Enabled
--target

O nome do estágio de build de destino.

--timeout

O tempo limite em segundos.

--update-trigger-endpoint
Versão Prévia

A URL completa do ponto de extremidade para receber notificações de gatilho de atualização de imagem base.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
--update-trigger-payload-type
Versão Prévia

Indica se os metadados devem ser incluídos sobre o gatilho de imagem base no conteúdo junto com o token de gatilho de atualização, quando uma notificação é enviada.

Propriedade Valor
Grupo de parâmetros: Trigger Arguments
Valores aceitos: Default, Token
--values

O caminho do arquivo de valores/parâmetros da tarefa em relação ao contexto de origem.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False

az acr task update-run

Corrija as propriedades de execução de uma Tarefa do Registro de Contêiner do Azure.

az acr task update-run --registry
                       --run-id
                       [--no-archive {false, true}]
                       [--resource-group]

Exemplos

Atualize uma execução existente a ser arquivada.

az acr task update-run -r myregistry --run-id runId --no-archive false

Parâmetros Exigidos

--registry -r

O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

--run-id

O identificador de execução exclusivo.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-archive

Indica se a execução deve ser arquivada.

Propriedade Valor
Valores aceitos: false, true
--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade Valor
Valor padrão: False