az acr task

Referência

Gerencie uma coleção de etapas para criar, testar e aplicar patches no sistema operacional e aplicar patches em 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.	Núcleo	GA
az acr task create	Crie uma série de etapas para criar, testar e aplicar patches no sistema operacional e no Framework de contêineres. As tarefas suportam 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 do 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	Remover identidades gerenciadas de uma tarefa.	Núcleo	GA
az acr task identity show	Exibir 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	Listar 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	Gerenciar gatilhos de timer para uma tarefa.	Núcleo	GA
az acr task timer add	Adicionar um gatilho de timer a uma tarefa.	Núcleo	GA
az acr task timer list	Listar todos os gatilhos de timer para uma tarefa.	Núcleo	GA
az acr task timer remove	Remova um gatilho de timer de uma tarefa.	Núcleo	GA
az acr task timer update	Atualize o gatilho de timer 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>o .

--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 aplicar patches no sistema operacional e no Framework de contêineres. As tarefas suportam 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 timer que execute 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 público do GitHub, que cria 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 do 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 do Linux a partir de um repositório público do GitHub, que cria a imagem hello-world com um gatilho de confirmação e solicitação pull do git 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 ele.

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 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 GitHub público com identidades gerenciadas atribuídas pelo sistema e pelo usuário e gatilhos de imagem base, git commit, pull request e timer que executam a tarefa ao meio-dia de segunda a sexta-feira com o nome do gatilho do timer 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>o .

Parâmetros Opcionais

--agent-pool

Versão Prévia

O nome do pool de agentes.

--arg

Crie o argumento no formato '--arg name[=value]'. Múltiplos suportados passando '--arg' várias vezes.

--assign-identity

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

valores aceitos: Default, None

--base-image-trigger-enabled

Indica se o gatilho de imagem base está habilitado.

valores aceitos: false, true

valor padrão: True

--base-image-trigger-name

O nome do gatilho de 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 oferece suporte a parâmetros de execução do docker adicionais (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.

valores aceitos: false, true

valor padrão: True

--context -c

A URL completa para o repositório de código-fonte (Requer o sufixo '.git' para um repositório do 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. 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.

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 ele é usado em comandos de compilação, ele também pode ser especificado no formato 'os/arch/variant' para a imagem resultante. Por exemplo, linux/arm/v7. As peças 'arco' e 'variante' são opcionais.

--pull-request-trigger-enabled

Indica se o gatilho de solicitação pull do controle de origem 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

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

--secret-arg

Argumento de compilação secreto no formato '--secret-arg name[=value]'. Múltiplos suportados pela passagem --secret-arg várias vezes.

--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 --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 compilação 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 devem ser incluídos metadados sobre o gatilho de imagem base 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>o .

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

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. Deve ser especificado em minúsculas. Você pode configurar o nome do Registro padrão usando az configure --defaults acr=<registry name>o .

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

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

Parâmetros Opcionais

--image -t

O nome da imagem. Pode incluir uma tag no formato 'name:tag' ou resumo 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 da ú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 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>o .

Parâmetros Opcionais

--image -t

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

--name -n

Nome da tarefa.

--no-format

Indica se os logs devem ser exibidos em 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

Disparar 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

Dispare uma tarefa executada adicionando ou substituindo os argumentos de compilação 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>o .

Parâmetros Opcionais

--agent-pool

Versão Prévia

O nome do pool de agentes.

--arg

Crie o argumento no formato '--arg name[=value]'. Múltiplos suportados passando '--arg' várias vezes.

--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 em 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 espere que a execução seja concluída e retorne imediatamente após a fila da corrida.

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 compilação secreto no formato '--secret-arg name[=value]'. Múltiplos suportados pela passagem --secret-arg várias vezes.

--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 --set-secret várias vezes.

--target

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

--update-trigger-token

Versão Prévia

A carga útil que será passada de volta junto com a notificação de gatilho de 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

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

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

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

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

Parâmetros Opcionais

--agent-pool

Versão Prévia

O nome do pool de agentes.

--arg

Crie o argumento no formato '--arg name[=value]'. Múltiplos suportados passando '--arg' várias vezes.

--auth-mode

Modo de autenticação do registro de origem.

valores aceitos: Default, None

--base-image-trigger-enabled

Indica se o gatilho de 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 pull do controle de origem 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

Argumento de compilação secreto no formato '--secret-arg name[=value]'. Múltiplos suportados pela passagem --secret-arg várias vezes.

--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 --set-secret várias vezes.

--status

O status atual da tarefa.

valores aceitos: Disabled, Enabled

--target

O nome do estágio de compilação 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 devem ser incluídos metadados sobre o gatilho de imagem base 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>o .

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

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

Comentários

Recursos adicionais