From d3c3449173c74db0b61935e213636d88bf13ce26 Mon Sep 17 00:00:00 2001 From: Harsh Mishra Date: Tue, 17 Mar 2026 22:59:42 +0530 Subject: [PATCH 1/2] Add README and fix license file --- LICENCE => LICENSE | 0 README.md | 31 +++++++++++++++++++++++++++++++ 2 files changed, 31 insertions(+) rename LICENCE => LICENSE (100%) create mode 100644 README.md diff --git a/LICENCE b/LICENSE similarity index 100% rename from LICENCE rename to LICENSE diff --git a/README.md b/README.md new file mode 100644 index 0000000..8c806e4 --- /dev/null +++ b/README.md @@ -0,0 +1,31 @@ +# LocalStack CodePipeline Samples + +This repository contains two sample applications that demonstrate LocalStack's CodePipeline emulation with CodeBuild, S3, and CodeArtifact workflows. + +## LocalStack CodePipeline Notes + +LocalStack emulates a practical subset of AWS CodePipeline behavior for local development and testing. Before running these samples, review the current CodePipeline limitations: + +- https://docs.localstack.cloud/aws/services/codepipeline/#limitations + +## Prerequisites + +- A valid [LocalStack for AWS license](https://localstack.cloud/pricing), which provides a [`LOCALSTACK_AUTH_TOKEN`](https://docs.localstack.cloud/getting-started/auth-token/) required to run these samples. +- [Docker](https://docs.docker.com/get-docker/) with access to the Docker socket. +- [LocalStack CLI](https://docs.localstack.cloud/user-guide/tools/localstack-cli/) (`awslocal`) and AWS CLI. +- A GitHub Personal Access Token exported as `CODEPIPELINE_GH_TOKEN` (used by both samples to download source archives). +- `npm` (required for the CodeArtifact publishing sample). + +```bash +export LOCALSTACK_AUTH_TOKEN= +export CODEPIPELINE_GH_TOKEN= +``` + +## Samples + +- [1-codebuild-compile-s3-upload](1-codebuild-compile-s3-upload/README.md): Builds `fzf` with CodeBuild and uploads the resulting binary to S3 through CodePipeline. +- [2-codebuild-test-codeartifact-publish](2-codebuild-test-codeartifact-publish/README.md): Tests a `lodash` fork and publishes the package to CodeArtifact through CodePipeline. + +## License + +Licensed under the Apache License 2.0. See [LICENSE](LICENSE). From 917aeb4f7257e74124debb7778bd2c36d1f17275 Mon Sep 17 00:00:00 2001 From: Harsh Mishra Date: Tue, 17 Mar 2026 23:02:49 +0530 Subject: [PATCH 2/2] Enhance README with documentation link and cleanup Updated README to include a link to LocalStack's CodePipeline documentation and removed notes section. --- README.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) diff --git a/README.md b/README.md index 8c806e4..8c7acd6 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,6 @@ # LocalStack CodePipeline Samples -This repository contains two sample applications that demonstrate LocalStack's CodePipeline emulation with CodeBuild, S3, and CodeArtifact workflows. - -## LocalStack CodePipeline Notes - -LocalStack emulates a practical subset of AWS CodePipeline behavior for local development and testing. Before running these samples, review the current CodePipeline limitations: - -- https://docs.localstack.cloud/aws/services/codepipeline/#limitations +This repository contains two sample applications that demonstrate [LocalStack's CodePipeline emulation](https://docs.localstack.cloud/aws/services/codepipeline) with CodeBuild, S3, and CodeArtifact workflows. ## Prerequisites