Compartilhar via

az acr

Note

Esse grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Gerencie registros privados com os Registros de Contêiner do Azure.

Comandos

Nome Description Tipo Status
az acr agentpool

Gerenciar pools de agentes de tarefas privadas com Os Registros de Contêiner do Azure.

 Core Preview
az acr agentpool create

Crie um pool de agentes para um Registro de Contêiner do Azure.

 Core Preview
az acr agentpool delete

Excluir um pool de agentes.

 Core Preview
az acr agentpool list

Liste os pools de agentes para um Registro de Contêiner do Azure.

 Core Preview
az acr agentpool show

Obtenha as propriedades de um pool de agentes especificado para um Registro de Contêiner do Azure.

 Core Preview
az acr agentpool update

Atualize um pool de agentes para um Registro de Contêiner do Azure.

 Core Preview
az acr artifact-streaming

Gerenciar o streaming de artefatos para quaisquer repositórios ou imagens com suporte em um ACR.

 Core Preview
az acr artifact-streaming create

Crie um artefato de streaming de referenciadores para uma imagem específica em um ACR.

 Core Preview
az acr artifact-streaming operation

Gerencie as operações de criação de artefato de streaming para a ACR.

 Core Preview
az acr artifact-streaming operation cancel

Cancele a operação de artefato de streaming fornecida para o ACR.

 Core Preview
az acr artifact-streaming operation show

Verifique o status da operação para streaming de artefatos em um ACR.

 Core Preview
az acr artifact-streaming show

Mostrar se o streaming de artefatos está habilitado em um repositório para um Registro de Contêiner do Azure.

 Core Preview
az acr artifact-streaming update

Habilite ou desabilite a criação automática de artefatos de streaming para imagens enviadas por push recentemente em um determinado registro.

 Core Preview
az acr build

Enfileira um build rápido, fornecendo logs de streaming para um Registro de Contêiner do Azure.

 Core GA
az acr cache

Gerenciar regras de cache nos Registros de Contêiner do Azure.

 Core GA
az acr cache create

Crie uma regra de cache.

 Core GA
az acr cache delete

Exclua uma regra de cache.

 Core GA
az acr cache list

Liste as regras de cache em um Registro de Contêiner do Azure.

 Core GA
az acr cache show

Mostrar uma regra de cache.

 Core GA
az acr cache update

Atualize o conjunto de credenciais em uma regra de cache.

 Core GA
az acr check-health

Obtém informações de integridade sobre o ambiente e, opcionalmente, um registro de destino.

 Core GA
az acr check-name

Verifica se um nome do Registro de Contêiner do Azure é válido e está disponível para uso.

 Core GA
az acr config

Configurar políticas para Registros de Contêiner do Azure.

 Core GA
az acr config authentication-as-arm

Gerencie a política "Autenticação do Azure AD como ARM" para Registros de Contêiner do Azure.

 Core Preview
az acr config authentication-as-arm show

Mostrar a política configurada de "Autenticação do Azure AD como ARM" para um Registro de Contêiner do Azure.

 Core Preview
az acr config authentication-as-arm update

Atualize a política "Autenticação do Azure AD como ARM" para um Registro de Contêiner do Azure.

 Core Preview
az acr config content-trust

Gerenciar a política de confiança de conteúdo para Registros de Contêiner do Azure.

 Core GA
az acr config content-trust show

Mostrar a política de confiança de conteúdo configurada para um Registro de Contêiner do Azure.

 Core GA
az acr config content-trust update

Atualize a política de confiança de conteúdo para um Registro de Contêiner do Azure.

 Core GA
az acr config retention

Gerenciar a política de retenção para Registros de Contêiner do Azure.

 Core Preview
az acr config retention show

Mostrar a política de retenção configurada para um Registro de Contêiner do Azure.

 Core Preview
az acr config retention update

Atualizar a política de retenção para um Registro de Contêiner do Azure.

 Core Preview
az acr config soft-delete

Gerenciar a política de exclusão reversível para Registros de Contêiner do Azure.

 Core Preview
az acr config soft-delete show

Mostrar a política de exclusão reversível configurada para um Registro de Contêiner do Azure.

 Core Preview
az acr config soft-delete update

Atualize a política de exclusão reversível para um Registro de Contêiner do Azure.

 Core Preview
az acr connected-registry

Gerenciar recursos de registro conectados com Registros de Contêiner do Azure.

 Core GA
az acr connected-registry create

Crie um registro conectado para um Registro de Contêiner do Azure.

 Core GA
az acr connected-registry deactivate

Desativar um registro conectado do Registro de Contêiner do Azure.

 Core GA
az acr connected-registry delete

Exclua um registro conectado do Registro de Contêiner do Azure.

 Core GA
az acr connected-registry get-settings

Recupere as informações necessárias para ativar um registro conectado e crie ou gire as credenciais de token de sincronização.

 Core GA
az acr connected-registry list

Liste todos os registros conectados no registro pai atual.

 Core GA
az acr connected-registry list-client-tokens

Liste todos os tokens de cliente associados a um registro conectado específico.

 Core GA
az acr connected-registry permissions

Gerencie as permissões do repositório em vários registros conectados. Consulte https://aka.ms/acr/connected-registry para obter mais informações.

 Core GA
az acr connected-registry permissions show

Mostrar as informações do mapa de escopo de sincronização do Registro conectado.

 Core GA
az acr connected-registry permissions update

Adicione e remova permissões de repositório em todos os mapas de escopo de sincronização do Registro conectado necessários.

 Core GA
