From 54ddc7f7eb8b9a1e2f978ef502444ace8c19f55c Mon Sep 17 00:00:00 2001
From: Elad Ben-Israel <benisrae@amazon.com>
Date: Sun, 2 May 2021 13:31:05 +0300
Subject: [PATCH 1/2] chore(ecr-assets): reference cdk-ecr-deployment in readme

As a possible solution for https://github.com/aws/aws-cdk/issues/12597, refer to the 3rd-party module `cdk-ecr-deployment` which supports deploying image assets to a specific ECR repository.
---
 packages/@aws-cdk/aws-ecr-assets/README.md | 32 ++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/packages/@aws-cdk/aws-ecr-assets/README.md b/packages/@aws-cdk/aws-ecr-assets/README.md
index a08ed95a9d676..186a8efb51218 100644
--- a/packages/@aws-cdk/aws-ecr-assets/README.md
+++ b/packages/@aws-cdk/aws-ecr-assets/README.md
@@ -69,6 +69,38 @@ const asset = new DockerImageAsset(this, 'MyBuildImage', {
 })
 ```
 
+## Publishing images to ECR repositories
+
+`DockerImageAsset` is designed for seamless build & consumption of image assets by CDK code deployed to multiple environments
+through the CDK CLI or through CI/CD workflows. To that end, the ECR repository behind this construct is controlled by the AWS CDK.
+The mechanics of where these images are published and how are intentionally kept as an implementation detail, and the construct
+does not support customizations such as specifying the ECR repository name or tags.
+
+If you are looking for a way to _publish_ image assets to an ECR repository in your control, you should consider using
+[wchaws/cdk-ecr-deployment], which is able to replicate an image asset from the CDK-controlled ECR repository to a repository of
+your choice.
+
+Here an example from the [wchaws/cdk-ecr-deployment] project:
+
+```ts
+import * as ecrdeploy from 'cdk-ecr-deployment';
+
+const image = new DockerImageAsset(this, 'CDKDockerImage', {
+  directory: path.join(__dirname, 'docker'),
+});
+
+new ecrdeploy.ECRDeployment(this, 'DeployDockerImage', {
+  src: new ecrdeploy.DockerImageName(image.imageUri),
+  dest: new ecrdeploy.DockerImageName(`${cdk.Aws.ACCOUNT_ID}.dkr.ecr.us-west-2.amazonaws.com/test:nginx`),
+});
+```
+
+⚠️ Please note in mind that this is a 3rd-party construct library and is not officially supported by AWS.
+You are welcome to +1 [this GitHub issue](https://github.com/aws/aws-cdk/issues/12597) if you would like to see
+native support for this use-case in the AWS CDK.
+
+[wchaws/cdk-ecr-deployment]: https://github.com/wchaws/cdk-ecr-deployment
+
 ## Pull Permissions
 
 Depending on the consumer of your image asset, you will need to make sure

From 51158f48b159fc35239b6a7f3121b7f1a7dead98 Mon Sep 17 00:00:00 2001
From: Elad Ben-Israel <benisrae@amazon.com>
Date: Sun, 2 May 2021 17:51:02 +0300
Subject: [PATCH 2/2] Update packages/@aws-cdk/aws-ecr-assets/README.md

---
 packages/@aws-cdk/aws-ecr-assets/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/@aws-cdk/aws-ecr-assets/README.md b/packages/@aws-cdk/aws-ecr-assets/README.md
index 186a8efb51218..a2d7ff50d8773 100644
--- a/packages/@aws-cdk/aws-ecr-assets/README.md
+++ b/packages/@aws-cdk/aws-ecr-assets/README.md
@@ -95,7 +95,7 @@ new ecrdeploy.ECRDeployment(this, 'DeployDockerImage', {
 });
 ```
 
-⚠️ Please note in mind that this is a 3rd-party construct library and is not officially supported by AWS.
+⚠️ Please note that this is a 3rd-party construct library and is not officially supported by AWS.
 You are welcome to +1 [this GitHub issue](https://github.com/aws/aws-cdk/issues/12597) if you would like to see
 native support for this use-case in the AWS CDK.