az acr task

Referência

Gerencie uma coleção de etapas para criar, testar e corrigir imagens de contêiner do sistema operacional e da estrutura 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.	Núcleo	GA
az acr task create	Crie uma série de etapas para criar, testar e corrigir contêineres de sistema operacional e estrutura. As tarefas dão suporte a gatilhos de confirmações do Git e atualizações de imagem base.	Núcleo	GA
az acr task credential	Gerenciar credenciais para uma tarefa. Consulte https://aka.ms/acr/tasks/cross-registry-authentication para obter mais informações.	Núcleo	GA
az acr task credential add	Adicione uma credencial de logon do Registro personalizada à tarefa.	Núcleo	GA
az acr task credential list	Liste todas as credenciais de registro personalizadas para a tarefa.	Núcleo	GA
az acr task credential remove	Remover credencial de uma tarefa.	Núcleo	GA
az acr task credential update	Atualize a credencial de logon do Registro para uma tarefa.	Núcleo	GA
az acr task delete	Exclua uma tarefa de um Registro de Contêiner do Azure.	Núcleo	GA
az acr task identity	Identidades gerenciadas para tarefa. Consulte https://aka.ms/acr/tasks/task-create-managed-identity para obter mais informações.	Núcleo	GA
az acr task identity assign	Atualize a identidade gerenciada de uma tarefa.	Núcleo	GA
az acr task identity remove	Remova identidades gerenciadas de uma tarefa.	Núcleo	GA
az acr task identity show	Exiba as identidades gerenciadas para a tarefa.	Núcleo	GA
az acr task list	Liste as tarefas de um Registro de Contêiner do Azure.	Núcleo	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.	Núcleo	GA
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.	Núcleo	GA
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.	Núcleo	GA
az acr task show	Obtenha as propriedades de uma tarefa nomeada para um Registro de Contêiner do Azure.	Núcleo	GA
az acr task show-run	Obtenha as propriedades de uma execução especificada de uma Tarefa do Registro de Contêiner do Azure.	Núcleo	GA
az acr task timer	Gerencie gatilhos de temporizador para uma tarefa.	Núcleo	GA
az acr task timer add	Adicione um gatilho de temporizador a uma tarefa.	Núcleo	GA
az acr task timer list	Liste todos os gatilhos de temporizador de uma tarefa.	Núcleo	GA
az acr task timer remove	Remova um gatilho de temporizador de uma tarefa.	Núcleo	GA
az acr task timer update	Atualize o gatilho do temporizador para uma tarefa.	Núcleo	GA
az acr task update	Atualize uma tarefa para um Registro de Contêiner do Azure.	Núcleo	GA
az acr task update-run	Corrija as propriedades de execução de uma Tarefa do Registro de Contêiner do Azure.	Núcleo	GA

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 Exigidos

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

--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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az acr task create

Editar

Crie uma série de etapas para criar, testar e corrigir contêineres de sistema operacional e estrutura. 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-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 no início 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 do Linux a partir de um repositório público do GitHub que cria a imagem hello-world sem gatilhos e usa um argumento de compilação.

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 cria a imagem hello-world com um gatilho de confirmação git e pull request habilitados. 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 de um repositório GitHub público que cria a imagem do Construtor de Contêiner 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 a partir de um repositório público do GitHub com identidades gerenciadas atribuídas pelo sistema e 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>"

Parâmetros Exigidos

--name -n

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

--agent-pool

Versão Prévia

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 ficará visível para a equipe do ACR para fins de depuração.

--assign-identity

Atribui identidades gerenciadas à tarefa. Use '[system]' para se referir à identidade atribuída pelo sistema ou 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.

Valores aceitos: Default, None

--base-image-trigger-enabled

Indica se o gatilho da imagem base está habilitado.

Valores aceitos: false, true

Valor padrão: True

--base-image-trigger-name

O nome do gatilho da imagem base.

Valor padrão: defaultBaseimageTriggerName

--base-image-trigger-type

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

Valores aceitos: All, Runtime

Valor padrão: Runtime

--cmd