az acr connected-registry show

Mostrar detalhes do registro conectado.

 Core GA
az acr connected-registry update

Atualize um registro conectado para um Registro de Contêiner do Azure.

 Core GA
az acr create

Criar um Registro de Contêiner do Azure.

 Core GA
az acr credential

Gerenciar credenciais de logon para Registros de Contêiner do Azure.

 Core GA
az acr credential-set

Gerenciar conjuntos de credenciais nos Registros de Contêiner do Azure.

 Core GA
az acr credential-set create

Crie um conjunto de credenciais.

 Core GA
az acr credential-set delete

Excluir um conjunto de credenciais.

 Core GA
az acr credential-set list

Liste os conjuntos de credenciais em um Registro de Contêiner do Azure.

 Core GA
az acr credential-set show

Mostrar um conjunto de credenciais.

 Core GA
az acr credential-set update

Atualize a ID do segredo do Azure Key Vault de nome de usuário ou senha em um conjunto de credenciais.

 Core GA
az acr credential renew

Regenerar credenciais de logon para um Registro de Contêiner do Azure.

 Core GA
az acr credential show

Obtenha as credenciais de logon de um Registro de Contêiner do Azure.

 Core GA
az acr delete

Exclui um Registro de Contêiner do Azure.

 Core GA
az acr encryption

Gerenciar a criptografia do registro de contêiner.

 Core GA
az acr encryption rotate-key

Gire (atualize) a chave de criptografia do registro de contêiner.

 Core GA
az acr encryption show

Mostrar os detalhes de criptografia do registro de contêiner.

 Core GA
az acr export-pipeline

Gerenciar pipelines de exportação do ACR.

 Extension Preview
az acr export-pipeline create

Crie um pipeline de exportação.

 Extension Preview
az acr export-pipeline delete

Excluir um pipeline de exportação.

 Extension Preview
az acr export-pipeline list

Listar pipelines de exportação em um Registro de Contêiner.

 Extension Preview
az acr export-pipeline show

Mostrar um pipeline de exportação em detalhes.

 Extension Preview
az acr helm

Gerenciar gráficos do helm para Registros de Contêiner do Azure.

 Core Deprecated
az acr helm delete

Exclua uma versão do gráfico helm em um Registro de Contêiner do Azure.

 Core Deprecated
az acr helm install-cli

Baixe e instale a ferramenta de linha de comando do Helm.

 Core Pré-visualização e Obsoleto
az acr helm list

Liste todos os gráficos do helm em um Registro de Contêiner do Azure.

 Core Deprecated
az acr helm push

Efetue push de um pacote de gráfico helm para um Registro de Contêiner do Azure.

 Core Deprecated
az acr helm repo

Gerenciar repositórios de gráfico do helm para Registros de Contêiner do Azure.

 Core Deprecated
az acr helm repo add

Adicione um repositório de gráficos helm de um Registro de Contêiner do Azure por meio da CLI do Helm.

 Core Deprecated
az acr helm show

Descreva um gráfico helm em um Registro de Contêiner do Azure.

 Core Deprecated
az acr identity

Gerenciar identidades de serviço (gerenciado) para um registro de contêiner.

 Core GA
az acr identity assign

Atribua uma identidade gerenciada a um registro de contêiner.

 Core GA
az acr identity remove

Remova uma identidade gerenciada de um registro de contêiner.

 Core GA
az acr identity show

Mostrar os detalhes de identidade do registro de contêiner.

 Core GA
az acr import

Importa uma imagem para um Registro de Contêiner do Azure de outro Registro de Contêiner. Import remove a necessidade de docker pull, docker tag, docker push. Para imagens maiores, considere usar --no-wait.

 Core GA
az acr import-pipeline

Gerenciar pipelines de importação do ACR.

 Extension Preview
az acr import-pipeline create

Crie um pipeline de importação.

 Extension Preview
az acr import-pipeline delete

Excluir um pipeline de importação.

 Extension Preview
az acr import-pipeline list

Listar pipelines de importação em um Registro de Contêiner.

 Extension Preview
az acr import-pipeline show

Mostrar um pipeline de importação em detalhes.

 Extension Preview
az acr list

Lista todos os registros de contêiner na assinatura atual.

 Core GA
az acr login

Faça logon em um Registro de Contêiner do Azure por meio da CLI do Docker.

 Core GA
az acr manifest

Gerenciar manifestos de artefato nos Registros de Contêiner do Azure.

 Core Preview
az acr manifest delete

Exclua um manifesto em um Registro de Contêiner do Azure.

 Core Preview
az acr manifest list

Liste os manifestos em um repositório em um Registro de Contêiner do Azure.

 Core Preview
az acr manifest list-deleted

Liste os manifestos excluídos suavemente em um repositório em um Registro de Contêiner do Azure.

 Core Preview
az acr manifest list-deleted-tags

Liste as marcas excluídas suavemente em um repositório em um Registro de Contêiner do Azure.

 Core Preview
az acr manifest list-metadata

Liste os metadados dos manifestos em um repositório em um Registro de Contêiner do Azure.

 Core Preview
az acr manifest list-referrers

Liste os referenciadores a um manifesto em um Registro de Contêiner do Azure.

 Core Preview
az acr manifest restore

Restaure um artefato e uma marca de exclusão reversível em um Registro de Contêiner do Azure.

 Core Preview
az acr manifest show

Obtenha um manifesto em um Registro de Contêiner do Azure.

 Core Preview
az acr manifest show-metadata

