az acr task

Gerencie uma coleção de etapas para criar, testar e corrigir imagens de contêiner do OS & Framework usando os Registros de Contêiner do Azure.

Comandos

Name	Description	Tipo	Status
az acr task cancel-run	Cancele uma execução especificada de um Registro de Contêiner do Azure.	Core	disponibilidade geral
az acr task create	Crie uma série de etapas para criar, testar e corrigir contêineres do OS & Framework. As tarefas suportam gatilhos de confirmações git e atualizações de imagem base.	Core	disponibilidade geral
az acr task credential	Gerencie credenciais para uma tarefa. Consulte https://aka.ms/acr/tasks/cross-registry-authentication para obter mais informações.	Core	disponibilidade geral
az acr task credential add	Adicione uma credencial de login do Registro personalizada à tarefa.	Core	disponibilidade geral
az acr task credential list	Liste todas as credenciais de registro personalizadas para a tarefa.	Core	disponibilidade geral
az acr task credential remove	Remova a credencial de uma tarefa.	Core	disponibilidade geral
az acr task credential update	Atualize a credencial de login do Registro para uma tarefa.	Core	disponibilidade geral
az acr task delete	Exclua uma tarefa de um Registro de Contêiner do Azure.	Core	disponibilidade geral
az acr task identity	Identidades gerenciadas para tarefas. Consulte https://aka.ms/acr/tasks/task-create-managed-identity para obter mais informações.	Core	disponibilidade geral
az acr task identity assign	Atualize a identidade gerenciada para uma tarefa.	Core	disponibilidade geral
az acr task identity remove	Remova identidades gerenciadas para uma tarefa.	Core	disponibilidade geral
az acr task identity show	Exiba as identidades gerenciadas para a tarefa.	Core	disponibilidade geral
az acr task list	Liste as tarefas para um Registro de Contêiner do Azure.	Core	disponibilidade geral
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	disponibilidade geral
az acr task logs	Mostrar logs para uma execução específica. Se nenhum run-id for fornecido, mostre os logs da última execução criada.	Core	disponibilidade geral
az acr task run	Acione manualmente uma tarefa que, de outra forma, poderia estar aguardando confirmações do git ou gatilhos de atualização de imagem base.	Core	disponibilidade geral
az acr task show	Obtenha as propriedades de uma tarefa nomeada para um Registro de Contêiner do Azure.	Core	disponibilidade geral
az acr task show-run	Obtenha as propriedades de uma execução especificada de uma Tarefa de Registro de Contêiner do Azure.	Core	disponibilidade geral
az acr task timer	Gerencie gatilhos de timer para uma tarefa.	Core	disponibilidade geral
az acr task timer add	Adicione um gatilho de temporizador a uma tarefa.	Core	disponibilidade geral
az acr task timer list	Liste todos os gatilhos de temporizador para uma tarefa.	Core	disponibilidade geral
az acr task timer remove	Remova um gatilho de temporizador de uma tarefa.	Core	disponibilidade geral
az acr task timer update	Atualize o gatilho do temporizador para uma tarefa.	Core	disponibilidade geral
az acr task update	Atualizar uma tarefa para um Registro de Contêiner do Azure.	Core	disponibilidade geral
az acr task update-run	Corrija as propriedades de execução de uma Tarefa de Registro de Contêiner do Azure.	Core	disponibilidade geral

az acr task cancel-run

Editar

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 Obrigatórios

--registry -r

O nome do registro de contêiner. Deve ser especificado em 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 tornar-se necessários para que o comando seja executado com êxito.

--resource-group -g

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

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Default value:	False

az acr task create

Editar

