Cdklabs.CdkDockerImageDeployment
0.0.1038
dotnet add package Cdklabs.CdkDockerImageDeployment --version 0.0.1038
NuGet\Install-Package Cdklabs.CdkDockerImageDeployment -Version 0.0.1038
<PackageReference Include="Cdklabs.CdkDockerImageDeployment" Version="0.0.1038" />
<PackageVersion Include="Cdklabs.CdkDockerImageDeployment" Version="0.0.1038" />
<PackageReference Include="Cdklabs.CdkDockerImageDeployment" />
paket add Cdklabs.CdkDockerImageDeployment --version 0.0.1038
#r "nuget: Cdklabs.CdkDockerImageDeployment, 0.0.1038"
#:package Cdklabs.CdkDockerImageDeployment@0.0.1038
#addin nuget:?package=Cdklabs.CdkDockerImageDeployment&version=0.0.1038
#tool nuget:?package=Cdklabs.CdkDockerImageDeployment&version=0.0.1038
CDK Docker Image Deployment
This module allows you to copy docker image assets to a repository you control. This can be necessary if you want to build a Docker image in one CDK app and consume it in a different app or outside the CDK, or if you want to apply a lifecycle policy to all images of a part of your application.
Getting Started
Below is a basic example for how to use the DockerImageDeployment API:
import * as ecr from 'aws-cdk-lib/aws-ecr';
import * as imagedeploy from 'cdk-docker-image-deployment';
const repo = ecr.Repository.fromRepositoryName(this, 'MyRepository', 'myrepository');
new imagedeploy.DockerImageDeployment(this, 'ExampleImageDeploymentWithTag', {
source: imagedeploy.Source.directory('path/to/directory'),
destination: imagedeploy.Destination.ecr(repo, {
tag: 'myspecialtag',
}),
});
Currently Supported Sources
Source.directory(): Supply a path to a local docker image as source.
Don't see a source listed? See if there is an open issue or PR already. If not, please open an issue asking for it or better yet, submit a contribution!
Currently Supported Destinations
Destination.ecr(repo, options): Send your docker image to an ECR repository in your stack's account.
Don't see a destination listed? See if there is an open issue or PR already. If not, please open an issue asking for it or better yet, submit a contribution!
Under the Hood
- When this stack is deployed (either via cdk deploy or via CI/CD), the contents of the local Docker image will be archived and uploaded to an intermediary assets ECR Repository using the cdk-assets mechanism.
- The
DockerImageDeploymentconstruct synthesizes a CodeBuild Project which uses docker to pull the image from the intermediary repository, tag the image if a tag is provided, and push the image to the destination repository. - The deployment will wait until the CodeBuild Project completes successfully before finishing.
The architecture of this construct can be seen here:

Security
See CONTRIBUTING for more information.
License
This project is licensed under the Apache-2.0 License.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net6.0 is compatible. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net6.0
- Amazon.CDK.Lib (>= 2.24.0 && < 3.0.0)
- Amazon.JSII.Runtime (>= 1.141.0 && < 2.0.0)
- Constructs (>= 10.5.1 && < 11.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 0.0.1038 | 85 | 10/19/2026 |
| 0.0.1037 | 95 | 10/12/2026 |
| 0.0.1036 | 110 | 10/5/2026 |
| 0.0.1035 | 117 | 9/28/2026 |
| 0.0.1034 | 217 | 9/9/2026 |
| 0.0.1033 | 123 | 9/8/2026 |
| 0.0.1032 | 132 | 9/7/2026 |
| 0.0.1031 | 123 | 9/6/2026 |
| 0.0.1030 | 131 | 9/5/2026 |
| 0.0.1029 | 126 | 9/4/2026 |
| 0.0.1028 | 121 | 9/3/2026 |
| 0.0.1027 | 114 | 9/2/2026 |
| 0.0.1026 | 123 | 9/1/2026 |
| 0.0.1025 | 133 | 8/31/2026 |
| 0.0.1024 | 124 | 8/30/2026 |
| 0.0.1023 | 126 | 8/29/2026 |
| 0.0.1022 | 125 | 8/28/2026 |
| 0.0.1021 | 131 | 8/27/2026 |
| 0.0.1020 | 128 | 8/26/2026 |
| 0.0.1019 | 123 | 8/25/2026 |