Obtenha os metadados de um artefato em um Registro de Contêiner do Azure.

 Core Preview
az acr manifest update-metadata

Atualize os metadados de manifesto de um artefato em um Registro de Contêiner do Azure.

 Core Preview
az acr network-rule

Gerenciar regras de rede para Registros de Contêiner do Azure.

 Core GA
az acr network-rule add

Adicione uma regra de rede.

 Core GA
az acr network-rule list

Listar regras de rede.

 Core GA
az acr network-rule remove

Remover uma regra da rede.

 Core GA
az acr pack

Gerenciar tarefas do Registro de Contêiner do Azure que usam buildpacks nativos de nuvem.

 Core Preview
az acr pack build

Enfileira uma tarefa de build rápida que cria um aplicativo e o envia por push para um Registro de Contêiner do Azure.

 Core Preview
az acr pipeline-run

Gerencie as execuções de pipeline de importação e exportação do ACR.

 Extension Preview
az acr pipeline-run clean

Exclua todas as execuções de pipeline com falha no registro.

 Extension Preview
az acr pipeline-run create

Crie uma execução de pipeline.

 Extension Preview
az acr pipeline-run delete

Excluir uma execução de pipeline.

 Extension Preview
az acr pipeline-run list

Listar execuções de pipeline de todos os pipelines em um registro de contêiner.

 Extension Preview
az acr pipeline-run show

Mostrar uma execução de pipeline em detalhes.

 Extension Preview
az acr private-endpoint-connection

Gerenciar conexões de ponto de extremidade privado do registro de contêiner.

 Core GA
az acr private-endpoint-connection approve

Aprove uma solicitação de conexão de ponto de extremidade privado para um registro de contêiner.

 Core GA
az acr private-endpoint-connection delete

Exclua uma solicitação de conexão de ponto de extremidade privado para um registro de contêiner.

 Core GA
az acr private-endpoint-connection list

Liste todas as conexões de ponto de extremidade privado para um registro de contêiner.

 Core GA
az acr private-endpoint-connection reject

Rejeite uma solicitação de conexão de ponto de extremidade privado para um registro de contêiner.

 Core GA
az acr private-endpoint-connection show

Mostrar detalhes da conexão de ponto de extremidade privado de um registro de contêiner.

 Core GA
az acr private-link-resource

Gerenciar recursos de link privado do Registro.

 Core GA
az acr private-link-resource list

Liste os recursos de link privado com suporte para um registro.

 Core GA
az acr query

Consulte o conteúdo em um ACR usando a Linguagem de Consulta Kusto.

 Extension GA
az acr replication

Gerenciar regiões replicadas geograficamente dos Registros de Contêiner do Azure.

 Core GA
az acr replication create

Crie uma região replicada para um Registro de Contêiner do Azure.

 Core GA
az acr replication delete

Exclua uma região replicada de um Registro de Contêiner do Azure.

 Core GA
az acr replication list

Liste todas as regiões para um Registro de Contêiner do Azure replicado geograficamente.

 Core GA
az acr replication show

Obtenha os detalhes de uma região replicada.

 Core GA
az acr replication update

Atualiza uma replicação.

 Core GA
az acr repository

Gerenciar repositórios (nomes de imagem) para Registros de Contêiner do Azure.

 Core GA
az acr repository delete

Exclua um repositório ou imagem em um Registro de Contêiner do Azure.

 Core GA
az acr repository list

Listar repositórios em um Registro de Contêiner do Azure.

 Core GA
az acr repository list-deleted

Listar repositórios excluídos suavemente em um Registro de Contêiner do Azure.

 Core Preview
az acr repository show

Obtenha os atributos de um repositório ou imagem em um Registro de Contêiner do Azure.

 Core GA
az acr repository show-tags

Mostrar marcas para um repositório em um Registro de Contêiner do Azure.

 Core GA
az acr repository untag

Desmarcar uma imagem em um Registro de Contêiner do Azure.

 Core GA
az acr repository update

Atualize os atributos de um repositório ou imagem em um Registro de Contêiner do Azure.

 Core GA
az acr run

Enfileira uma execução rápida fornecendo logs transmitidos para um Registro de Contêiner do Azure.

 Core GA
az acr scope-map

Gerenciar mapas de acesso de escopo para Registros de Contêiner do Azure.

 Core GA
az acr scope-map create

Crie um mapa de escopo para um Registro de Contêiner do Azure.

 Core GA
az acr scope-map delete

Exclua um mapa de escopo para um Registro de Contêiner do Azure.

 Core GA
az acr scope-map list

Listar todos os mapas de escopo para um Registro de Contêiner do Azure.

 Core GA
az acr scope-map show

Mostrar detalhes e atributos de um mapa de escopo para um Registro de Contêiner do Azure.

 Core GA
az acr scope-map update

Atualize um mapa de escopo para um Registro de Contêiner do Azure.

 Core GA
az acr show

Obtenha os detalhes de um Registro de Contêiner do Azure.

 Core GA
az acr show-endpoints

Exibir pontos de extremidade do Registro.

 Core GA
az acr show-usage

Obtenha o uso de armazenamento para um Registro de Contêiner do Azure.

 Core GA
az acr supply-chain

Comandos para gerenciar recursos da cadeia de suprimentos do acr.

 Extension Preview
az acr supply-chain workflow

Comandos para gerenciar fluxos de trabalho da cadeia de suprimentos do acr.

 Extension Preview
az acr supply-chain workflow cancel-run

