Amazon ECR stores container images in repositories. Private repositories use IAM and repository permissions; public repositories allow anyone to pull images.
Repositories and image tags
Amazon ECR stores container images in repositories. A registryA collection of container-image repositories associated with an account. is the collection of repositories for an account. An image tagA name used to select a container image from a repository. is a name used to select an image; an image digestThe SHA-256 content identifier of an image manifest. is the SHA-256 content identifier of its manifestThe image description identified by its digest and used when retrieving a container image., the image description used to retrieve it.
How it works
- Use a private repositoryA named storage location for container images and compatible artifacts. for controlled image access. Authenticate the Docker client before private pushes or pulls.
- Push an image with a tag and choose the repository’s tag mutability setting. Mutability determines whether a later push can reuse that tag for different content.
- Pull by tag for a named reference or by digest for a specific manifest.
| Setting | Tags that can be overwritten |
|---|---|
MUTABLE |
All tags; default when omitted in CreateRepository |
IMMUTABLE |
No tags |
Exam cues
- If the question says release tags must never move, think
IMMUTABLE, because it rejects overwriting an existing tag. - If the question says pull a specific image manifest, think image digest, because it identifies the manifest by its SHA-256 digest.
Remember
-
With basic scanning, configure scan-on-push filters for automatic scans. Unmatched repositories require manual scans.
-
CreateRepository defaults to
MUTABLE. -
Reusing an immutable tag returns
ImageTagAlreadyExistsException.
Trap: A mutable tag can be overwritten. Use an immutable tag to prevent reuse, or pull by digest to select a specific manifest.
From the AWS docs (9)
- An ECR private registry contains private image repositories; each AWS account has a default private registry.
- An ECR repository stores Docker images, OCI images and compatible artifacts.
- A private ECR image can be pulled using a tag or an image digest.
- An ECR image digest is the SHA-256 digest of the image manifest.
- ECR CreateRepository defaults imageTagMutability to MUTABLE when omitted, allowing tag overwrites.
- IMMUTABLE prevents overwriting image tags; a push using an existing immutable tag returns ImageTagAlreadyExistsException.
- AWS documented tag immutability exclusion patterns in July 2025.
- Private ECR push and pull operations require Docker client authentication and IAM permissions.
- With Amazon ECR basic scanning, only repositories matched by scan-on-push filters scan newly pushed images automatically; unmatched repositories require a manual scan.
Flashcards
Nothing to review here right now. Pick other topics or another filter.
·
All 2 cards as a list
A team must prevent release tags in an ECR repository from being overwritten. Which setting should it use?
Set image tag mutability to IMMUTABLE. Pushes that reuse existing tags fail with ImageTagAlreadyExistsException. Pull by digest when an exact image manifest is required.
A team pushes images to an Amazon ECR repository using basic scanning, but the repository matches no scan-on-push filter. Are the images scanned automatically?
No. The repository uses manual scanning until it matches a scan-on-push filter.