@aws-cdk/assets-docker
Advanced tools
This module allows bundling Docker images as assets.
Images are built from a local Docker context directory (with a Dockerfile),
uploaded to ECR by the CDK toolkit and/or your app's CI-CD pipeline, and can be
naturally referenced in your CDK app.
import { DockerImageAsset } from '@aws-cdk/assets-docker';
const asset = new DockerImageAsset(this, 'MyBuildImage', {
directory: path.join(__dirname, 'my-image')
});
The directory my-image must include a Dockerfile.
This will instruct the toolkit to build a Docker image from my-image, push it
to an AWS ECR repository and wire the name of the repository as CloudFormation
parameters to your stack.
Use asset.imageUri can be used to reference the image (it includes both the
ECR image URL and tag.
Depending on the consumer of your image asset, you will need to make sure the principal has permissions to pull the image.
In most cases, you should use the asset.repository.grantPull(principal)
method. This will modify the IAM policy of the principal to allow it to
pull images from this repository.
If the pulling principal is not in the same account or is an AWS service that
doesn't assume a role in your account (e.g. AWS CodeBuild), pull permissions
must be granted on the resource policy (and not on the principal's policy).
To do that, you can use asset.repository.addToResourcePolicy(statement) to
grant the desired principal the following permissions: "ecr:GetDownloadUrlForLayer",
"ecr:BatchGetImage" and "ecr:BatchCheckLayerAvailability".
0.25.0 (2019-02-28)
construct.node.stack attribute (#1753) (a46cfd8), closes #798CloudTrail.addS3EventSelector accepts an options
object instead of only a ReadWriteType value.codedeploy.amazonaws.com)
yourself.parameter.valueAsString =>
parameter.stringValue, rename parameter.valueAsList =>
parameter.stringListValue, rename ssmParameter.parameterValue =>
ssmParameter.stringValue or ssmParameter.stringListValue depending
on type, rename secretString.value => secretString.stringValue,
rename secret.toSecretString() =>secret.secretStringStack.find(c) and Stack.tryFind(c) were
replaced by c.node.stack.partitionKey is now a required property when defining a
dynamodb.Table. The addPartitionKey and addSortKey methods have been removed.myConstruct.apply( ... ) to
myConstruct.node.apply( ... ).toCodePipelineAction.AutoScalingGroup, renamed minSize =>
minCapacity, maxSize => maxCapacity, for consistency with
desiredCapacity and also Application AutoScaling.
For ECS's addDefaultAutoScalingGroupCapacity(), instanceCount =>
desiredCapacity and the function now takes an ID (pass
"DefaultAutoScalingGroup" to avoid interruption to your deployments).FAQs
deprecated: moved to @aws-cdk/aws-ecr-assets
The npm package @aws-cdk/assets-docker receives a total of 54 weekly downloads. As such, @aws-cdk/assets-docker popularity was classified as not popular.
We found that @aws-cdk/assets-docker demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 5 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket is tracking a new trend where malicious actors are now exploiting the popularity of LLM research to spread malware through seemingly useful open source packages.
Security News
Research
Noxia, a new dark web bulletproof host, offers dirt cheap servers for Python, Node.js, Go, and Rust, enabling cybercriminals to distribute malware and execute supply chain attacks.
Company News
Socket safeguards companies from software supply chain attacks by detecting and preventing threats in open source code and empowering developers to secure their applications and critical services against malware and other security risks.