Cancele o fluxo de trabalho da cadeia de suprimentos atualmente em execução.

 Extension Preview
az acr supply-chain workflow create

Criar fluxo de trabalho da cadeia de suprimentos do acr.

 Extension Preview
az acr supply-chain workflow delete

Exclua o fluxo de trabalho da cadeia de suprimentos do acr.

 Extension Preview
az acr supply-chain workflow list

Listar o status das imagens de fluxo de trabalho da cadeia de suprimentos do acr.

 Extension Preview
az acr supply-chain workflow show

Mostrar tarefas de fluxo de trabalho da cadeia de suprimentos do acr.

 Extension Preview
az acr supply-chain workflow update

Atualize o fluxo de trabalho da cadeia de suprimentos do acr.

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

 Core GA
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 taskrun

Gerenciar execuções de tarefas usando Registros de Contêiner do Azure.

 Core Preview
az acr taskrun delete

Exclua uma execução de tarefas de um Registro de Contêiner do Azure.

 Core Preview
az acr taskrun list

Liste as execuções de tarefas para um Registro de Contêiner do Azure.

 Core Preview
az acr taskrun logs

Mostrar logs de execução para uma execução de tarefas específica.

 Core Preview
az acr taskrun show

Obtenha as propriedades de uma execução de tarefas nomeada para um Registro de Contêiner do Azure.

 Core Preview
az acr token

Gerenciar tokens para um Registro de Contêiner do Azure.

 Core GA
az acr token create

Crie um token associado a um mapa de escopo para um Registro de Contêiner do Azure.

 Core GA
az acr token credential

Gerenciar credenciais de um token para um Registro de Contêiner do Azure.

 Core GA
az acr token credential delete

Excluir uma credencial de token.

 Core GA
az acr token credential generate

Gere ou substitua uma ou ambas as senhas de um token para um Registro de Contêiner do Azure. Para usar token e senha para acessar um registro de contêiner, consulte https://aka.ms/acr/repo-permissions.

 Core GA
az acr token delete

Exclua um token para um Registro de Contêiner do Azure.

 Core GA
az acr token list

Liste todos os tokens para um Registro de Contêiner do Azure.

 Core GA
az acr token show

Mostrar detalhes e atributos de um token para um Registro de Contêiner do Azure.

 Core GA
az acr token update

Atualize um token (substitua o mapa de escopo associado) para um Registro de Contêiner do Azure.

 Core GA
az acr update

Atualize um Registro de Contêiner do Azure.

 Core GA
az acr webhook

Gerenciar webhooks para Registros de Contêiner do Azure.

 Core GA
az acr webhook create

Crie um webhook para um Registro de Contêiner do Azure.

 Core GA
az acr webhook delete

Exclua um webhook de um Registro de Contêiner do Azure.

 Core GA
az acr webhook get-config

Obtenha o URI de serviço e os cabeçalhos personalizados para o webhook.

 Core GA
az acr webhook list

Liste todos os webhooks para um Registro de Contêiner do Azure.

 Core GA
az acr webhook list-events

Listar eventos recentes para um webhook.

 Core GA
az acr webhook ping

Dispare um evento de ping para um webhook.

 Core GA
az acr webhook show

Obtenha os detalhes de um webhook.

 Core GA
az acr webhook update

Atualize um webhook.

 Core GA

az acr build

Editar

Enfileira um build rápido, fornecendo logs de streaming para um Registro de Contêiner do Azure.

az acr build --registry
             [--agent-pool]
             [--auth-mode {Default, None}]
             [--build-arg]
             [--file]
             [--image]
             [--log-template]
             [--no-format]
             [--no-logs]
             [--no-push]
             [--no-wait]
             [--platform]
             [--resource-group]
             [--secret-build-arg]
             [--source-acr-auth-id {[caller], none}]
             [--target]
             [--timeout]
             []

Exemplos

Enfileira um contexto local como um build do Linux, marque-o e envie-o por push para o Registro.

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry .

Enfileira um contexto local como um build do Linux, marque-o e envie-o por push para o Registro sem logs de streaming.

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry --no-logs .

Enfileirar um contexto local como um build do Linux sem efetuar push dele para o Registro.

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry --no-push .

Enfileirar um contexto local como um build do Linux sem efetuar push dele para o Registro.

az acr build -r myregistry .

Enfileirar um contexto remoto do GitHub como um build do Windows, marcá-lo e efetuá-lo por push para o registro.

az acr build -r myregistry https://github.com/Azure/acr-builder.git -f Windows.Dockerfile --platform windows

Enfileirar um build de contexto remoto do Artefato OCI.

az acr build -r myregistry oci://myregistry.azurecr.io/myartifact:mytag

Enfileira um contexto local como um build do Linux na arquitetura arm/v7, marque-o e envie-o por push para o Registro.

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry . --platform linux/arm/v7

Enfileira um contexto local como um build do Linux, marque-o e envie-o por push para o registro habilitado para permissão de repositório com base em ABAC e use a identidade entra do chamador para autenticar com o registro de origem.

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry . --source-acr-auth-id [caller]

Parâmetros Exigidos

--registry -r

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--agent-pool
Versão Prévia

O nome do pool de agentes.

--auth-mode

Modo de autenticação do registro de origem.

Propriedade Valor
Valores aceitos: Default, None
--build-arg

Argumento de build no formato '--build-arg name[=value]'. Há suporte para múltiplos passando '--build-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.

--file -f

O caminho relativo do arquivo docker para a pasta raiz do código-fonte. Padrão para 'Dockerfile'.

