---
id: aws-cdk-aws-ecr
version: "1.204.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aws-cdk.aws-ecr — The CDK Construct Library for AWS::ECR

License: permissive · Maintenance: active · Downloads: 171.3K/mo

## What it is and what it does

This package provides Python constructs for AWS CDK v1 that let you define Amazon ECR repositories and configure their behavior declaratively. It abstracts the low-level CloudFormation resources into higher-level objects, so you can create repositories, enable image scanning on push, set tag immutability, configure encryption with KMS keys, and define lifecycle rules to clean up old images—all in Python code alongside the rest of your infrastructure.

The package depends on aws-cdk.core, constructs, jsii, and several other AWS CDK modules to integrate ECR management into a broader CDK application. It supports Python 3.7 through 3.11 and is typed. However, AWS CDK v1 reached end-of-support on 2023-06-01 and is no longer receiving updates; new projects should use AWS CDK v2 instead.

Use it for:

- Define ECR repositories in a CDK stack and automatically enable image scanning on push to catch vulnerabilities.
- Set up lifecycle rules to automatically delete untagged or old images, reducing storage costs and clutter.
- Configure KMS encryption for ECR repositories using either AWS-managed or customer-managed keys.
- Grant IAM users permission to retrieve authorization tokens for Docker CLI authentication to ECR.
- Set tag immutability on repositories to prevent accidental overwrites of production image tags.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides AWS CDK constructs for defining, configuring, and managing Amazon Elastic Container Registry repositories and related resources as infrastructure code.

No—not for new projects. This is AWS CDK v1, which reached end-of-support on 2023-06-01 and is no longer being updated. AWS recommends migrating to AWS CDK v2. Install only if you are maintaining an existing CDK v1 codebase and need ECR constructs; otherwise, use the v2 equivalent.

## Install

pip install aws-cdk-aws-ecr
uv add aws-cdk-aws-ecr
poetry add aws-cdk-aws-ecr

## Installing aws-cdk.aws-ecr

Before you install: Low install friction with a wheel distribution. Maintenance status is active, though the package is part of AWS CDK v1, which reached end-of-support on 2023-06-01 and is no longer being updated; migration to AWS CDK v2 is recommended.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.

Quickstart:

pip install aws-cdk.aws-ecr

import aws_cdk.aws_ecr as ecr

repository = ecr.Repository(self, "Repository", image_scan_on_push=True)

Requires AWS CDK v1 runtime dependencies (aws-cdk.core, constructs, jsii, and others); AWS CDK v1 is end-of-support as of 2023-06-01.

Verify before relying:

- Whether existing AWS CDK v1 projects can coexist with v2 in the same environment without conflicts.
- Performance impact of enabling image_scan_on_push on repository creation and push operations.
- Exact KMS key permissions required when using customer-managed encryption keys.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 171.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

aws cdk ecr repository, container registry infrastructure code, ecr construct library, aws ecr lifecycle rules, ecr image scanning automation, container image repository management, aws cdk docker registry, aws-cdk, infrastructure-as-code, end-of-support

[View on SkillFed](https://skillfed.io/packages/aws-cdk-aws-ecr) · [View on PyPI](https://pypi.org/project/aws-cdk-aws-ecr/)