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

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.

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

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
Grupo de parâmetros:	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

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.

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

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

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.

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

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.

--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
Grupo de parâmetros:	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
Grupo de parâmetros:	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
Grupo de parâmetros:	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
Grupo de parâmetros:	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
Grupo de parâmetros:	Network Rule Arguments
Valores aceitos:	false, true

--role-assignment-mode

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
Grupo de parâmetros:	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

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.

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

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.

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

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.

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

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]

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

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

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.

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

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.

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

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.

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

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

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>

Propriedade	Valor
Grupo de parâmetros:	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

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.

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

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.

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

Obtenha a quantidade atual de armazenamento usada pelo registro com base no armazenamento incluído de sua SKU (em bytes).

az acr show-usage -n myregistry --query "value[?name=='Size'] | [0]"

Obtenha a quantidade atual de armazenamento usada pelo registro e a capacidade máxima de armazenamento permitida.

az acr show-usage -n myregistry --query "value[?name=='MaximumStorageCapacity'] | [0]"

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

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.

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

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.

--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
Grupo de parâmetros:	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

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
Grupo de parâmetros:	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
Grupo de parâmetros:	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
Grupo de parâmetros:	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
Grupo de parâmetros:	Generic Update Arguments
Valor padrão:	False

--public-network-enabled

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

Propriedade	Valor
Grupo de parâmetros:	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
Grupo de parâmetros:	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

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
Grupo de parâmetros:	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
Grupo de parâmetros:	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

Comentários

Esta página foi útil?

Compartilhar via

az acr

Comandos

az acr build

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr check-health

Exemplos

Parâmetros Opcionais

az acr check-name

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr create

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr delete

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr import

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr list

Exemplos

Parâmetros Opcionais

az acr login

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr query

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr run

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr show

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr show-endpoints

Parâmetros Exigidos

Parâmetros Opcionais

az acr show-usage

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az acr update

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

Comentários