--image -t

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.

--log-template
Versão Prévia

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.

--no-format

Indica se os logs devem ser exibidos em formato bruto.

Propriedade Valor
Valor padrão: False
--no-logs

Não mostre logs depois de enfileirar o build com êxito.

Propriedade Valor
Valor padrão: False
--no-push

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

Propriedade Valor
Valor padrão: False
--no-wait

Não aguarde a conclusão do build e retorne imediatamente após a enfileiramento do build.

Propriedade Valor
Valor padrão: False
--platform

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.

--resource-group -g

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

--secret-build-arg

Argumento de build secreto no formato '--secret-build-arg name[=value]'. Há suporte para múltiplos passando '--secret-build-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.

--source-acr-auth-id
Versão Prévia

Atribua a identidade usada para logon do registro de origem. Use '[chamador]' para a identidade do chamador.

Propriedade Valor
Valores aceitos: [caller], none
--target

O nome do estágio de build de destino.

--timeout

O tempo limite em segundos.

<SOURCE_LOCATION>

O caminho do diretório do código-fonte local (por exemplo, './src') ou a URL para um repositório git (por exemplo, 'https://github.com/Azure-Samples/acr-build-helloworld-node.git') 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').

Propriedade Valor
Parameter group: Positional
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr check-health

Editar

Obtém informações de integridade sobre o ambiente e, opcionalmente, um registro de destino.

az acr check-health [--ignore-errors]
                    [--name]
                    [--repository]
                    [--vnet]
                    [--yes]

Exemplos

Obtém o estado de integridade com o registro de destino 'myregistry', ignorando a confirmação para efetuar pull da imagem.

az acr check-health -n myregistry -y

Obtém o estado de integridade do ambiente, sem parar no primeiro erro.

az acr check-health --ignore-errors

Obtém o estado de integridade com o registro de destino 'myregistry' e verifica as permissões permitidas para o repositório específico 'myrepo'.

az acr check-health -n myregistry --repository myrepo

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ignore-errors

Forneça todas as verificações de integridade, mesmo se forem encontrados erros.

Propriedade Valor
Valor padrão: False
--name -n

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

--repository
Versão Prévia

O nome do repositório.

--vnet

ID de rede virtual para executar esse comando dentro de uma VNET para verificar o roteamento DNS para pontos de extremidade privados.

--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr check-name

Editar

Verifica se um nome do Registro de Contêiner do Azure é válido e está disponível para uso.

az acr check-name --name
                  [--dnl-scope {NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure}]
                  [--resource-group]

Exemplos

Verifique se já existe um nome de registro.

az acr check-name -n doesthisnameexist

Parâmetros Exigidos

--name -n

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--dnl-scope
Versão Prévia

O escopo do rótulo de nome de domínio adicionará um hash ao nome do recurso. O nome do servidor de logon resultante estará no formato registry-name-hash.azurecr-io. O padrão é Não seguro.

Propriedade Valor
Valor padrão: Unsecure
Valores aceitos: NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure
--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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr create

Editar

Criar um Registro de Contêiner do Azure.

az acr create --name
              --resource-group
              --sku {Basic, Premium, Standard}
              [--admin-enabled {false, true}]
              [--allow-exports {false, true}]
              [--allow-metadata-search {false, true}]
              [--allow-trusted-services {false, true}]
              [--default-action {Allow, Deny}]
              [--dnl-scope {NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure}]
              [--identity]
              [--key-encryption-key]
              [--___location]
              [--public-network-enabled {false, true}]
              [--role-assignment-mode {rbac, rbac-abac}]
              [--tags]
              [--workspace]
              [--zone-redundancy {Disabled, Enabled}]

Exemplos

Crie um registro de contêiner gerenciado com o SKU Standard.

az acr create -n myregistry -g MyResourceGroup --sku Standard

Crie um registro com a Permissão de Repositório baseada em ABAC habilitada.

az acr create -n myregistry -g MyResourceGroup --sku Standard --role-assignment-mode rbac-abac

Parâmetros Exigidos

--name -n

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

--resource-group -g

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

--sku

A SKU do registro de contêiner.

Propriedade Valor
Valores aceitos: Basic, Premium, Standard

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--admin-enabled

Indica se o usuário administrador está habilitado.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--allow-exports
Versão Prévia

Configure exportPolicy para permitir/não permitir que artefatos sejam exportados desse registro. Os artefatos podem ser exportados por meio de operações de importação ou transferência. Para obter mais informações, visite https://aka.ms/acr/export-policy.

Propriedade Valor
Valores aceitos: false, true
--allow-metadata-search
Versão Prévia

Habilite ou desabilite o recurso de pesquisa de metadados para o Registro. Se não for especificado, isso será definido como desabilitado por padrão.

Propriedade Valor
Valores aceitos: false, true
--allow-trusted-services

Permitir que os Serviços confiáveis do Azure acessem registros restritos de rede. Para obter mais informações, visite https://aka.ms/acr/trusted-services. O padrão é permitir.

Propriedade Valor
Parameter group: Network Rule Arguments
Valores aceitos: false, true
--default-action

Ação padrão a ser aplicada quando nenhuma regra corresponder. Aplicável somente ao SKU Premium.

Propriedade Valor
Parameter group: Network Rule Arguments
Valores aceitos: Allow, Deny
--dnl-scope
Versão Prévia

O escopo do rótulo de nome de domínio adicionará um hash ao nome do recurso. O nome do servidor de logon resultante estará no formato registryname-hash.azurecr-io. O padrão é Não seguro.