Crie uma série de etapas para criar, testar e corrigir contêineres do OS & Framework. As tarefas suportam gatilhos de confirmações 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 de 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 GitHub público que constrói a imagem hello-world sem gatilhos e usa um argumento 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 Linux usando uma ramificação específica de um repositório privado do Azure DevOps que cria a imagem hello-world na arquitetura 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 Linux a partir de um repositório GitHub público que constrói a imagem hello-world com um gatilho git commit e pull request ativado. 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 GitHub público que cria a imagem do Azure Container Builder 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 a partir de um repositório público do GitHub com identidades gerenciadas atribuídas pelo sistema e pelo usuário e imagem base, git commit, pull request 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 ao 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 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 Obrigatórios

--name -n

O nome da tarefa.

--registry -r

O nome do registro de contêiner. Deve ser especificado em 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 tornar-se necessários para que o comando seja executado com êxito.

--agent-pool

Pré-visualizar

O nome do pool de agentes.

--arg

Construa o argumento no formato '--arg name[=value]'. Os múltiplos são suportados passando '--arg name[=value]' várias vezes. IMPORTANTE: Este parâmetro não deve incluir senhas, tokens de acesso ou informações confidenciais de qualquer tipo. Esse valor de parâmetro será visível para a equipe ACR para fins de depuração.

--assign-identity

Atribua identidades gerenciadas à tarefa. Use '[sistema]' para se referir à identidade atribuída ao sistema ou a um 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 aceites:	Default, None

--base-image-trigger-enabled

Indica se o gatilho de imagem base está habilitado.

Propriedade	Valor
Grupo de parâmetros:	Trigger Arguments
Default value:	True
Valores aceites:	false, true

--base-image-trigger-name

O nome do gatilho da imagem base.

Propriedade	Valor
Grupo de parâmetros:	Trigger Arguments
Default value:	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
Default value:	Runtime
Valores aceites:	All, Runtime

--cmd

