az acr task
Gerencie uma coleção de etapas para a criação, teste e sistema operacional & Framework aplicação de patch de imagens de contêiner usando Os Registros de Contêiner do Azure.
Comandos
| Nome | Description | Tipo | Status |
|---|---|---|---|
| az acr task cancel-run |
Cancele uma execução especificada de um Registro de Contêiner do Azure. |
Core | GA |
| az acr task create |
Crie uma série de etapas para compilar, testar e os contêineres de aplicação de patch da Estrutura de & do sistema operacional. As tarefas dão suporte a gatilhos de confirmações do git e atualizações de imagem base. |
Core | GA |
| az acr task credential |
Gerenciar credenciais para uma tarefa. Consulte https://aka.ms/acr/tasks/cross-registry-authentication para obter mais informações. |
Core | GA |
| az acr task credential add |
Adicione uma credencial de logon do Registro personalizada à tarefa. |
Core | GA |
| az acr task credential list |
Liste todas as credenciais personalizadas do Registro para a tarefa. |
Core | GA |
| az acr task credential remove |
Remova a credencial de uma tarefa. |
Core | GA |
| az acr task credential update |
Atualize a credencial de logon do Registro para uma tarefa. |
Core | GA |
| az acr task delete |
Exclua uma tarefa de um Registro de Contêiner do Azure. |
Core | GA |
| az acr task identity |
Identidades Gerenciadas para Tarefa. Consulte https://aka.ms/acr/tasks/task-create-managed-identity para obter mais informações. |
Core | GA |
| az acr task identity assign |
Atualize a identidade gerenciada para uma tarefa. |
Core | GA |
| az acr task identity remove |
Remova identidades gerenciadas para uma tarefa. |
Core | GA |
| az acr task identity show |
Exiba as identidades gerenciadas para a tarefa. |
Core | GA |
| az acr task list |
Liste as tarefas de um Registro de Contêiner do Azure. |
Core | GA |
| az acr task list-runs |
Liste todas as execuções executadas para um Registro de Contêiner do Azure, com a capacidade de filtrar por uma Tarefa específica. |
Core | GA |
| az acr task logs |
Mostrar logs para uma execução específica. Se nenhuma ID de execução for fornecida, mostre logs para a última execução criada. |
Core | GA |
| az acr task run |
Dispare manualmente uma tarefa que, de outra forma, poderia estar aguardando confirmações do git ou gatilhos de atualização de imagem base. |
Core | GA |
| az acr task show |
Obtenha as propriedades de uma tarefa nomeada para um Registro de Contêiner do Azure. |
Core | GA |
| az acr task show-run |
Obtenha as propriedades de uma execução especificada de uma Tarefa do Registro de Contêiner do Azure. |
Core | GA |
| az acr task timer |
Gerenciar gatilhos de temporizador para uma tarefa. |
Core | GA |
| az acr task timer add |
Adicione um gatilho de temporizador a uma tarefa. |
Core | GA |
| az acr task timer list |
Listar todos os gatilhos de temporizador para uma tarefa. |
Core | GA |
| az acr task timer remove |
Remova um gatilho de temporizador de uma tarefa. |
Core | GA |
| az acr task timer update |
Atualize o gatilho do temporizador para uma tarefa. |
Core | GA |
| az acr task update |
Atualize uma tarefa para um Registro de Contêiner do Azure. |
Core | GA |
| az acr task update-run |
Corrija as propriedades de execução de uma Tarefa do Registro de Contêiner do Azure. |
Core | GA |
az acr task cancel-run
Cancele uma execução especificada de um Registro de Contêiner do Azure.
az acr task cancel-run --registry
--run-id
[--resource-group]
Exemplos
Cancelar uma execução
az acr task cancel-run -r myregistry --run-id runId
Parâmetros Exigidos
O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.
O identificador de execução exclusivo.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az acr task create
Crie uma série de etapas para compilar, testar e os contêineres de aplicação de patch da Estrutura de & do sistema operacional. As tarefas dão suporte a gatilhos de confirmações do git e atualizações de imagem base.
az acr task create --name
--registry
[--agent-pool]
[--arg]
[--assign-identity]
[--auth-mode {Default, None}]
[--base-image-trigger-enabled {false, true}]
[--base-image-trigger-name]
[--base-image-trigger-type {All, Runtime}]
[--cmd]
[--commit-trigger-enabled {false, true}]
[--context]
[--cpu]
[--file]
[--git-access-token]
[--image]
[--is-system-task]
[--log-template]
[--no-cache {false, true}]
[--no-push {false, true}]
[--platform]
[--pull-request-trigger-enabled {false, true}]
[--resource-group]
[--schedule]
[--secret-arg]
[--set]
[--set-secret]
[--source-acr-auth-id]
[--source-trigger-name]
[--status {Disabled, Enabled}]
[--target]
[--timeout]
[--update-trigger-endpoint]
[--update-trigger-payload-type {Default, Token}]
[--values]
Exemplos
Crie uma tarefa sem o local de origem.
az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null
Crie uma tarefa com a definição da entrada padrão e com um gatilho de temporizador que executa a tarefa na parte superior de cada hora usando o nome do gatilho padrão. 'Ctrl + Z'(Windows) ou 'Ctrl + D'(Linux) encerra o fluxo de entrada.
cat task.yaml | az acr task create -n hello-world -r myregistry -f - -c /dev/null \
--schedule "0 */1 * * *"
az acr task create -n hello-world -r myregistry -f - -c /dev/null --schedule "0 */1 * * *"
Crie uma tarefa linux a partir de um repositório público do GitHub que compila a imagem hello-world sem gatilhos e usa um argumento de build.
az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
-c https://github.com/Azure/acr-builder.git -f Dockerfile \
--commit-trigger-enabled false --base-image-trigger-enabled false \
--arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git
Crie uma tarefa do Linux usando um branch específico de um repositório privado do Azure DevOps que cria a imagem hello-world na arquitetura do Arm (variante V7) e tem gatilhos habilitados.
az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
-c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder \
-f Dockerfile --git-access-token <Personal Access Token> --platform linux/arm/v7
Crie uma tarefa do Linux a partir de um repositório público do GitHub que compila a imagem hello-world com um gatilho de solicitação de pull e confirmação git habilitado. Observe que essa tarefa não usa o Registro de Origem (myregistry), portanto, podemos definir explicitamente o modo de autenticação como Nenhum para ela.
az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry -f Dockerfile \
--no-push true --auth-mode None -c https://github.com/Azure-Samples/acr-build-helloworld-node.git \
--pull-request-trigger-enabled true --git-access-token 000000000000000000000000000000000
Crie uma tarefa do Windows a partir de um repositório público do GitHub que compila a imagem do Construtor de Contêineres do Azure na arquitetura Amd64 com apenas o gatilho de imagem base habilitado.
az acr task create -t acb:{{.Run.ID}} -n acb-win -r myregistry \
-c https://github.com/Azure/acr-builder.git -f Windows.Dockerfile \
--commit-trigger-enabled false --platform Windows/amd64
Crie uma tarefa de várias etapas do Linux de um repositório público do GitHub com identidades gerenciadas atribuídas pelo sistema e atribuídas pelo usuário e imagem base, confirmação do git, solicitação de pull e gatilhos de temporizador que executam a tarefa ao meio-dia de segunda a sexta-feira com o nome do gatilho do temporizador fornecido.
az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
--pull-request-trigger-enabled true --schedule "dailyTimer:0 12 * * Mon-Fri" \
-c https://github.com/Azure-Samples/acr-tasks.git#:multipleRegistries -f testtask.yaml \
--assign-identity [system] "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"
Crie uma tarefa sem o local de origem em um registro de permissão de repositório baseado em ABAC e especifique uma identidade gerenciada atribuída pelo sistema usada para autenticação com o registro de origem.
az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id [system]
Crie uma tarefa sem o local de origem em um registro de permissão de repositório baseado em ABAC e especifique uma identidade gerenciada atribuída pelo usuário usada para autenticação com o registro de origem.
az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"
Crie uma tarefa sem o local de origem em um registro de permissão de repositório baseado em ABAC com identidades gerenciadas atribuídas pelo sistema e atribuídas pelo usuário e especifique a identidade gerenciada atribuída pelo sistema usada para autenticação com o registro de origem.
az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id [system]
--assign-identity [system] "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"
Parâmetros Exigidos
O nome da tarefa.
O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
O nome do pool de agentes.
Argumento de build no formato '--arg name[=value]'. Há suporte para múltiplos passando '--arg name[=value]' várias vezes. IMPORTANTE: esse parâmetro não deve incluir senhas, tokens de acesso ou informações confidenciais de qualquer tipo. Esse valor de parâmetro ficará visível para a equipe do ACR para fins de depuração.
Atribua identidades gerenciadas à tarefa. Use '[system]' para se referir à identidade atribuída pelo sistema ou a uma ID de recurso para se referir a uma identidade atribuída pelo usuário. Consulte https://aka.ms/acr/tasks/task-create-managed-identity para obter mais informações.
Modo de autenticação do registro de origem.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | Default, None |
Indica se o gatilho de imagem base está habilitado.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
| Valor padrão: | True |
| Valores aceitos: | false, true |
O nome do gatilho de imagem base.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
| Valor padrão: | defaultBaseimageTriggerName |
O tipo do gatilho automático para atualizações de dependência de imagem base.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
| Valor padrão: | Runtime |
| Valores aceitos: | All, Runtime |
Comandos a serem executados. Isso também dá suporte a parâmetros adicionais de execução do Docker (https://docs.docker.com/engine/reference/commandline/run/) ou até mesmo a outros comandos do Docker (https://docs.docker.com/engine/reference/commandline/docker/).
Indica se o gatilho de confirmação do controle do código-fonte está habilitado.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
| Valor padrão: | True |
| Valores aceitos: | false, true |
A URL completa para o repositório de código-fonte (requer sufixo '.git' para um repositório github) ou uma tarball remota (por exemplo, 'http://server/context.tar.gz') ou o repositório de um artefato OCI em um registro de contêiner do Azure (por exemplo, 'oci://myregistry.azurecr.io/myartifact:mytag'). Se '/dev/null' for especificado, o valor será definido como Nenhum e ignorado. Esse é um argumento necessário se a tarefa não for uma tarefa do sistema.
A configuração da CPU em termos de número de núcleos necessários para a execução.
| Propriedade | Valor |
|---|---|
| Valor padrão: | 2 |
Caminho relativo do arquivo de tarefa/docker para a pasta raiz do código-fonte. Os arquivos de tarefa devem ser sufixos com '.yaml' ou canalizados da entrada padrão usando '-'.
O token de acesso usado para acessar o provedor de controle do código-fonte.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
O nome e a marca da imagem usando o formato: '-t repositório/image:tag'. Há suporte para várias marcas passando -t várias vezes.
Indica se o recurso de tarefa é uma tarefa do sistema. O nome da tarefa deve ser 'quicktask'. Aplicável somente ao registro habilitado para CMK.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
O repositório e o modelo de marca para executar o artefato de log usando o formato: 'log/reppo:tag' (por exemplo, 'acr/logs:{.Run.ID}}'). Aplicável somente ao registro habilitado para CMK.
Indica se o cache de imagens está habilitado.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
| Valores aceitos: | false, true |
Indica se a imagem criada deve ser enviada por push para o Registro.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
| Valores aceitos: | false, true |
A plataforma em que o build/tarefa é executado, por exemplo, "windows" e "linux". Quando é usado em comandos de build, ele também pode ser especificado no formato 'os/arch/variant' para a imagem resultante. Por exemplo, linux/arm/v7. As partes 'arch' e 'variant' são opcionais.
Indica se o gatilho de solicitação de pull do controle do código-fonte está habilitado. O gatilho é desabilitado por padrão.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
| Valor padrão: | False |
| Valores aceitos: | false, true |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Agendar um gatilho de temporizador representado como uma expressão cron. Um nome de gatilho opcional pode ser especificado usando --schedule name:schedule formato. Múltiplos com suporte passando --schedule várias vezes.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
Argumento de build secreto no formato '--secret-arg name[=value]'. Há suporte para múltiplos passando '--secret-arg name[=value]' várias vezes. Esse valor de parâmetro não é exibido para a equipe do ACR e é mais adequado para informações confidenciais.
Valor da tarefa no formato '--set name[=value]'. Múltiplos com suporte passando --set várias vezes.
Valor da tarefa secreta no formato '--set-secret name[=value]'. Múltiplos com suporte passando --set-secret várias vezes.
Atribua a identidade gerenciada usada para logon do registro de origem. Use '[system]' para se referir à identidade atribuída pelo sistema ou a uma ID de recurso para se referir a uma identidade gerenciada atribuída pelo usuário.
O nome do gatilho de origem.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
| Valor padrão: | defaultSourceTriggerName |
O status atual da tarefa.
| Propriedade | Valor |
|---|---|
| Valor padrão: | Enabled |
| Valores aceitos: | Disabled, Enabled |
O nome do estágio de build de destino.
O tempo limite em segundos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | 3600 |
A URL completa do ponto de extremidade para receber notificações de gatilho de atualização de imagem base.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
Indica se os metadados devem ser incluídos sobre o gatilho de imagem base no conteúdo junto com o token de gatilho de atualização, quando uma notificação é enviada.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
| Valor padrão: | Default |
| Valores aceitos: | Default, Token |
O caminho do arquivo de valores/parâmetros da tarefa em relação ao contexto de origem.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az acr task delete
Exclua uma tarefa de um Registro de Contêiner do Azure.
az acr task delete --name
--registry
[--resource-group]
[--yes]
Exemplos
Exclua uma tarefa de um Registro de Contêiner do Azure.
az acr task delete -n MyTask -r myregistry
Parâmetros Exigidos
O nome da tarefa.
O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Não solicite confirmação.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az acr task list
Liste as tarefas de um Registro de Contêiner do Azure.
az acr task list --registry
[--resource-group]
Exemplos
Listar tarefas e mostrar os resultados em uma tabela.
az acr task list -r myregistry -o table
Parâmetros Exigidos
O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az acr task list-runs
Liste todas as execuções executadas para um Registro de Contêiner do Azure, com a capacidade de filtrar por uma Tarefa específica.
az acr task list-runs --registry
[--image]
[--name]
[--resource-group]
[--run-status {Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout}]
[--top]
Exemplos
Liste todas as execuções de um registro e mostre os resultados em uma tabela.
az acr task list-runs -r myregistry -o table
A lista é executada para uma tarefa e mostra os resultados em uma tabela.
az acr task list-runs -r myregistry -n MyTask -o table
Liste as últimas 10 execuções bem-sucedidas para um registro e mostre os resultados em uma tabela.
az acr task list-runs -r myregistry --run-status Succeeded --top 10 -o table
Lista todas as execuções que criaram a imagem 'hello-world' para um registro e mostram os resultados em uma tabela.
az acr task list-runs -r myregistry --image hello-world -o table
Parâmetros Exigidos
O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
O nome da imagem. Pode incluir uma marca no formato 'name:tag' ou digest no formato 'name@digest'.
O nome da tarefa.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
O status atual da execução.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout |
Limite o número de execuções mais recentes nos resultados.
| Propriedade | Valor |
|---|---|
| Valor padrão: | 15 |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az acr task logs
Mostrar logs para uma execução específica. Se nenhuma ID de execução for fornecida, mostre logs para a última execução criada.
az acr task logs --registry
[--image]
[--name]
[--no-format]
[--resource-group]
[--run-id]
Exemplos
Mostrar logs para a última execução criada no Registro.
az acr task logs -r myregistry
Mostrar logs para a última execução criada no registro, filtrado por tarefa.
az acr task logs -r myregistry -n MyTask
Mostrar logs para uma execução específica.
az acr task logs -r myregistry --run-id runId
Mostrar logs para a última execução criada no registro que criou a imagem 'hello-world'.
az acr task logs -r myregistry --image hello-world
Parâmetros Exigidos
O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
O nome da imagem. Pode incluir uma marca no formato 'name:tag' ou digest no formato 'name@digest'.
O nome da tarefa.
Indica se os logs devem ser exibidos em formato bruto.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
O identificador de execução exclusivo.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az acr task run
Dispare manualmente uma tarefa que, de outra forma, poderia estar aguardando confirmações do git ou gatilhos de atualização de imagem base.
az acr task run --name
--registry
[--agent-pool]
[--arg]
[--context]
[--file]
[--log-template]
[--no-format]
[--no-logs]
[--no-wait]
[--resource-group]
[--secret-arg]
[--set]
[--set-secret]
[--target]
[--update-trigger-token]
Exemplos
Disparar uma execução de tarefa.
az acr task run -n MyTask -r myregistry
Dispare uma tarefa executada substituindo o contexto e o arquivo passados durante a criação de tarefas com um repositório remoto.
az acr task run -n MyTask -r myregistry -c https://github.com/Azure-Samples/acr-build-helloworld-node.git -f Dockerfile
Dispare uma tarefa executada substituindo o contexto e o arquivo passados durante a criação de tarefas com um contexto local.
az acr task run -n MyTask -r myregistry -c . -f Dockerfile
Dispare uma tarefa executada adicionando ou substituindo argumentos de build definidos durante a criação de tarefas.
az acr task run -n MyTask -r myregistry --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git
Parâmetros Exigidos
O nome da tarefa.
O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
O nome do pool de agentes.
Argumento de build no formato '--arg name[=value]'. Há suporte para múltiplos passando '--arg name[=value]' várias vezes. IMPORTANTE: esse parâmetro não deve incluir senhas, tokens de acesso ou informações confidenciais de qualquer tipo. Esse valor de parâmetro ficará visível para a equipe do ACR para fins de depuração.
A URL completa para o repositório de código-fonte (requer sufixo '.git' para um repositório github) ou uma tarball remota (por exemplo, 'http://server/context.tar.gz') ou o repositório de um artefato OCI em um registro de contêiner do Azure (por exemplo, 'oci://myregistry.azurecr.io/myartifact:mytag'). Se '/dev/null' for especificado, o valor será definido como Nenhum e ignorado. Esse é um argumento necessário se a tarefa não for uma tarefa do sistema.
Caminho relativo do arquivo de tarefa/docker para a pasta raiz do código-fonte. Os arquivos de tarefa devem ser sufixos com '.yaml' ou canalizados da entrada padrão usando '-'.
O repositório e o modelo de marca para executar o artefato de log usando o formato: 'log/reppo:tag' (por exemplo, 'acr/logs:{.Run.ID}}'). Aplicável somente ao registro habilitado para CMK.
Indica se os logs devem ser exibidos em formato bruto.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Não mostre logs depois de enfileirar o build com êxito.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Não aguarde a conclusão da execução e retorne imediatamente depois de enfileirar a execução.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Argumento de build secreto no formato '--secret-arg name[=value]'. Há suporte para múltiplos passando '--secret-arg name[=value]' várias vezes. Esse valor de parâmetro não é exibido para a equipe do ACR e é mais adequado para informações confidenciais.
Valor da tarefa no formato '--set name[=value]'. Múltiplos com suporte passando --set várias vezes.
Valor da tarefa secreta no formato '--set-secret name[=value]'. Múltiplos com suporte passando --set-secret várias vezes.
O nome do estágio de build de destino.
O conteúdo que será passado de volta junto com a notificação de gatilho de imagem base.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az acr task show
Obtenha as propriedades de uma tarefa nomeada para um Registro de Contêiner do Azure.
az acr task show --name
--registry
[--resource-group]
[--with-secure-properties]
Exemplos
Obtenha as propriedades de uma tarefa, exibindo os resultados em uma tabela.
az acr task show -n MyTask -r myregistry -o table
Obtenha as propriedades de uma tarefa, incluindo propriedades seguras.
az acr task show -n MyTask -r myregistry --with-secure-properties
Parâmetros Exigidos
O nome da tarefa.
O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Indica se as propriedades seguras de uma tarefa devem ser retornadas.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az acr task show-run
Obtenha as propriedades de uma execução especificada de uma Tarefa do Registro de Contêiner do Azure.
az acr task show-run --registry
--run-id
[--resource-group]
Exemplos
Obtenha os detalhes de uma execução, exibindo os resultados em uma tabela.
az acr task show-run -r myregistry --run-id runId -o table
Parâmetros Exigidos
O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.
O identificador de execução exclusivo.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az acr task update
Atualize uma tarefa para um Registro de Contêiner do Azure.
az acr task update --name
--registry
[--agent-pool]
[--arg]
[--auth-mode {Default, None}]
[--base-image-trigger-enabled {false, true}]
[--base-image-trigger-type {All, Runtime}]
[--cmd]
[--commit-trigger-enabled {false, true}]
[--context]
[--cpu]
[--file]
[--git-access-token]
[--image]
[--log-template]
[--no-cache {false, true}]
[--no-push {false, true}]
[--platform]
[--pull-request-trigger-enabled {false, true}]
[--resource-group]
[--secret-arg]
[--set]
[--set-secret]
[--source-acr-auth-id]
[--status {Disabled, Enabled}]
[--target]
[--timeout]
[--update-trigger-endpoint]
[--update-trigger-payload-type {Default, Token}]
[--values]
Exemplos
Atualize as atualizações de imagem base para disparar em todas as imagens dependentes de um dockerfile de vários estágios e o status de uma tarefa em um Registro de Contêiner do Azure.
az acr task update -n MyTask -r myregistry --base-image-trigger-type All --status Disabled
Atualize a plataforma para a etapa Build da tarefa para o Windows (pré-desenvolvimento do Linux).
az acr task update -n MyTask -r myregistry --platform Windows
Atualizar os gatilhos e o contexto da tarefa para um Registro de Contêiner do Azure.
az acr task update -n hello-world -r myregistry -f Dockerfile \
--commit-trigger-enabled false --pull-request-trigger-enabled true \
-c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder
Atualize uma tarefa para um Registro de Contêiner do Azure. (autogenerated)
az acr task update --image MyImage --name MyTask --registry myregistry \
--context https://github.com/Azure-Samples/acr-build-helloworld-node.git
Atualize a tarefa usando a identidade gerenciada atribuída pelo sistema para autenticação com o registro de origem no Registro de Contêiner do Azure.
az acr task update -n MyTask -r myregistry --source-acr-auth-id [system]
Atualize a tarefa usando a identidade gerenciada atribuída pelo usuário para autenticação com o registro de origem no Registro de Contêiner do Azure.
az acr task update -n MyTask -r myregistry --source-acr-auth-id "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"
Parâmetros Exigidos
O nome da tarefa.
O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
O nome do pool de agentes.
Argumento de build no formato '--arg name[=value]'. Há suporte para múltiplos passando '--arg name[=value]' várias vezes. IMPORTANTE: esse parâmetro não deve incluir senhas, tokens de acesso ou informações confidenciais de qualquer tipo. Esse valor de parâmetro ficará visível para a equipe do ACR para fins de depuração.
Modo de autenticação do registro de origem.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | Default, None |
Indica se o gatilho de imagem base está habilitado.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
| Valores aceitos: | false, true |
O tipo do gatilho automático para atualizações de dependência de imagem base.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
| Valores aceitos: | All, Runtime |
Comandos a serem executados. Isso também dá suporte a parâmetros adicionais de execução do Docker (https://docs.docker.com/engine/reference/commandline/run/) ou até mesmo a outros comandos do Docker (https://docs.docker.com/engine/reference/commandline/docker/).
Indica se o gatilho de confirmação do controle do código-fonte está habilitado.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
| Valores aceitos: | false, true |
A URL completa para o repositório de código-fonte (requer sufixo '.git' para um repositório github) ou uma tarball remota (por exemplo, 'http://server/context.tar.gz') ou o repositório de um artefato OCI em um registro de contêiner do Azure (por exemplo, 'oci://myregistry.azurecr.io/myartifact:mytag'). Se '/dev/null' for especificado, o valor será definido como Nenhum e ignorado. Esse é um argumento necessário se a tarefa não for uma tarefa do sistema.
A configuração da CPU em termos de número de núcleos necessários para a execução.
Caminho relativo do arquivo de tarefa/docker para a pasta raiz do código-fonte. Os arquivos de tarefa devem ser sufixos com '.yaml' ou canalizados da entrada padrão usando '-'.
O token de acesso usado para acessar o provedor de controle do código-fonte.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
O nome e a marca da imagem usando o formato: '-t repositório/image:tag'. Há suporte para várias marcas passando -t várias vezes.
O repositório e o modelo de marca para executar o artefato de log usando o formato: 'log/reppo:tag' (por exemplo, 'acr/logs:{.Run.ID}}'). Aplicável somente ao registro habilitado para CMK.
Indica se o cache de imagens está habilitado.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
Indica se a imagem criada deve ser enviada por push para o Registro.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
A plataforma em que o build/tarefa é executado, por exemplo, "windows" e "linux". Quando é usado em comandos de build, ele também pode ser especificado no formato 'os/arch/variant' para a imagem resultante. Por exemplo, linux/arm/v7. As partes 'arch' e 'variant' são opcionais.
Indica se o gatilho de solicitação de pull do controle do código-fonte está habilitado. O gatilho é desabilitado por padrão.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
| Valores aceitos: | false, true |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Argumento de build secreto no formato '--secret-arg name[=value]'. Há suporte para múltiplos passando '--secret-arg name[=value]' várias vezes. Esse valor de parâmetro não é exibido para a equipe do ACR e é mais adequado para informações confidenciais.
Valor da tarefa no formato '--set name[=value]'. Múltiplos com suporte passando --set várias vezes.
Valor da tarefa secreta no formato '--set-secret name[=value]'. Múltiplos com suporte passando --set-secret várias vezes.
Atribua a identidade gerenciada usada para logon do registro de origem. Use '[system]' para se referir à identidade atribuída pelo sistema ou a uma ID de recurso para se referir a uma identidade gerenciada atribuída pelo usuário.
O status atual da tarefa.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | Disabled, Enabled |
O nome do estágio de build de destino.
O tempo limite em segundos.
A URL completa do ponto de extremidade para receber notificações de gatilho de atualização de imagem base.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
Indica se os metadados devem ser incluídos sobre o gatilho de imagem base no conteúdo junto com o token de gatilho de atualização, quando uma notificação é enviada.
| Propriedade | Valor |
|---|---|
| Grupo de parâmetros: | Trigger Arguments |
| Valores aceitos: | Default, Token |
O caminho do arquivo de valores/parâmetros da tarefa em relação ao contexto de origem.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
az acr task update-run
Corrija as propriedades de execução de uma Tarefa do Registro de Contêiner do Azure.
az acr task update-run --registry
--run-id
[--no-archive {false, true}]
[--resource-group]
Exemplos
Atualize uma execução existente a ser arquivada.
az acr task update-run -r myregistry --run-id runId --no-archive false
Parâmetros Exigidos
O nome do registro de contêiner. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.
O identificador de execução exclusivo.
Parâmetros Opcionais
Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.
Indica se a execução deve ser arquivada.
| Propriedade | Valor |
|---|---|
| Valores aceitos: | false, true |
Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.
Parâmetros Globais
Aumente a verbosidade de log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Mostre esta mensagem de ajuda e saia.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Valor padrão: | json |
| Valores aceitos: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Valor padrão: | False |