Propriedade Valor
Valores aceitos: NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure
--identity

Use a ID do recurso de identidade gerenciada atribuída ou o nome se estiver no mesmo grupo de recursos.

Propriedade Valor
Parameter group: Customer managed key Arguments
--key-encryption-key

URI da chave do cofre de chaves. Para habilitar a rotação automatizada, forneça um uri de chave sem versão. Para rotação manual, forneça um uri de chave com versão.

Propriedade Valor
Parameter group: Customer managed key Arguments
--___location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults ___location=<___location>.

--public-network-enabled

Permitir acesso à rede pública para o registro de contêiner. O padrão é permitir.

Propriedade Valor
Parameter group: Network Rule Arguments
Valores aceitos: false, true
--role-assignment-mode
Versão Prévia

Modo de atribuição de função do Registro. Para obter mais informações sobre esse recurso, consulte https://aka.ms/acr/auth/abac. O padrão é rbac.

Propriedade Valor
Parameter group: Permissions and Role Assignment Arguments
Valores aceitos: rbac, rbac-abac
--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--workspace
Versão Prévia

Nome ou ID do workspace do Log Analytics para o qual enviar logs de diagnóstico do Registro. Todos os eventos serão habilitados. Você pode usar "az monitor log-analytics workspace create" para criar um. Pode haver cobrança extra.

--zone-redundancy
Versão Prévia

Indica se a redundância de zona deve ou não ser habilitada para esse registro ou replicação. Para obter mais informações, como locais com suporte, visite https://aka.ms/acr/az. A redundância de zona não pode ser atualizada. O padrão é 'Desabilitado'.

Propriedade Valor
Valores aceitos: Disabled, Enabled
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr delete

Editar

Exclui um Registro de Contêiner do Azure.

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

Exemplos

Excluir um Registro de Contêiner do Azure.

az acr delete -n myregistry

Parâmetros Exigidos

--name -n

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--resource-group -g

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

--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr import

Editar

Importa uma imagem para um Registro de Contêiner do Azure de outro Registro de Contêiner. Import remove a necessidade de docker pull, docker tag, docker push. Para imagens maiores, considere usar --no-wait.

az acr import --name
              --source
              [--force]
              [--image]
              [--no-wait]
              [--password]
              [--registry]
              [--repository]
              [--resource-group]
              [--username]

Exemplos

Importe uma imagem de 'sourceregistry' para 'myregistry'. A imagem herda seu repositório de origem e nomes de marca.

az acr import -n myregistry --source sourceregistry.azurecr.io/sourcerepository:sourcetag

Importe uma imagem de um repositório público no Hub do Docker. A imagem usa o repositório e os nomes de marca especificados.

az acr import -n myregistry --source docker.io/library/hello-world:latest -t targetrepository:targettag

Importe uma imagem de um repositório privado usando seu nome de usuário e senha. Isso também se aplica a registros fora do Azure.

az acr import -n myregistry --source myprivateregistry.azurecr.io/hello-world:latest -u username -p password

Importe uma imagem de um registro de contêiner do Azure em uma assinatura diferente.

az acr import -n myregistry --source sourcerepository:sourcetag -t targetrepository:targettag \
    -r /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sourceResourceGroup/providers/Microsoft.ContainerRegistry/registries/sourceRegistry

Importe uma imagem sem aguardar a conclusão bem-sucedida. Falhas durante a importação não serão refletidas. Execute 'az acr repository show-tags' para confirmar se a importação foi bem-sucedida.

az acr import -n myregistry --source sourceregistry.azurecr.io/sourcerepository:sourcetag --no-wait

Parâmetros Exigidos

--name -n

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

--source

Nome da imagem de origem ou fonte totalmente qualificada que contém o servidor de logon do Registro. Se --registry for usado, --source sempre será interpretado como uma imagem de origem, mesmo que contenha o servidor de logon.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--force

Substitua a marca existente da imagem a ser importada.

Propriedade Valor
Valor padrão: False
--image -t

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.

--no-wait

Não aguarde a conclusão da importação e retorne imediatamente depois de enfileirar a importação.

Propriedade Valor
Valor padrão: False
--password -p

A senha do registro de contêiner de origem.

--registry -r

O registro de contêiner do Azure de origem. Isso pode ser nome, servidor de logon ou ID de recurso do registro de origem.

--repository

O nome do repositório para uma cópia somente de manifesto de imagens. Várias cópias com suporte passando o repositório --várias vezes.

--resource-group -g

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

--username -u

O nome de usuário do registro de contêiner de origem.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr list

Editar

Lista todos os registros de contêiner na assinatura atual.

az acr list [--resource-group]

Exemplos

Listar registros de contêiner e mostrar os resultados em uma tabela, em vários grupos de recursos.

az acr list -o table

Listar registros de contêiner em um grupo de recursos e mostrar os resultados em uma tabela.

az acr list -g MyResourceGroup -o table

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr login

Editar

Faça logon em um Registro de Contêiner do Azure por meio da CLI do Docker.

O Docker deve ser instalado em seu computador. Depois de concluído, use docker logout <registry url> para fazer logoff. (Se você precisar apenas de um token de atualização e não quiser instalar o Docker, especifique '--expose-token').

az acr login --name
             [--expose-token]
             [--password]
             [--resource-group]
             [--suffix]
             [--username]

Exemplos

Fazer logon em um Registro de Contêiner do Azure

az acr login -n myregistry

Obter um token de acesso do Registro de Contêiner do Azure

