azure-container-registry-cli

Manage Azure Container Registry resources with az acr CLI commands.

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/serpro-workshop-fortaleza/datacorp-sifap-modernization-team-kit --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/datacorp-sifap-modernization-team-kit/tree/main/.github/skills/azure-container-registry-cli
Command: npx skills add https://github.com/serpro-workshop-fortaleza/datacorp-sifap-modernization-team-kit --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 operational tasks—building images, authenticating securely, cleaning up old tags, and configuring networking—that are error-prone when done ad hoc. This Skill provides structured, security-first guidance for every az acr operation. ## 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 commit, base-image, and timer triggers. - 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 instead of the admin user. - Registry lifecycle operations: Import images server-side, purge stale tags with acr purge, lock critical images, and configure geo-replication, private endpoints, and pull-through cache. - Use Case: Your team needs to build a Spring Boot image in Azure, push it to a Standard-tier registry, and grant an AKS cluster pull access without enabling the admin account—this Skill produces the exact command plan and security posture summary. ## Quick Start Ask the AI to build your container image in Azure Container Registry and grant your AKS cluster pull access using managed identity instead of the admin user.

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 with your registry name and image tag, for example az acr build --registry myregistry --image app:v1 . The build runs in Azure and pushes directly to the registry, so no local Docker daemon is required.

How do I grant AKS pull access to Azure Container Registry?▼

Run az aks update with --attach-acr to grant the kubelet identity the AcrPull role. For ABAC-enabled registries, manually assign the Container Registry Repository Reader role to the kubelet identity instead, since AcrPull is not accepted there.

Should I use the ACR admin user in production?▼

No, the admin account should stay disabled in production because it grants full push and pull access without per-user auditing. Use Microsoft Entra RBAC roles, managed identities, or repository-scoped tokens for authentication instead.

How do I clean up old images in Azure Container Registry?▼

Run acr purge as an ACR Task with filters and an age threshold, always starting with --dry-run to preview deletions. You can schedule it as a nightly task, but note that --untagged ignores the age filter and deletes all untagged manifests.

Which ACR SKU supports 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. Repository-scoped tokens work on all tiers, and zone redundancy is automatic in supported regions.

Why do ACR Tasks fail with 403 errors on network-restricted registries?▼

Since June 2025, allowing trusted services alone is insufficient for tasks using system-assigned managed identities. Enable the networkRuleBypassAllowedForTasks property, or run tasks on a VNet-attached agent pool to avoid the bypass entirely.