ACR quarantine policy is a safety gate for images. Newly pushed images can be hidden from normal users until security scanning or approval clears them, reducing the chance that unreviewed images are pulled into workloads.
ACR image quarantine is a preview registry mode in which only images that pass security scans are visible to normal users. A quarantine policy helps keep newly pushed images from normal consumption until scan or approval processing allows them.
Technically, ACR quarantine policy operates inside a larger Azure control surface rather than as an isolated option. It belongs to container registry security and supply-chain governance, but operators must treat it carefully because quarantine has been preview-oriented and not the same as a complete Defender for Containers, signing, policy, admission-control, or deployment-gate solution. That means the term can affect identities, resource state, artifact availability, storage behavior, deployment timing, cost allocation, or supportability depending on the scenario. The minimum technical review is to locate the resource or identity, confirm the tenant and subscription context, inspect the precise JSON fields, and compare the observed state with the architecture decision. Useful evidence includes registry policy state, scanner integration, image scan result, manifest digest, tag visibility, repository permissions, content trust settings, retention and soft-delete policies, Defender findings, deployment gates, exception approvals, and whether ordinary users can pull the quarantined image. If the CLI output is incomplete, switch from table output to JSON and use targeted JMESPath queries so nested fields are not hidden. The technical mistake is to assume a successful command proves the design is correct. A command only proves Azure accepted or returned a request; the engineer still has to interpret whether the result matches policy, ownership, lifecycle, and incident-recovery expectations.
ACR quarantine policy matters because it turns an Azure architecture decision into behavior that real users, services, storage clients, deployment systems, or container workloads experience. It is also a place where small assumptions create expensive incidents. The direct risk is that depending on quarantine as if it were a universal GA protection can create a false sense of safety, especially if current CLI support, scanning workflow, registry SKU, or deployment admission controls do not match the architecture review's assumptions. The less obvious risk is operational drift: someone makes a one-time exception, stores a token, changes an image tag, enables a convenience credential, or chooses a cheaper tier, and months later nobody remembers why production behaves differently. A useful glossary entry has to teach the decision path, not merely the product label. For ACR quarantine policy, teams should be able to describe the owner, the approval path, the safe default, the rollback path, the monitoring signal, and the command output that proves the final state. That is what keeps a learning page useful in a real Azure environment.
Signals, screens, and Azure surfaces where this term usually becomes operational.
You see ACR quarantine policy in ACR security reviews, image scanning pipelines, registry policy discussions, deployment approval gates, Defender for Containers findings, repository visibility incidents. In those places, the term is usually attached to a real decision about access, data movement, image availability, artifact identity, storage cost, or operational proof rather than just documentation language.
You also see it in incident tickets and architecture reviews where someone needs to explain why behavior changed. The evidence usually includes registry policy state, scanner integration, image scan result, manifest digest, tag visibility, repository permissions, content trust settings, retention and soft-delete policies, Defender findings, deployment gates, exception approvals, and whether ordinary users can pull the quarantined image, plus the tenant, subscription, resource group, and owner responsible for the decision.
Learners meet ACR quarantine policy when they move from portal recognition to command-line evidence. The goal is to read output fields like policies, status, digest, tags, contentTrust, retention, softDelete and turn them into a safe next action.
Specific situations where this term helps solve real Azure design, operations, migration, security, reliability, cost, or governance problems.
Different enterprise-style examples that show the term being used to hit measurable objectives.
Scenario, objectives, solution, measured impact, and takeaway.
Pioneer Health Apps wanted to prevent unscanned container images from being pulled into AKS after developers pushed new builds to Azure Container Registry.
The security engineering team enabled the registry’s quarantine policy in its controlled ACR environment and connected the image workflow to vulnerability scanning and release approval. Newly pushed images entered a quarantined state, preventing normal pull operations until the security process marked them safe. Build pipelines recorded image digest, scan result, and approval status before promoting the image to production repositories. AKS deployment stages checked that the image digest was available and not quarantined before rollout. Exceptions required security signoff and were logged with expiration.
They also documented the owner, approval path, validation query, rollback contact, and expected evidence in the release runbook so future operators could repeat the workflow without guessing or reopening the original design debate.
An ACR quarantine policy helps make container promotion safer by keeping newly pushed images out of normal consumption until the trust decision is made.
Scenario, objectives, solution, measured impact, and takeaway.
CobaltWorks, a manufacturing automation firm, was preparing a factory analytics expansion when teams found that ACR quarantine policy was being handled differently across subscriptions and environments.
The cloud architecture team made ACR quarantine policy a named checkpoint in the release process instead of an informal setting. They configured Azure Container Registry with Microsoft Entra permissions, private registry workflows, image digests, build or import automation, replication behavior, and diagnostic logs for image lifecycle evidence. The runbook captured tenant, subscription, resource group or management group scope, required permissions, expected output, exception process, and rollback owner. Pipeline gates and change approvals stopped the rollout until the evidence matched the architecture decision, while operators saved sanitized screenshots or JSON output for later review.
ACR quarantine policy becomes valuable when teams can show where it is configured, who owns it, and what evidence proves it worked.
Scenario, objectives, solution, measured impact, and takeaway.
Juniper Media, a digital media company, needed to reduce recurring Azure incidents during a platform cost and reliability review, and the common weak spot was unclear ownership of ACR quarantine policy.
The operations team redesigned the runbook around ACR quarantine policy so every change had a scope, owner, validation path, and rollback decision. They configured Azure Container Registry with Microsoft Entra permissions, private registry workflows, image digests, build or import automation, replication behavior, and diagnostic logs for image lifecycle evidence. The runbook captured tenant, subscription, resource group or management group scope, required permissions, expected output, exception process, and rollback owner. Pipeline gates and change approvals stopped the rollout until the evidence matched the architecture decision, while operators saved sanitized screenshots or JSON output for later review.
ACR quarantine policy is more than vocabulary; it is a practical operating handle for safer Azure design and support.
CLI rationale for ACR quarantine policy: commands give repeatable evidence, but they do not remove judgment. The current Azure CLI surface is strongest for adjacent registry policy evidence rather than a clear GA quarantine command group, so these commands inspect registry configuration, content-trust state, retention, soft delete, manifests, and repositories around the quarantine decision. Start with read-only inspection, confirm the active tenant and subscription, and prefer JSON output over table output when nested policy, identity, token, manifest, or storage fields matter. The first useful command in this batch is `az acr show --name <registry-name> --query '{sku:sku.name,loginServer:loginServer,policies:policies}'`, but it should be read as part of a workflow rather than a magic fix. The workflow is discover the target, inspect the state, compare it with the design, decide whether the next command is read-only or mutating, run the smallest safe command, and verify the result. If a command returns credentials, SAS tokens, registry passwords, or sensitive object IDs, treat the terminal output as secret evidence. ACR quarantine has historically been a preview/limited feature and current Azure CLI documentation does not present a stable GA quarantine command group. Use these adjacent commands for evidence and verify the current registry security workflow before treating quarantine as enforced.
az acr show --name <registry-name> --query '{sku:sku.name,loginServer:loginServer,policies:policies}'az acr config content-trust show --registry <registry-name>az acr config retention show --registry <registry-name>az acr config soft-delete show --registry <registry-name>az acr manifest list-metadata --registry <registry-name> --name <repository>Architecture context for ACR quarantine policy starts with placement. It belongs to container registry security and supply-chain governance, but operators must treat it carefully because quarantine has been preview-oriented and not the same as a complete Defender for Containers, signing, policy, admission-control, or deployment-gate solution. In a clean design, the team writes down whether the control is tenant-wide, subscription-level, resource-level, data-plane, identity-plane, or artifact-level, because troubleshooting changes dramatically depending on that answer. The next design question is ownership: identity teams usually own entitlement and review controls, platform teams usually own registries and shared storage, application teams own deployment references, and security teams own evidence and guardrails. The third question is lifecycle. Does this setting expire, rotate, replicate, rehydrate, get reviewed, get scanned, or get pinned to a digest? A strong architecture decision captures the normal path, the emergency path, and the audit path. For ACR quarantine policy, the useful evidence set includes registry policy state, scanner integration, image scan result, manifest digest, tag visibility, repository permissions, content trust settings, retention and soft-delete policies, Defender findings, deployment gates, exception approvals, and whether ordinary users can pull the quarantined image. Without that evidence, diagrams and portal labels are not enough to prove the workload is safe.
Security review for ACR quarantine policy starts with blast radius. Decide who can use the control, who can change it, and what is exposed if it is misconfigured. For identity terms, that means package policies, reviewer accountability, group membership, guests, app assignments, and role assignments. For storage terms, it means token scope, account keys, HTTPS-only settings, public access, private endpoints, and whether user delegation or managed identity would reduce risk. For ACR terms, it means admin credentials, repository permissions, image provenance, manifest digests, scan evidence, and deployment trust. The output to inspect includes policies, status, digest, tags, contentTrust, retention, softDelete. A secure implementation avoids shared secrets, broad permissions, stale access, mutable image assumptions, and undocumented exceptions. Any command that exposes credentials or changes access must be treated as a security-impacting operation, not routine exploration.
Cost review for ACR quarantine policy is not only about the price of one service. Identity governance can reduce labor and audit cost but can also overgrant expensive resources if packages and reviews are sloppy. Storage tiering can save money or create retrieval, transaction, minimum-retention, and early deletion costs. Account SAS misuse can enable broad data movement without clear owner accountability. ACR builds, imports, geo-replication, retention, and image storage can add registry, transfer, and operational costs. Inspect fields such as policies, status, digest, tags, contentTrust, retention, softDelete and connect them to chargeback, environment classification, and lifecycle policy. The safe pattern is to tag ownership, document why the value exists, estimate the ongoing effect, and verify after change. Cost surprises usually happen when a term is treated as a technical setting rather than a lifecycle decision.
Reliability review for ACR quarantine policy asks what workload behavior changes when the value changes or drifts. Access governance affects whether users and services can reach the resources they need during normal work or emergency response. Storage tiering affects read availability, archive rehydration, recovery time, and lifecycle automation. ACR operations affect whether workloads can pull the correct image in the correct region at the correct time. The evidence set includes registry policy state, scanner integration, image scan result, manifest digest, tag visibility, repository permissions, content trust settings, retention and soft-delete policies, Defender findings, deployment gates, exception approvals, and whether ordinary users can pull the quarantined image. A reliable design defines expected state, monitors drift, documents rollback, and avoids hidden dependencies on shared passwords, broad SAS tokens, mutable tags, or eventually replicated artifacts. During an incident, the operator should be able to run a read-only command, identify the actual state, and decide whether the problem is access, storage behavior, registry state, image identity, or application code.
Performance review for ACR quarantine policy asks whether the setting changes latency, throughput, deployment speed, or recovery time. Access package and access review decisions can delay work if approvals are slow or reviewers are wrong, but they also prevent emergency cleanup later. Access tiers affect retrieval latency and archive rehydration. Account SAS can make data transfer simple but should still respect network and protocol choices. ACR build, import, geo-replication, manifest selection, and registry policy affect how fast images are created, copied, found, and pulled by regional workloads. Evidence such as policies, status, digest, tags, contentTrust, retention, softDelete helps separate a real performance problem from an access, replication, tiering, or tag mistake. A good runbook records expected timing and tells operators when to wait, when to rehydrate, when to check replication, and when to stop blaming application code.
Operational excellence for ACR quarantine policy means the team can discover, verify, change, and audit the setting without heroics. The runbook should include the owner, normal change path, emergency path, read-only inspection commands, mutating commands, expected output, and rollback verification. It should also state what not to paste into tickets, including SAS tokens, registry passwords, account keys, and raw credential material. For ACR quarantine policy, operators should inspect policies, status, digest, tags, contentTrust, retention, softDelete and save sanitized evidence with timestamps and context. Automation should prefer small, explicit commands over broad scripts that mutate several resources at once. When the command surface is adjacent rather than direct, the runbook should say that plainly and point to the governing Microsoft Entra, storage, ACR, Defender, or Microsoft Graph workflow that completes the operation.