Azure Container Registry CLI

Gerencie recursos do Azure Container Registry (ACR) usando o grupo de comandos az acr da CLI do Azure.

CLI: az acr vem com a CLI do Azure principal — nenhuma extensão é necessária (a extensão acrtransfer só é necessária para pipelines de exportação/importação).

Pré-requisitos

# Install Azure CLI
brew install azure-cli  # macOS
curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash  # Linux
winget install Microsoft.AzureCLI  # Windows

# Sign in and select subscription
az login
az account set --subscription {subscription-id}

Início Rápido

# Create a registry (SKU: Basic | Standard | Premium)
az acr create --resource-group {rg} --name {registry} --sku Standard

# Authenticate Docker/Podman against the registry
az acr login --name {registry}

# Build and push in the cloud — no local Docker needed
az acr build --registry {registry} --image app:v1 .

# Copy an image from another registry without pull/push
az acr import --name {registry} --source mcr.microsoft.com/hello-world:latest

# List repositories and tags
az acr repository list --name {registry} --output table
az acr repository show-tags --name {registry} --repository app --orderby time_desc

# Diagnose registry connectivity and configuration
az acr check-health --name {registry} --yes

Princípios Chave

• Prefira az acr build / Tarefas ACR em vez de docker build local + docker push: compilações são executadas no Azure, funcionam sem um daemon local e se integram com gatilhos.
• Prefira az acr import para mover imagens entre registros: é do lado do servidor, mais rápido e não requer armazenamento local.
• Nunca habilite o usuário administrador para produção — use identidades do Microsoft Entra (funções RBAC AcrPull/AcrPush, ou Container Registry Repository Reader/Writer em registros com ABAC habilitado), tokens com escopo de repositório ou identidades gerenciadas.
• Recursos apenas para Premium: replicação geográfica, pontos de extremidade privados, políticas de retenção, registros conectados, pools de agentes. (Tokens com escopo de repositório funcionam em todos os níveis; redundância de zona é automática em todos os níveis em regiões compatíveis.)

Estrutura da CLI

az acr
├── create / delete / list / show / update   # Registry lifecycle
├── login                  # Docker credential helper (or --expose-token)
├── check-health / check-name / show-usage   # Diagnostics & quota
├── build                  # Cloud image build (quick task)
├── run                    # Run a command / multi-step task once
├── task                   # ACR Tasks (triggers, timers, logs, runs)
├── agentpool              # Dedicated task agent pools (Premium)
├── import                 # Server-side image copy into the registry
├── repository             # List/show/delete/untag repos & tags, lock images
├── manifest               # Manifest metadata, delete, OCI referrers
├── credential             # Admin user credentials (avoid in production)
├── token / scope-map      # Repository-scoped tokens (Premium)
├── replication            # Geo-replication (Premium)
├── network-rule           # IP network rules
├── private-endpoint-connection  # Private Link approvals
├── config                 # content-trust, retention, soft-delete, ...
├── cache / credential-set # Artifact cache (pull-through cache) rules
├── webhook                # Push/delete event webhooks
├── connected-registry     # On-premises / IoT connected registries
└── export-pipeline / import-pipeline / pipeline-run  # acrtransfer extension

Arquivos de Referência

Leia o arquivo de referência relevante com base na tarefa do usuário. Cada arquivo contém a sintaxe completa do comando e exemplos para seu domínio.

…