aws-cdk.aws-ecr
The CDK Construct Library for AWS::ECR
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- 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.
- 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 · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions.
last release 2023-06-19 (1152 days) · last repo commit 2026-08-14 · 12,868 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 171,314 downloads/mo, #10,373 on PyPI
Alternatives
Verify before relying
pip install aws-cdk.aws-ecr
import aws_cdk.aws_ecr as ecr
repository = ecr.Repository(self, "Repository", image_scan_on_push=True)- 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.
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 on this page. Verify before relying on it.
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
aws-cdk-aws-ecr on PyPI
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.
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.
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)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 the current Python release ~=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 8 packagesaws-cdk.aws-eventsaws-cdk.aws-iamaws-cdk.aws-kmsaws-cdk.coreconstructsjsiipublicationtypeguard |
| Maintenance | Actively maintained 1,152 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 171,314 / month, #10,373 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 7 - InactiveFramework :: AWS CDKFramework :: AWS CDK :: 1Intended Audience :: DevelopersLicense :: OSI ApprovedOperating System :: OS IndependentProgramming Language :: JavaScriptProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Typing :: Typed |
Evidence: aws_cdk.aws_ecr-1.204.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “aws cdk ecr repository”
- aws-cdk.aws-ecrProvides AWS CDK constructs for defining, configuring, and managing…
- aws-cdk.aws-ecr-assetsBundles Docker images as AWS CDK assets, building from Dockerfiles or…
- aws-cdk.aws-apprunner-alphaProvides AWS CDK constructs for deploying containerized applications…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also aws-cdk.aws-apprunner-alpha · aws-cdk.aws-dynamodb · cdk-ecr-deployment · aws-cdk.aws-ecr-assets · aws-cdk.aws-codecommit · aws-cdk.aws-s3tables-alpha · aws-cdk.aws-efs · aws-cdk.aws-secretsmanager · aws-cdk.aws-sqs · aws-cdk.aws-kms