Comandos a executar. Isso também suporta parâmetros adicionais de execução do docker (https://docs.docker.com/engine/reference/commandline/run/) ou até mesmo 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
Default value:	True
Valores aceites:	false, true

--context -c

A URL completa para o repositório de código-fonte (requer sufixo '.git' para um repositório github) ou um tarball remoto (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. Este é 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
Default value:	2

--file -f

Caminho relativo do arquivo task/docker para a pasta raiz do código-fonte. Os arquivos de tarefas devem ser sufixados 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 tag da imagem usando o formato: '-t repo/image:tag'. Várias tags são suportadas passando -t várias vezes.

--is-system-task

Pré-visualizar

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

Propriedade	Valor
Default value:	False

--log-template

Pré-visualizar

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

--no-cache

Indica se o cache de imagem está habilitado.

Propriedade	Valor
Default value:	False
Valores aceites:	false, true

--no-push

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

Propriedade	Valor
Default value:	False
Valores aceites:	false, true

--platform

A plataforma onde build/task é executado, por exemplo, 'windows' e 'linux'. Quando é usado em comandos build, também pode ser especificado no formato 'os/arch/variant' para a imagem resultante. Por exemplo, linux/arm/v7. As partes «arco» e «variante» são opcionais.

--pull-request-trigger-enabled

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

Propriedade	Valor
Grupo de parâmetros:	Trigger Arguments
Default value:	False
Valores aceites:	false, true

--resource-group -g

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

--schedule

Agendamento para 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 suportados pela passagem --schedule várias vezes.

Propriedade	Valor
Grupo de parâmetros:	Trigger Arguments

--secret-arg

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

--set

Valor da tarefa no formato '--set name[=value]'. Múltiplos suportados pela passagem --set várias vezes.

--set-secret

Valor da tarefa secreta no formato '--set-secret name[=value]'. Múltiplos suportados pela passagem de --set-secret várias vezes.

--source-acr-auth-id

Atribua a identidade gerenciada usada para o login do registro de origem. Use '[sistema]' para se referir à identidade atribuída ao sistema ou a um 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
Default value:	defaultSourceTriggerName

--status

O status atual da tarefa.

Propriedade	Valor
Default value:	Enabled
Valores aceites:	Disabled, Enabled

--target

O nome do estágio de construção de destino.

--timeout

O tempo limite em segundos.

Propriedade	Valor
Default value:	3600

--update-trigger-endpoint

Pré-visualizar

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

Propriedade	Valor
Grupo de parâmetros:	Trigger Arguments

--update-trigger-payload-type

Pré-visualizar

Indica se os metadados sobre o gatilho de imagem base devem ser incluídos na carga pública, juntamente com o token de gatilho de atualização, quando uma notificação é enviada.

Propriedade	Valor
Grupo de parâmetros:	Trigger Arguments
Default value:	Default
Valores aceites:	Default, Token

--values

O caminho do arquivo de valores/parâmetros da tarefa relativo ao contexto de origem.

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Default value:	False

az acr task delete

Editar

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 Obrigatórios

--name -n

O nome da tarefa.

--registry -r

O nome do registro de contêiner. Deve ser especificado em 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 tornar-se necessários para que o comando seja executado com êxito.

--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
Default value:	False

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Default value:	False

az acr task list

Editar

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

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

Exemplos

Liste tarefas e mostre os resultados em uma tabela.

az acr task list -r myregistry -o table

Parâmetros Obrigatórios

--registry -r

O nome do registro de contêiner. Deve ser especificado em 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 tornar-se necessários para que o comando seja executado com êxito.

--resource-group -g

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

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Default value:	False

az acr task list-runs

Editar

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

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

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

Parâmetros Obrigatórios

--registry -r

O nome do registro de contêiner. Deve ser especificado em 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 tornar-se necessários para que o comando seja executado com êxito.

--image -t

O nome da imagem. Pode incluir uma etiqueta no formato 'name:tag' ou resumir 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 aceites:	Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout

--top

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

Propriedade	Valor
Default value:	15

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Default value:	False

az acr task logs

Editar

Mostrar logs para uma execução específica. Se nenhum run-id for fornecido, mostre os logs da ú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, filtrados 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 construiu a imagem 'hello-world'.

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

Parâmetros Obrigatórios

--registry -r

O nome do registro de contêiner. Deve ser especificado em 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 tornar-se necessários para que o comando seja executado com êxito.

--image -t

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

--name -n

O nome da tarefa.

--no-format

Indica se os logs devem ser exibidos em formato bruto.

Propriedade	Valor
Default value:	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 de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Default value:	False

az acr task run

Editar

Acione 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

Acionar uma execução de tarefa.

az acr task run -n MyTask -r myregistry

Acione uma tarefa executada substituindo o contexto e o arquivo passados durante a criação da tarefa 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

Acione uma tarefa executada substituindo o contexto e o arquivo passados durante a criação da tarefa por um contexto local.

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

Acione uma tarefa executada adicionando ou substituindo argumentos de compilação 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 Obrigatórios

--name -n

O nome da tarefa.

--registry -r

O nome do registro de contêiner. Deve ser especificado em 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 tornar-se necessários para que o comando seja executado com êxito.

--agent-pool

Pré-visualizar

O nome do pool de agentes.

--arg

--context -c

--file -f

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

--log-template

Pré-visualizar

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

--no-format

Indica se os logs devem ser exibidos em formato bruto.

Propriedade	Valor
Default value:	False

--no-logs

Não mostre logs depois de enfileirar com êxito a compilação.

Propriedade	Valor
Default value:	False

--no-wait

Não espere que a execução seja concluída e retorne imediatamente após a enfileiramento da corrida.

Propriedade	Valor
Default value:	False

--resource-group -g

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

--secret-arg

--set

Valor da tarefa no formato '--set name[=value]'. Múltiplos suportados pela passagem --set várias vezes.

--set-secret

Valor da tarefa secreta no formato '--set-secret name[=value]'. Múltiplos suportados pela passagem de --set-secret várias vezes.

--target

O nome do estágio de construção de destino.

--update-trigger-token

Pré-visualizar

A carga útil que será passada de volta junto com a notificação de gatilho de imagem base.

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Default value:	False

az acr task show

Editar

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 Obrigatórios

--name -n

O nome da tarefa.

--registry -r

O nome do registro de contêiner. Deve ser especificado em 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 tornar-se necessários para que o comando seja executado com êxito.

--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
Default value:	False

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Default value:	False

az acr task show-run

Editar

Obtenha as propriedades de uma execução especificada de uma Tarefa de 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 Obrigatórios

--registry -r

O nome do registro de contêiner. Deve ser especificado em 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 tornar-se necessários para que o comando seja executado com êxito.

--resource-group -g

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

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Default value:	False

az acr task update

Editar

Atualizar 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 acionar 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

Plataforma de atualização para a etapa de compilação da sua tarefa para Windows (prev Linux).

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

Atualize 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

Atualizar 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 Obrigatórios

--name -n

O nome da tarefa.

--registry -r

O nome do registro de contêiner. Deve ser especificado em 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 tornar-se necessários para que o comando seja executado com êxito.

--agent-pool

Pré-visualizar

O nome do pool de agentes.

--arg

--auth-mode

Modo de autenticação do registro de origem.

Propriedade	Valor
Valores aceites:	Default, None

--base-image-trigger-enabled

Indica se o gatilho de imagem base está habilitado.

Propriedade	Valor
Grupo de parâmetros:	Trigger Arguments
Valores aceites:	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 aceites:	All, Runtime

--cmd

--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 aceites:	false, true

--context -c

--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 task/docker para a pasta raiz do código-fonte. Os arquivos de tarefas devem ser sufixados 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 tag da imagem usando o formato: '-t repo/image:tag'. Várias tags são suportadas passando -t várias vezes.

--log-template

Pré-visualizar

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

--no-cache

Indica se o cache de imagem está habilitado.

Propriedade	Valor
Valores aceites:	false, true

--no-push

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

Propriedade	Valor
Valores aceites:	false, true

--platform

--pull-request-trigger-enabled

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

Propriedade	Valor
Grupo de parâmetros:	Trigger Arguments
Valores aceites:	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

--set

Valor da tarefa no formato '--set name[=value]'. Múltiplos suportados pela passagem --set várias vezes.

--set-secret

Valor da tarefa secreta no formato '--set-secret name[=value]'. Múltiplos suportados pela passagem de --set-secret várias vezes.

--source-acr-auth-id

--status

O status atual da tarefa.

Propriedade	Valor
Valores aceites:	Disabled, Enabled

--target

O nome do estágio de construção de destino.

--timeout

O tempo limite em segundos.

--update-trigger-endpoint

Pré-visualizar

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

Propriedade	Valor
Grupo de parâmetros:	Trigger Arguments

--update-trigger-payload-type

Pré-visualizar

Indica se os metadados sobre o gatilho de imagem base devem ser incluídos na carga pública, juntamente com o token de gatilho de atualização, quando uma notificação é enviada.

Propriedade	Valor
Grupo de parâmetros:	Trigger Arguments
Valores aceites:	Default, Token

--values

O caminho do arquivo de valores/parâmetros da tarefa relativo ao contexto de origem.

Parâmetros de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Default value:	False

az acr task update-run

Editar

Corrija as propriedades de execução de uma Tarefa de 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 para ser arquivada.

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

Parâmetros Obrigatórios

--registry -r

O nome do registro de contêiner. Deve ser especificado em 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 tornar-se necessários para que o comando seja executado com êxito.

--no-archive

Indica se a execução deve ser arquivada.

Propriedade	Valor
Valores aceites:	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 de Globais

--debug

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

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	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 subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade	Valor
Default value:	False

Feedback

Esta página foi útil?

Partilhar via

az acr task

Comandos

az acr task cancel-run

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr task create

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr task delete

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr task list

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr task list-runs

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr task logs

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr task run

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr task show

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr task show-run

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr task update

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr task update-run

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

Feedback