az acr login -n myregistry --expose-token

Parâmetros Exigidos

--name -n

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--expose-token -t

Exponha o token de atualização em vez de fazer logon automaticamente por meio da CLI do Docker.

Propriedade Valor
Valor padrão: False
--password -p

A senha usada para fazer logon em um registro de contêiner.

--resource-group -g

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

--suffix

O sufixo de locatário no servidor de logon do Registro. Você poderá especificar '--locatário do sufixo' se o servidor de logon do registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o registro de uma assinatura diferente ou tiver permissão para acessar imagens, mas não a permissão para gerenciar o recurso do Registro.

--username -u

O nome de usuário usado para fazer logon em um registro de contêiner.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr query

Consulte o conteúdo em um ACR usando a Linguagem de Consulta Kusto.

Consulte artefatos e imagens em um Registro de Contêiner do Azure usando a Linguagem de Consulta Kusto. Propriedades de manifesto OCI, como resumo, assunto, anotações etc. podem ser usadas para consultar, filtrar e ordenar resultados da pesquisa.

az acr query --kql-query
             --name
             [--password]
             [--repository]
             [--skip-token]
             [--username]

Exemplos

Buscar um único manifesto

az acr query -n $MyRegistry -q "Manifests | limit 1"

Contar todos os manifestos no repositório $RepositoryName

az acr query -n $MyRegistry -q "Manifests" -o table

Listar todos os manifestos no repositório $RepositoryName na ordem da data de criação

az acr query -n $MyRegistry --repository $RepositoryName -q "Manifests | order by createdAt desc"

Consultar todos os resumos assinados por $Signature no repositório $RepositoryName

az acr query -n $MyRegistry --repository $RepositoryName -q "Manifests | where annotations['org.cncf.notary.signature.subject'] == $Signature | project createdAt, digest, subject"

Consultar os resumos em um registro usando um token skip e classificar por resumo (para resultados com paginação)

az acr query -n $MyRegistry -q "Manifests | project digest | order by digest asc" --skip-token eyAibm8iOiAibHVjayIsICJidXQiOiAibmljZSIsICJ0cnkiOiAiISIgfQ==

Parâmetros Exigidos

--kql-query -q

A consulta KQL a ser executada.

--name -n

O nome do registro de contêiner no qual a consulta é executada.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--password -p

Senha do Registro.

--repository

O repositório no qual a consulta é executada. Se nenhum repositório for fornecido, a consulta será executada no nível do Registro.

--skip-token

Ignore o token para obter a próxima página da consulta, se aplicável.

--username -u

Nome de usuário do Registro.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr run

Editar

Enfileira uma execução rápida fornecendo logs transmitidos para um Registro de Contêiner do Azure.

az acr run --registry
           [--agent-pool]
           [--auth-mode {Default, None}]
           [--cmd]
           [--file]
           [--log-template]
           [--no-format]
           [--no-logs]
           [--no-wait]
           [--platform]
           [--resource-group]
           [--set]
           [--set-secret]
           [--source-acr-auth-id {[caller], none}]
           [--timeout]
           [--values]
           []

Exemplos

Enfileira uma execução para executar um comando de contêiner.

az acr run -r myregistry --cmd '$Registry/myimage' /dev/null

Enfileira uma execução com a definição de tarefa da entrada padrão. 'Ctrl + Z'(Windows) ou 'Ctrl + D'(Linux) encerra o fluxo de entrada.

az acr run -r myregistry -f - /dev/null

Enfileira uma execução para executar as tarefas passadas pelo pipe.

cat task.yaml | az acr run -r myregistry -f - /dev/null

Enfileirar um contexto local, enviado por push para o ACR com logs de streaming.

az acr run -r myregistry -f bash-echo.yaml ./workspace

Enfileirar um contexto git remoto com logs de streaming.

az acr run -r myregistry https://github.com/Azure-Samples/acr-tasks.git -f hello-world.yaml

Enfileira um contexto git remoto com logs de streaming e executa a tarefa na plataforma Linux.

az acr run -r myregistry https://github.com/Azure-Samples/acr-tasks.git -f build-hello-world.yaml --platform linux

Enfileira um contexto remoto do Artefato OCI e executa a tarefa.

az acr run -r myregistry oci://myregistry.azurecr.io/myartifact:mytag -f hello-world.yaml

Enfileira uma execução para executar um comando de contêiner em um registro habilitado para Permissão de Repositório com base em ABAC e use a identidade entra do chamador para autenticar com o registro de origem.

az acr run -r myregistry --cmd '$Registry/myimage' /dev/null --source-acr-auth-id [caller]

Parâmetros Exigidos

--registry -r

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--agent-pool
Versão Prévia

O nome do pool de agentes.

--auth-mode

Modo de autenticação do registro de origem.

Propriedade Valor
Valores aceitos: Default, None
--cmd

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

--file -f

O caminho do arquivo de definição/modelo de tarefa relativo ao contexto de origem. Pode ser '-' para canalizar um arquivo da entrada padrão.

--log-template
Versão Prévia

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.

--no-format

Indica se os logs devem ser exibidos em formato bruto.

Propriedade Valor
Valor padrão: False
--no-logs

Não mostre logs depois de enfileirar o build com êxito.

Propriedade Valor
Valor padrão: False
--no-wait

Não aguarde a conclusão da execução e retorne imediatamente depois de enfileirar a execução.

Propriedade Valor
Valor padrão: False
--platform

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.

--resource-group -g

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

--set

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

--set-secret

