Skip to content

Commit 5b79c51

Browse files
authored
docs(ecr-assets): add link to AppStagingSynthesizer in ECR Assets documentation (#28818)
This will help more people discover the App Staging Synthesizer. One of the most common use-cases that drives me to App Staging Synthesizer is the desire for separate ECR repositories for CDK-managed docker image assets. ---- *By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*
1 parent 1b69f2a commit 5b79c51

File tree

1 file changed

+8
-1
lines changed

1 file changed

+8
-1
lines changed

packages/aws-cdk-lib/aws-ecr-assets/README.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -162,7 +162,14 @@ through the CDK CLI or through CI/CD workflows. To that end, the ECR repository
162162
The mechanics of where these images are published and how are intentionally kept as an implementation detail, and the construct
163163
does not support customizations such as specifying the ECR repository name or tags.
164164

165-
If you are looking for a way to _publish_ image assets to an ECR repository in your control, you should consider using
165+
We are testing a new experimental synthesizer, the
166+
[App Staging Synthesizer](https://docs.aws.amazon.com/cdk/api/v2/docs/app-staging-synthesizer-alpha-readme.html) that
167+
creates separate support stacks for each CDK application. Unlike the default stack synthesizer, the App Staging
168+
Synthesizer creates unique ECR repositories for each `DockerImageAsset`, allowing lifecycle policies to only retain the
169+
last `n` images. This is a great way to keep your ECR repositories clean and reduce cost. You can learn more about
170+
this feature in [this blog post](https://aws.amazon.com/blogs/devops/enhancing-resource-isolation-in-aws-cdk-with-the-app-staging-synthesizer/).
171+
172+
Alternatively, If you are looking for a way to _publish_ image assets to an ECR repository in your control, you should consider using
166173
[cdklabs/cdk-ecr-deployment], which is able to replicate an image asset from the CDK-controlled ECR repository to a repository of
167174
your choice.
168175

0 commit comments

Comments
 (0)