azure-container-registry-cli

Manage Azure Container Registry resources with the az acr CLI command group.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula --skill azure-container-registry-cli-serpro-workshop-fortaleza
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: azure-container-registry-cli
Source: https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula/tree/main/.github/skills/azure-container-registry-cli
Command: npx skills add https://github.com/serpro-workshop-fortaleza/sifap-modernization-paula --skill azure-container-registry-cli-serpro-workshop-fortaleza

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Managing container registries in Azure involves many distinct concerns—authentication, image builds, repository cleanup, networking, and geo-replication—and using the wrong command or security posture leads to broken pipelines and exposed registries. This Skill provides structured, security-first guidance for operating Azure Container Registry with the az acr CLI. ## Core Features & Use Cases - Cloud-based image builds: Compile and push container images with az acr build and ACR Tasks, without requiring a local Docker daemon, including git triggers, base-image triggers, and multi-step task YAML. - Secure authentication patterns: Configure Microsoft Entra RBAC roles (AcrPull/AcrPush or ABAC repository roles), managed identities, AKS integration via --attach-acr, and repository-scoped tokens while keeping the admin user disabled. - Repository lifecycle management: Import images server-side, untag versus delete manifests, schedule cleanup with acr purge, lock critical tags, and monitor storage usage. - Use Case: Your team needs to push a Spring Boot image to ACR and let AKS pull it without admin credentials. The Skill produces a command plan: build with az acr build, then grant the kubelet managed identity the AcrPull role. ## Quick Start Ask the assistant to build your container image in Azure Container Registry and configure secure pull access for your AKS cluster using managed identities.

Frequently Asked Questions about azure-container-registry-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a container image in Azure without a local Docker daemon?

Use az acr build --registry {registry} --image app:v1 . to compile the image in Azure and push it to your registry. The build context is uploaded, so keep it small with a .dockerignore file, and use a unique tag per build such as a git SHA.

How do I allow AKS to pull images from Azure Container Registry?

Run az aks update --name {cluster} --resource-group {rg} --attach-acr {registry} to grant the kubelet identity the AcrPull role. For ABAC-enabled registries, manually assign the Container Registry Repository Reader role instead, since AcrPull is not accepted there.

Should I enable the admin user on Azure Container Registry?

No, keep the admin user disabled in production because it is a single account with full push/pull access and no per-user auditing. Use Microsoft Entra RBAC roles, managed identities, or repository-scoped tokens instead.

How do I delete old images from Azure Container Registry?

Run acr purge as an ACR Task, always starting with a --dry-run to preview deletions. Note that --untagged ignores the --ago filter and deletes all untagged manifests, and you can schedule cleanup with a cron-based ACR Task.

What is the difference between az acr repository untag and delete?

Untag removes only the tag while the manifest and layers remain accessible by digest. Delete by tag removes the entire manifest plus all other tags pointing to it, so untag first if you only want to retire a tag name.

Which ACR SKU do I need for geo-replication and private endpoints?

Geo-replication, private endpoints, IP network rules, dedicated data endpoints, connected registries, and retention policies all require the Premium SKU. Zone redundancy is automatic on all SKUs in supported regions, and repository-scoped tokens work on every tier.