From 37d89e083dde94c79865a285d5d511792685c90e Mon Sep 17 00:00:00 2001
From: Rico Hermans <rix0rrr@gmail.com>
Date: Mon, 18 Sep 2023 19:16:33 +0200
Subject: [PATCH] chore(cli-integ): explain how to stage in CodeArtifact
 (#27182)

----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*
---
 packages/@aws-cdk-testing/cli-integ/README.md | 22 +++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/packages/@aws-cdk-testing/cli-integ/README.md b/packages/@aws-cdk-testing/cli-integ/README.md
index 5d1f8e17cd62f..811df31f4ca77 100644
--- a/packages/@aws-cdk-testing/cli-integ/README.md
+++ b/packages/@aws-cdk-testing/cli-integ/README.md
@@ -56,6 +56,28 @@ To run a specific test, add `-t` and a substring of the test name. For example:
 bin/run-suite -a cli-integ-tests -t 'load old assemblies'
 ```
 
+### Running a test suite against binaries
+
+Some test suites require package binaries stages in CodeArtifact repositories to run. This requires you to do a full build, then create a CodeArtifact repository in your own account, uploading the packages there, and then running the tests in a shell configured to have NPM, Pip, Maven etc look for those packages in CodeArtifact.
+
+```shell
+# Build and pack all of CDK (will take ~an hour)
+$ ./build.sh
+$ ./pack.sh
+
+# Use publib to upload to CodeArtifact
+$ npm install -g publib-ca
+$ publib-ca create
+$ publib-ca publish /path/to/dist
+
+# Run the tests against those repositories (may need to substitute 0.0.0 w/ local number)
+$ source ~/.publib-ca/usage/activate.bash
+$ bin/run-suite --use-cli-release=0.0.0 <SUITE_NAME>
+
+# Clean up
+$ publib-ca delete
+```
+
 ## Tools
 
 There are a number of tools in the `bin/` directory. They are: