cdk-ecr-deployment

What it is and what it does

cdk-ecr-deployment is a CDK construct library that automates the deployment of Docker images to Amazon ECR and other registries. It wraps the container image transport layer used by Skopeo to enable image copying directly from CDK code, supporting sources like local Docker image assets, public registries, private registries (with credential management via AWS Secrets Manager), and S3 archives. The construct handles multi-architecture image indexes and can deploy to both private and public ECR repositories.

The package is designed for infrastructure-as-code workflows where Docker image deployment is part of a larger CDK stack. It abstracts away the complexity of registry authentication, image transport, and manifest handling, allowing developers to express image deployment as a declarative construct. The library relies on aws-cdk-lib, constructs, jsii, and publication for its core functionality.

Use it for:

• Deploy a locally-built Docker image asset from CDK to a private ECR repository during stack synthesis.
• Mirror a public container image (e.g., nginx) from Docker Hub to a private ECR for air-gapped or compliance-controlled environments.
• Copy multi-architecture images with per-architecture tags to support both amd64 and arm64 deployments.
• Restore a Docker image from an S3-stored tarball archive into ECR as part of disaster recovery or migration workflows.
• Publish a private ECR image to AWS public ECR with automatic IAM permission attachment.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A CDK construct that copies Docker images between registries (ECR, external registries, or from S3 archives), including support for multi-architecture image indexes.

Yes. The package is actively maintained, has low install friction, carries a permissive license, and solves a concrete problem in CDK-based infrastructure workflows. It is production-stable (Development Status 5) with no known vulnerabilities. Install it if you need to automate Docker image deployment within AWS CDK stacks.

Install

cdk-ecr-deployment on PyPI

pip install cdk-ecr-deployment

uv add cdk-ecr-deployment

poetry add cdk-ecr-deployment

Installing cdk-ecr-deployment

Before you install

Low install friction with a pure Python wheel. Actively maintained as of 2026-08-14 with 190 repository stars. Requires aws-cdk-lib, constructs, jsii, and publication as runtime dependencies.

License in practice

Licensed under Apache-2.0 (permissive), allowing use in commercial and private projects with minimal restrictions beyond attribution and liability disclaimers.

Quickstart

from cdk_ecr_deployment import ECRDeployment, DockerImageName

ECRDeployment(self, "DeployImage",
    src=DockerImageName("nginx:latest"),
    dest=DockerImageName(f"{account_id}.dkr.ecr.us-west-2.amazonaws.com/my-nginx:latest")
)

Requires Python 3.10 or later and an active AWS CDK environment with appropriate IAM permissions for ECR operations.

Verify before relying

• Whether the package handles image layer caching or optimization during copy operations.
• Performance characteristics when copying large or multi-architecture images.
• Whether retry logic and timeout configuration are user-configurable.

Package facts

Evidence: cdk_ecr_deployment-4.2.49-py3-none-any.whl

Tags

More Build Tools packages