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	Estado
az acr task cancel-run	Cancele uma execução especificada de um Registro de Contêiner do Azure.	Principal	GA
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.	Principal	GA
az acr task credential	Gerencie credenciais para uma tarefa. Para obter mais informações, veja https://aka.ms/acr/tasks/cross-registry-authentication.	Principal	GA
az acr task credential add	Adicione uma credencial de login do Registro personalizada à tarefa.	Principal	GA
az acr task credential list	Liste todas as credenciais de registro personalizadas para a tarefa.	Principal	GA
az acr task credential remove	Remova a credencial de uma tarefa.	Principal	GA
az acr task credential update	Atualize a credencial de login do Registro para uma tarefa.	Principal	GA
az acr task delete	Exclua uma tarefa de um Registro de Contêiner do Azure.	Principal	GA
az acr task identity	Identidades gerenciadas para tarefas. Para obter mais informações, veja https://aka.ms/acr/tasks/task-create-managed-identity.	Principal	GA
az acr task identity assign	Atualize a identidade gerenciada para uma tarefa.	Principal	GA
az acr task identity remove	Remova identidades gerenciadas para uma tarefa.	Principal	GA
az acr task identity show	Exiba as identidades gerenciadas para a tarefa.	Principal	GA
az acr task list	Liste as tarefas para um Registro de Contêiner do Azure.	Principal	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.	Principal	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.	Principal	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.	Principal	GA
az acr task show	Obtenha as propriedades de uma tarefa nomeada para um Registro de Contêiner do Azure.	Principal	GA
az acr task show-run	Obtenha as propriedades de uma execução especificada de uma Tarefa de Registro de Contêiner do Azure.	Principal	GA
az acr task timer	Gerencie gatilhos de timer para uma tarefa.	Principal	GA
az acr task timer add	Adicione um gatilho de temporizador a uma tarefa.	Principal	GA
az acr task timer list	Liste todos os gatilhos de temporizador para uma tarefa.	Principal	GA
az acr task timer remove	Remova um gatilho de temporizador de uma tarefa.	Principal	GA
az acr task timer update	Atualize o gatilho do temporizador para uma tarefa.	Principal	GA
az acr task update	Atualizar uma tarefa para um Registro de Contêiner do Azure.	Principal	GA
az acr task update-run	Corrija as propriedades de execução de uma Tarefa de Registro de Contêiner do Azure.	Principal	GA

az acr task cancel-run

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

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

Exemplos

Cancelar uma execução

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

Parâmetros 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

--resource-group -g

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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.

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 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 Linux de várias etapas a partir de um repositório GitHub público 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 de 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 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

--agent-pool

Pré-visualizar

O nome do pool de agentes.

--arg

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

--assign-identity

Atribui 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. Para obter mais informações, veja https://aka.ms/acr/tasks/task-create-managed-identity.

--auth-mode

Modo de autenticação do registro de origem.

valores aceites: Default, None

--base-image-trigger-enabled

Indica se o gatilho de imagem base está habilitado.

valores aceites: false, true

valor predefinido: True

--base-image-trigger-name

O nome do gatilho da imagem base.

valor predefinido: defaultBaseimageTriggerName

--base-image-trigger-type

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

valores aceites: All, Runtime

valor predefinido: Runtime

--cmd

Comandos a executar. Isso também suporta parâmetros de execução adicionais 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.

valores aceites: false, true

valor predefinido: 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.

valor predefinido: 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.

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

valor predefinido: 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.

valores aceites: false, true

valor predefinido: False

--no-push

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

valores aceites: false, true

valor predefinido: False

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

valores aceites: false, true

valor predefinido: False

--resource-group -g

o 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 o formato. Múltiplos suportados pela passagem --schedule várias vezes.

--secret-arg

Argumento de construçã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 de --set-secret várias vezes.

--source-trigger-name

O nome do gatilho de origem.

valor predefinido: defaultSourceTriggerName

--status

O status atual da tarefa.

valores aceites: Disabled, Enabled

valor predefinido: Enabled

--target

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

--timeout

O tempo limite em segundos.

valor predefinido: 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.

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

valores aceites: Default, Token

valor predefinido: Default

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az acr task delete

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

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

Exemplos

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

az acr task delete -n MyTask -r myregistry

Parâmetros 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

--resource-group -g

o 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 predefinido: False

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az acr task list

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

--resource-group -g

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az acr task list-runs

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

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

Exemplos

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

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

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

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

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

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

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

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

o 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 aceites: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout

--top

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

valor predefinido: 15

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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.

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

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

valor predefinido: False

--resource-group -g

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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.

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

--agent-pool

Pré-visualizar

O nome do pool de agentes.

--arg

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

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

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

valor predefinido: False

--no-logs

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

valor predefinido: False

--no-wait

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

valor predefinido: False

--resource-group -g

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

--secret-arg

Argumento de construçã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 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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az acr task show

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

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

Exemplos

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

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

Obtenha as propriedades de uma tarefa, incluindo propriedades seguras.

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

Parâmetros 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

--resource-group -g

o 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 predefinido: False

Parâmetros de Globais

--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az acr task show-run

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

--resource-group -g

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az acr task update

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]
                   [--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. (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 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

--agent-pool

Pré-visualizar

O nome do pool de agentes.

--arg

Construa 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 aceites: Default, None

--base-image-trigger-enabled

Indica se o gatilho de imagem base está habilitado.

valores aceites: false, true

--base-image-trigger-type

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

valores aceites: All, Runtime

--cmd

Comandos a executar. Isso também suporta parâmetros de execução adicionais 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.

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.

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

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

valores aceites: false, true

--no-push

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

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.

valores aceites: false, true

--resource-group -g

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

--secret-arg

Argumento de construçã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 de --set-secret várias vezes.

--status

O status atual da tarefa.

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.

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

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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az acr task update-run

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

--no-archive

Indica se a execução deve ser arquivada.

valores aceites: false, true

--resource-group -g

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc

valor predefinido: json

--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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