Comandos a serem executados. Isso também suporta parâmetros de execução docker adicionais (https://docs.docker.com/engine/reference/commandline/run/) ou até mesmo outros comandos 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.

Valores aceitos: false, true

Valor padrão: True

--context -c

O URL completo para o repositório de código-fonte (requer o 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 do 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 obrigató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.

Valor padrão: 2

--file -f

Caminho relativo do arquivo task/docker para a pasta raiz do código-fonte. Os arquivos de tarefa 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.

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

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.

Valor padrão: False

--log-template

Versão Prévia

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 somente ao registro habilitado para CMK.

--no-cache

Indica se o cache de imagem está habilitado.

Valores aceitos: false, true

Valor padrão: False

--no-push

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

Valores aceitos: false, true

Valor padrão: False

--platform

A plataforma onde a compilação/tarefa é executada, por exemplo, 'windows' e 'linux'. Quando é usado em comandos de compilação, 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 de pull de controle do código-fonte está habilitado. O gatilho está desabilitado por padrão.

Valores aceitos: false, true

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>.

--schedule

Agenda para um gatilho de temporizador representado como uma expressão cron. Um nome de gatilho opcional pode ser especificado usando o --schedule name:schedule formato. Múltiplos suportados pela passagem --schedule várias vezes.

--secret-arg

Argumento de construção secreta 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 do ACR e é mais adequado para informações confidenciais.

--set

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

--set-secret

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

--source-trigger-name

O nome do gatilho de origem.

Valor padrão: defaultSourceTriggerName

--status

O status atual da tarefa.

Valores aceitos: Disabled, Enabled

Valor padrão: Enabled

--target

O nome do estágio de build de destino.

--timeout

O tempo limite em segundos.

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.

--update-trigger-payload-type

Versão Prévia

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

Valores aceitos: Default, Token

Valor padrão: Default

--values

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

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

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 Exigidos

--name -n

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

--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.

Valor padrão: False

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az acr task list

Editar

Liste as tarefas de 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 Exigidos

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

--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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

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

Liste execuções para uma tarefa e mostre os resultados em uma tabela.

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

Liste as últimas 10 execuções bem-sucedidas de 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 Exigidos

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

--image -t

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

--name -n

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.

Valores aceitos: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout

--top

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

Valor padrão: 15

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

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

Mostre 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. 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

--image -t

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

--name -n

Nome da tarefa.

--no-format

Indica se os logs devem ser exibidos no formato bruto.

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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

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

Dispare 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

Dispare 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

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

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

Parâmetros Exigidos

--name -n

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

--agent-pool

Versão Prévia

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 tarefa devem ser sufixados com '.yaml' ou canalizados da entrada padrão usando '-'.

--log-template

Versão Prévia

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 somente ao registro habilitado para CMK.

--no-format

Indica se os logs devem ser exibidos no formato bruto.

Valor padrão: False

--no-logs

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

Valor padrão: False

--no-wait

Não aguarde a conclusão da execução e retorne imediatamente após enfileirar a execução.

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

--set

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

--set-secret

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

--target

O nome do estágio de build de destino.

--update-trigger-token

Versão Prévia

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

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

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 Exigidos

--name -n

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

--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.

Valor padrão: False

Parâmetros Globais

--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az acr task show-run

Editar

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. 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

--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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az acr task update

Editar

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]
                   [--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 de construção de sua tarefa para Windows (anterior 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

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

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

Parâmetros Exigidos

--name -n

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

--agent-pool

Versão Prévia

O nome do pool de agentes.

--arg

--auth-mode

Modo de autenticação do registro de origem.

Valores aceitos: Default, None

--base-image-trigger-enabled

Indica se o gatilho da imagem base está habilitado.

Valores aceitos: false, true

--base-image-trigger-type

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

Valores aceitos: All, Runtime

--cmd

--commit-trigger-enabled

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

Valores aceitos: 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 tarefa 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.

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

Versão Prévia

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 somente ao registro habilitado para CMK.

--no-cache

Indica se o cache de imagem está habilitado.

Valores aceitos: false, true

--no-push

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

Valores aceitos: false, true

--platform

--pull-request-trigger-enabled

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

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

--set

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

--set-secret

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

--status

O status atual da tarefa.

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.

--update-trigger-payload-type

Versão Prévia

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

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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az acr task update-run

Editar

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 para 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. 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

--no-archive

Indica se a execução deve ser arquivada.

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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

Compartilhar via

az acr task

Comandos

az acr task cancel-run

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr task create

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr task delete

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr task list

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr task list-runs

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr task logs

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr task run

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr task show

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr task show-run

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr task update

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr task update-run

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

Recursos adicionais