---
id: cdk-ecr-deployment
version: "4.2.49"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# cdk-ecr-deployment — CDK construct to deploy docker image to Amazon ECR

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

## 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 above — 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

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

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

## Tags

docker image deployment ecr, cdk ecr image copy, docker registry synchronization, multi-architecture image deployment, ecr image transfer construct, docker image asset to ecr, container registry sync, aws-cdk, container-deployment, infrastructure-as-code

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