Valor secreto no formato '--set name[=value]'. Múltiplos com suporte passando --set várias vezes.

--source-acr-auth-id
Versão Prévia

Atribua a identidade usada para logon do registro de origem. Use '[chamador]' para a identidade do chamador.

Propriedade Valor
Valores aceitos: [caller], none
--timeout

O tempo limite em segundos.

--values

O caminho do arquivo de valores de tarefa relativo ao contexto de origem.

<SOURCE_LOCATION>

O caminho do diretório do código-fonte local (por exemplo, './src') ou a URL para um repositório git (por exemplo, 'https://github.com/Azure-Samples/acr-build-helloworld-node.git') 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.

Propriedade Valor
Parameter group: Positional
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr show

Editar

Obtenha os detalhes de um Registro de Contêiner do Azure.

az acr show --name
            [--resource-group]

Exemplos

Obtenha o servidor de logon de um Registro de Contêiner do Azure.

az acr show -n myregistry --query loginServer

Obter os detalhes de um Registro de Contêiner do Azure

az acr show --name myregistry --resource-group MyResourceGroup

Verifique o status da permissão de repositório baseada em ABAC em um registro.

az acr show --name myregistry --resource-group MyResourceGroup --query roleAssignmentMode

Parâmetros Exigidos

--name -n

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr show-endpoints

Editar

Exibir pontos de extremidade do Registro.

az acr show-endpoints --name
                      [--resource-group]

Parâmetros Exigidos

--name -n

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr show-usage

Editar

Obtenha o uso de armazenamento para um Registro de Contêiner do Azure.

az acr show-usage --name
                  [--resource-group]

Exemplos

Obtenha o uso de armazenamento para um Registro de Contêiner do Azure.

az acr show-usage -n myregistry

Parâmetros Exigidos

--name -n

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr update

Editar

Atualize um Registro de Contêiner do Azure.

az acr update --name
              [--add]
              [--admin-enabled {false, true}]
              [--allow-exports {false, true}]
              [--allow-metadata-search {false, true}]
              [--allow-trusted-services {false, true}]
              [--anonymous-pull-enabled {false, true}]
              [--data-endpoint-enabled {false, true}]
              [--default-action {Allow, Deny}]
              [--force-string]
              [--public-network-enabled {false, true}]
              [--remove]
              [--resource-group]
              [--role-assignment-mode {rbac, rbac-abac}]
              [--set]
              [--sku {Basic, Premium, Standard}]
              [--tags]

Exemplos

Atualizar marcas para um Registro de Contêiner do Azure.

az acr update -n myregistry --tags key1=value1 key2=value2

Habilite a conta de usuário do administrador para um Registro de Contêiner do Azure.

az acr update -n myregistry --admin-enabled true

Ative a Permissão de Repositório baseada em ABAC em um registro existente.

az acr update -n myregistry --role-assignment-mode rbac-abac

Parâmetros Exigidos

--name -n

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Propriedade Valor
Parameter group: Generic Update Arguments
Valor padrão: []
--admin-enabled

Indica se o usuário administrador está habilitado.

Propriedade Valor
Valores aceitos: false, true
--allow-exports
Versão Prévia

Configure exportPolicy para permitir/não permitir que artefatos sejam exportados desse registro. Os artefatos podem ser exportados por meio de operações de importação ou transferência. Para obter mais informações, visite https://aka.ms/acr/export-policy.

Propriedade Valor
Valores aceitos: false, true
--allow-metadata-search
Versão Prévia

Habilite ou desabilite o recurso de pesquisa de metadados para o Registro.

Propriedade Valor
Valores aceitos: false, true
--allow-trusted-services

Permitir que os Serviços confiáveis do Azure acessem registros restritos de rede. Para obter mais informações, visite https://aka.ms/acr/trusted-services.

Propriedade Valor
Parameter group: Network Rule Arguments
Valores aceitos: false, true
--anonymous-pull-enabled

Habilite o pull em todo o Registro de clientes não autenticados.

Propriedade Valor
Valores aceitos: false, true
--data-endpoint-enabled

Habilite o ponto de extremidade de dados dedicado para a configuração do firewall do cliente.

Propriedade Valor
Parameter group: Network Rule Arguments
Valores aceitos: false, true
--default-action

Ação padrão a ser aplicada quando nenhuma regra corresponder. Aplicável somente ao SKU Premium.

Propriedade Valor
Parameter group: Network Rule Arguments
Valores aceitos: Allow, Deny
--force-string

Ao usar 'set' ou 'add', preserve literais de cadeia de caracteres em vez de tentar converter em JSON.

Propriedade Valor
Parameter group: Generic Update Arguments
Valor padrão: False
--public-network-enabled

Permitir acesso à rede pública para o registro de contêiner.

Propriedade Valor
Parameter group: Network Rule Arguments
Valores aceitos: false, true
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OR --remove propertyToRemove.

Propriedade Valor
Parameter group: Generic Update Arguments
Valor padrão: []
--resource-group -g

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

--role-assignment-mode
Versão Prévia

Modo de atribuição de função do Registro. Para obter mais informações sobre esse recurso, consulte https://aka.ms/acr/auth/abac. O padrão é rbac.

Propriedade Valor
Parameter group: Permissions and Role Assignment Arguments
Valores aceitos: rbac, rbac-abac
--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Propriedade Valor
Parameter group: Generic Update Arguments
Valor padrão: []
--sku

A SKU do registro de contêiner.

Propriedade Valor
Valores aceitos: Basic, Premium, Standard
--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False