projen-pipelines 0.0.61 → 0.0.63

package/.jsii

@@ -11,7 +11,7 @@
     "pipelines-release": "lib/release.js"
   },
   "bundled": {
-    "standard-version": "^9.5.0"
+    "standard-version": "^9"
   },
   "dependencies": {
     "constructs": "^10.3.0",
@@ -88,7 +88,7 @@
     "stability": "stable"
   },
   "homepage": "https://github.com/taimos/projen-pipelines.git",
-  "jsiiVersion": "1.98.0 (build 00b106d)",
+  "jsiiVersion": "5.4.18 (build db6e7f8)",
   "keywords": [
     "aws",
     "cdk"
@@ -104,7 +104,7 @@
   },
   "name": "projen-pipelines",
   "readme": {
-    "markdown": "# Projen Pipelines\n\n[![npm version](https://badge.fury.io/js/projen-pipelines.svg)](https://www.npmjs.com/package/projen-pipelines)\n\n\nProjen Pipelines is a projen library that provides high-level abstractions for defining continuous delivery (CD) pipelines for AWS CDK applications.\nIt is specifically designed to work with the projen project configuration engine.\n\nThis library provides high-level abstractions for defining multi-environment and multi-account AWS CDK applications with ease.\nWith this library, you can handle complex deployment scenarios with less code and manage your AWS infrastructure in a more efficient and straightforward way.\n## How Projen Pipelines work\n![High level Projen Pipelines Overview](documentation/overview.png)\nUnder the hood, after you defined the pipeline and selected target engine that you want to work on, we are using code generation methods that will create - in your project - the required CI/CD pipeline.\n\nWe are considering to allow selecting multiple engines going forward - please let us know if this is a feature you would use or not!\n\n## Getting Started\n\n### Installation\n\nTo install the package, add the package `projen-pipelines` to your projects devDeps in your projen configuration file.\n\nAfter installing the package, you can import and use the constructs to define your CDK Pipelines.\n\nYou will also have to setup an IAM role that can be used by GitHub Actions. You can find a tutorial on how set this up here: [Configuring OpenID Connect in Amazon Web Services](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-amazon-web-services)\n\n### Usage\n\nYou can start using the constructs provided by Projen Pipelines in your AWS CDK applications. Here's a brief example:\n\n```typescript\nimport { awscdk } from 'projen';\nimport { GithubCDKPipeline } from 'projen-pipelines';\n\n// Define your AWS CDK TypeScript App\nconst app = new awscdk.AwsCdkTypeScriptApp({\n  cdkVersion: '2.80.0',\n  name: 'my-awesome-app',\n  defaultReleaseBranch: 'main',\n  devDeps: [\n    'projen-pipelines',\n  ],\n});\n\nproject.package.addPackageResolutions('projen');\n\n// Create the pipeline\nnew GithubCDKPipeline(app, {\n  stackPrefix: 'MyApp',\n  iamRoleArns: {\n    default: 'arn:aws:iam::123456789012:role/GithubDeploymentRole',\n  },\n  pkgNamespace: '@company-assemblies',\n  useGithubPackagesForAssembly: true,\n  stages: [\n    {\n      name: 'dev',\n      env: { account: '123456789012', region: 'eu-central-1' },\n    }, {\n      name: 'prod',\n      manualApproval: true,\n      env: {account: '123456789012', region: 'eu-central-1' },\n    }],\n});\n```\n\nAfter running projen (`npx projen`) a new file called `src/app.ts` will be created and contain a specialized CDK App class for your project.\n\nYou can then use this in your `main.ts` to configure your deployment.\n\n```typescript\nimport { PipelineApp } from './app';\nimport { BackendStack } from './stack';\n\nconst app = new PipelineApp({\n  provideDevStack: (scope, id, props) => {\n    return new BackendStack(scope, id, {\n      ...props,\n      apiHostname: 'api-dev',\n      myConfigSetting: 'value-for-dev',\n    });\n  },\n  provideProdStack: (scope, id, props) => {\n    return new BackendStack(scope, id, {\n      ...props,\n      apiHostname: 'api',\n      myConfigSetting: 'value-for-prod',\n    });\n  },\n  providePersonalStack: (scope, id, props) => {\n    return new BackendStack(scope, id, {\n      ...props,\n      apiHostname: `api-${props.stageName}`,\n      myConfigSetting: 'value-for-personal-stage',\n    });\n  },\n});\n\napp.synth();\n```\n\n### Setting Up Trust Relationships Between Accounts\n\nWhen planning to manage multiple staging environments, you will need to establish trust relationships. This process centralizes deployment control, improving operational efficiency and security by consolidating deployment management through a singular, monitored channel. Here is a simplified diagram for the setup:\n\n![Trust relationship](documentation/trust.svg)\n\n#### Step 1: Bootstrapping Each Account\n\nBootstrapping initializes the AWS CDK environment in each account. It prepares the account to work with AWS CDK apps deployed from other accounts. Use the `cdk bootstrap` command for this purpose. Replace `<deployment_account_id>` with the actual AWS account ID of your deployment account.\n\nYou can use the [CloudShell](https://aws.amazon.com/cloudshell/) to bootstrap each staging account:\n\n```bash\ncdk bootstrap --trust <deployment_account_id> --cloudformation-execution-policies \"arn:aws:iam::aws:policy/AdministratorAccess\"\n```\n\n**Note:**\n\nWhile `AdministratorAccess` grants full access to all AWS services and resources, it's not recommended for production environments due to security risks. Instead, create custom IAM policies that grant only the necessary permissions required for deployment operations.\n\n### Deployment\n\nThe `<Engine>CDKPipeline` class creates and adds several tasks to the projen project that then can be used in your pipeline to deploy your application to AWS.\n\nHere's a brief description of each one:\n\n1. **deploy:personal** - This task deploys the application's personal stage, which is a distinct, isolated deployment of the application. The personal stage is intended for personal use, such as testing and development.\n\n2. **watch:personal** - This task deploys the personal stage of the application in watch mode. In this mode, the AWS CDK monitors your application source files for changes, automatically re-synthesizing and deploying when it detects any changes.\n\n3. **diff:personal** - This task compares the deployed personal stage with the current state of the application code. It's used to understand what changes would be made if the application were deployed.\n\n4. **destroy:personal** - This task destroys the resources created for the personal stage of the application.\n\n5. **deploy:feature** - This task deploys the application's feature stage. The feature stage is used for new features testing before these are merged into the main branch.\n\n6. **diff:feature** - This task is similar to `diff:personal`, but for the feature stage.\n\n7. **destroy:feature** - This task destroys the resources created for the feature stage of the application.\n\n8. **deploy:<stageName>** - This task deploys a specific stage of the application (like 'dev' or 'prod').\n\n9. **diff:<stageName>** - This task compares the specified application stage with the current state of the application code.\n\n10. **publish:assets** - This task publishes the CDK assets to all accounts. This is useful when the CDK application uses assets like Docker images or files from the S3 bucket.\n\n11. **bump** - This task bumps the version based on the latest git tag and pushes the updated tag to the git repository.\n\n12. **release:push-assembly** - This task creates a manifest, bumps the version without creating a git tag, and publishes the cloud assembly to your registry.\n\nRemember that these tasks are created and managed automatically by the `CDKPipeline` class. You can run these tasks using the `npx projen TASK_NAME` command.\n\n## Contributing\n### By raising feature requests or issues\nUse the Github integrated \"[Issues](https://github.com/taimos/projen-pipelines/issues/new)\" view to create an item that you would love to have added to our open source project.\n\n***No request is too big or too small*** - get your thoughts created and we'll get back to you if we have questions!\n\n\n### By committing code\n\nWe welcome all contributions to Projen Pipelines! Here's how you can get started:\n\n1. **Fork the Repository**: Click the 'Fork' button at the top right of this page to duplicate this repository in your GitHub account.\n\n2. **Clone your Fork**: Clone the forked repository to your local machine.\n\n```bash\ngit clone https://github.com/<your_username>/projen-pipelines.git\n```\n\n3. **Create a Branch**: To keep your work organized, create a branch for your contribution.\n\n```bash\ngit checkout -b my-branch\n```\n\n4. **Make your Changes**: Make your changes, additions, or fixes to the codebase. Remember to follow the existing code style.\n\n5. **Test your Changes**: Before committing your changes, make sure to test them to ensure they work as expected and do not introduce bugs.\n\n6. **Commit your Changes**: Commit your changes with a descriptive commit message using conventional commit messages.\n\n```bash\ngit commit -m \"feat: Your descriptive commit message\"\n```\n\n7. **Push to your Fork**: Push your commits to the branch in your forked repository.\n\n```bash\ngit push origin my-branch\n```\n\n8. **Submit a Pull Request**: Once your changes are ready to be reviewed, create a pull request from your forked repository's branch into the `main` branch of this repository.\n\nYour pull request will be reviewed and hopefully merged quickly. Thanks for contributing!\n"
+    "markdown": "# Projen Pipelines\n\n[![npm version](https://badge.fury.io/js/projen-pipelines.svg)](https://www.npmjs.com/package/projen-pipelines)\n\n\nProjen Pipelines is a projen library that provides high-level abstractions for defining continuous delivery (CD) pipelines for AWS CDK applications.\nIt is specifically designed to work with the projen project configuration engine.\n\nThis library provides high-level abstractions for defining multi-environment and multi-account AWS CDK applications with ease.\nWith this library, you can handle complex deployment scenarios with less code and manage your AWS infrastructure in a more efficient and straightforward way.\n## How Projen Pipelines work\n![High level Projen Pipelines Overview](documentation/overview.png)\nUnder the hood, after you defined the pipeline and selected target engine that you want to work on, we are using code generation methods that will create - in your project - the required CI/CD pipeline.\n\nWe are considering to allow selecting multiple engines going forward - please let us know if this is a feature you would use or not!\n\n## Getting Started\n\n### Installation\n\nTo install the package, add the package `projen-pipelines` to your projects devDeps in your projen configuration file.\n\nAfter installing the package, you can import and use the constructs to define your CDK Pipelines.\n\nYou will also have to setup an IAM role that can be used by GitHub Actions. You can find a tutorial on how set this up here: [Configuring OpenID Connect in Amazon Web Services](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/configuring-openid-connect-in-amazon-web-services)\n\n### Usage\n\nYou can start using the constructs provided by Projen Pipelines in your AWS CDK applications. Here's a brief example:\n\n```typescript\nimport { awscdk } from 'projen';\nimport { GithubCDKPipeline } from 'projen-pipelines';\n\n// Define your AWS CDK TypeScript App\nconst app = new awscdk.AwsCdkTypeScriptApp({\n  cdkVersion: '2.80.0',\n  name: 'my-awesome-app',\n  defaultReleaseBranch: 'main',\n  devDeps: [\n    'projen-pipelines',\n  ],\n});\n\nproject.package.addPackageResolutions('projen');\n\n// Create the pipeline\nnew GithubCDKPipeline(app, {\n  stackPrefix: 'MyApp',\n  iamRoleArns: {\n    default: 'arn:aws:iam::123456789012:role/GithubDeploymentRole',\n  },\n  pkgNamespace: '@company-assemblies',\n  useGithubPackagesForAssembly: true,\n  stages: [\n    {\n      name: 'dev',\n      env: { account: '123456789012', region: 'eu-central-1' },\n    }, {\n      name: 'prod',\n      manualApproval: true,\n      env: {account: '123456789012', region: 'eu-central-1' },\n    }],\n});\n```\n\nAfter running projen (`npx projen`) a new file called `src/app.ts` will be created and contain a specialized CDK App class for your project.\n\nYou can then use this in your `main.ts` to configure your deployment.\n\n```typescript\nimport { PipelineApp } from './app';\nimport { BackendStack } from './stack';\n\nconst app = new PipelineApp({\n  provideDevStack: (scope, id, props) => {\n    return new BackendStack(scope, id, {\n      ...props,\n      apiHostname: 'api-dev',\n      myConfigSetting: 'value-for-dev',\n    });\n  },\n  provideProdStack: (scope, id, props) => {\n    return new BackendStack(scope, id, {\n      ...props,\n      apiHostname: 'api',\n      myConfigSetting: 'value-for-prod',\n    });\n  },\n  providePersonalStack: (scope, id, props) => {\n    return new BackendStack(scope, id, {\n      ...props,\n      apiHostname: `api-${props.stageName}`,\n      myConfigSetting: 'value-for-personal-stage',\n    });\n  },\n});\n\napp.synth();\n```\n\n### Setting Up Trust Relationships Between Accounts\n\nWhen planning to manage multiple staging environments, you will need to establish trust relationships. This process centralizes deployment control, improving operational efficiency and security by consolidating deployment management through a singular, monitored channel. Here is a simplified diagram for the setup:\n\n![Trust relationship](documentation/trust.svg)\n\n#### Step 1: Bootstrapping Each Account\n\nBootstrapping initializes the AWS CDK environment in each account. It prepares the account to work with AWS CDK apps deployed from other accounts. Use the `cdk bootstrap` command for this purpose. Replace `<deployment_account_id>` with the actual AWS account ID of your deployment account.\n\nYou can use the [CloudShell](https://aws.amazon.com/cloudshell/) to bootstrap each staging account:\n\n```bash\ncdk bootstrap --trust <deployment_account_id> --cloudformation-execution-policies \"arn:aws:iam::aws:policy/AdministratorAccess\"\n```\n\n**Note:**\n\nWhile `AdministratorAccess` grants full access to all AWS services and resources, it's not recommended for production environments due to security risks. Instead, create custom IAM policies that grant only the necessary permissions required for deployment operations.\n\n### Deployment\n\nThe `<Engine>CDKPipeline` class creates and adds several tasks to the projen project that then can be used in your pipeline to deploy your application to AWS.\n\nHere's a brief description of each one:\n\n1. **deploy:personal** - This task deploys the application's personal stage, which is a distinct, isolated deployment of the application. The personal stage is intended for personal use, such as testing and development.\n\n2. **watch:personal** - This task deploys the personal stage of the application in watch mode. In this mode, the AWS CDK monitors your application source files for changes, automatically re-synthesizing and deploying when it detects any changes.\n\n3. **diff:personal** - This task compares the deployed personal stage with the current state of the application code. It's used to understand what changes would be made if the application were deployed.\n\n4. **destroy:personal** - This task destroys the resources created for the personal stage of the application.\n\n5. **deploy:feature** - This task deploys the application's feature stage. The feature stage is used for new features testing before these are merged into the main branch.\n\n6. **diff:feature** - This task is similar to `diff:personal`, but for the feature stage.\n\n7. **destroy:feature** - This task destroys the resources created for the feature stage of the application.\n\n8. **deploy:<stageName>** - This task deploys a specific stage of the application (like 'dev' or 'prod').\n\n9. **diff:<stageName>** - This task compares the specified application stage with the current state of the application code.\n\n10. **publish:assets** - This task publishes the CDK assets to all accounts. This is useful when the CDK application uses assets like Docker images or files from the S3 bucket.\n\n11. **bump** - This task bumps the version based on the latest git tag and pushes the updated tag to the git repository.\n\n12. **release:push-assembly** - This task creates a manifest, bumps the version without creating a git tag, and publishes the cloud assembly to your registry.\n\nRemember that these tasks are created and managed automatically by the `CDKPipeline` class. You can run these tasks using the `npx projen TASK_NAME` command.\n\n## Contributing\n### By raising feature requests or issues\nUse the Github integrated \"[Issues](https://github.com/taimos/projen-pipelines/issues/new)\" view to create an item that you would love to have added to our open source project.\n\n***No request is too big or too small*** - get your thoughts created and we'll get back to you if we have questions!\n\n\n### By committing code\n\nWe welcome all contributions to Projen Pipelines! Here's how you can get started:\n\n1. **Fork the Repository**: Click the 'Fork' button at the top right of this page to duplicate this repository in your GitHub account.\n\n2. **Clone your Fork**: Clone the forked repository to your local machine.\n\n```bash\ngit clone https://github.com/<your_username>/projen-pipelines.git\n```\n\n3. **Create a Branch**: To keep your work organized, create a branch for your contribution.\n\n```bash\ngit checkout -b my-branch\n```\n\n4. **Make your Changes**: Make your changes, additions, or fixes to the codebase. Remember to follow the existing code style.\n\n5. **Test your Changes**: Before committing your changes, make sure to test them to ensure they work as expected and do not introduce bugs.\n\n6. **Commit your Changes**: Commit your changes with a descriptive commit message using conventional commit messages.\n\n```bash\ngit commit -m \"feat: Your descriptive commit message\"\n```\n\n7. **Push to your Fork**: Push your commits to the branch in your forked repository.\n\n```bash\ngit push origin my-branch\n```\n\n8. **Submit a Pull Request**: Once your changes are ready to be reviewed, create a pull request from your forked repository's branch into the `main` branch of this repository.\n\nYour pull request will be reviewed and hopefully merged quickly. Thanks for contributing!\n\n## Known issues\n\n### Environment variable not recognized during `npx projen`\n\nWhen attempting to run `npx projen`, users may encounter an error related to environment variable substitution within configuration files. Specifically, the `${GITHUB_TOKEN}` placeholder fails to be replaced.\n\n#### Solution\n\nTo resolve this issue, prefix the `npx projen` command with the `GITHUB_TOKEN=` environment variable:\n\n```bash\nGITHUB_TOKEN= npx projen\n```\n"
   },
   "repository": {
     "type": "git",
@@ -202,7 +202,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/steps/step.ts",
-        "line": 35
+        "line": 41
       },
       "name": "BashStepConfig",
       "properties": [
@@ -215,7 +215,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/steps/step.ts",
-            "line": 38
+            "line": 44
           },
           "name": "commands",
           "type": {
@@ -246,7 +246,7 @@
         },
         "locationInModule": {
           "filename": "src/awscdk/base.ts",
-          "line": 118
+          "line": 145
         },
         "parameters": [
           {
@@ -266,7 +266,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/awscdk/base.ts",
-        "line": 113
+        "line": 140
       },
       "methods": [
         {
@@ -276,7 +276,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 225
+            "line": 255
           },
           "name": "createApplicationEntrypoint",
           "protected": true
@@ -288,11 +288,34 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 370
+            "line": 413
           },
           "name": "createFeatureStage",
           "protected": true
         },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "This method sets up tasks for the independent stages including deployment and comparing changes (diff)."
+          },
+          "locationInModule": {
+            "filename": "src/awscdk/base.ts",
+            "line": 444
+          },
+          "name": "createIndependentStage",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "- The stage to create."
+              },
+              "name": "stage",
+              "type": {
+                "fqn": "projen-pipelines.IndependentStage"
+              }
+            }
+          ],
+          "protected": true
+        },
         {
           "docs": {
             "stability": "stable",
@@ -300,7 +323,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 350
+            "line": 393
           },
           "name": "createPersonalStage",
           "protected": true
@@ -312,7 +335,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 387
+            "line": 430
           },
           "name": "createPipelineStage",
           "parameters": [
@@ -335,7 +358,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 310
+            "line": 353
           },
           "name": "createReleaseTasks",
           "protected": true
@@ -347,7 +370,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 163
+            "line": 193
           },
           "name": "engineType",
           "returns": {
@@ -362,7 +385,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 199
+            "line": 229
           },
           "name": "getAssetUploadCommands",
           "parameters": [
@@ -391,7 +414,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 397
+            "line": 454
           },
           "name": "getCliStackPattern",
           "parameters": [
@@ -415,7 +438,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 209
+            "line": 239
           },
           "name": "renderDeployCommands",
           "parameters": [
@@ -444,7 +467,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 215
+            "line": 245
           },
           "name": "renderDiffCommands",
           "parameters": [
@@ -473,7 +496,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 165
+            "line": 195
           },
           "name": "renderInstallCommands",
           "protected": true,
@@ -494,7 +517,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 172
+            "line": 202
           },
           "name": "renderInstallPackageCommands",
           "parameters": [
@@ -530,7 +553,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 191
+            "line": 221
           },
           "name": "renderSynthCommands",
           "protected": true,
@@ -555,7 +578,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 116
+            "line": 143
           },
           "name": "branchName",
           "type": {
@@ -569,7 +592,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 115
+            "line": 142
           },
           "name": "stackPrefix",
           "type": {
@@ -582,7 +605,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 118
+            "line": 145
           },
           "name": "app",
           "protected": true,
@@ -605,7 +628,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/awscdk/base.ts",
-        "line": 54
+        "line": 73
       },
       "name": "CDKPipelineOptions",
       "properties": [
@@ -619,7 +642,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 83
+            "line": 102
           },
           "name": "pkgNamespace",
           "type": {
@@ -629,12 +652,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "This field specifies a list of stages that should be deployed using a CI/CD pipeline."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 85
+            "line": 107
           },
           "name": "stages",
           "type": {
@@ -656,7 +680,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 60
+            "line": 79
           },
           "name": "branchName",
           "optional": true,
@@ -675,7 +699,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 76
+            "line": 95
           },
           "name": "deploySubStacks",
           "optional": true,
@@ -686,12 +710,13 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "This specifies details for feature stages."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 89
+            "line": 116
           },
           "name": "featureStages",
           "optional": true,
@@ -702,12 +727,35 @@
         {
           "abstract": true,
           "docs": {
-            "stability": "stable"
+            "stability": "stable",
+            "summary": "This specifies details for independent stages."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 87
+            "line": 110
+          },
+          "name": "independentStages",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "projen-pipelines.IndependentStage"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "This specifies details for a personal stage."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/awscdk/base.ts",
+            "line": 113
           },
           "name": "personalStage",
           "optional": true,
@@ -723,7 +771,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 102
+            "line": 129
           },
           "name": "postSynthCommands",
           "optional": true,
@@ -744,7 +792,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 106
+            "line": 133
           },
           "name": "postSynthSteps",
           "optional": true,
@@ -765,7 +813,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 100
+            "line": 127
           },
           "name": "preInstallCommands",
           "optional": true,
@@ -786,7 +834,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 104
+            "line": 131
           },
           "name": "preInstallSteps",
           "optional": true,
@@ -807,7 +855,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 101
+            "line": 128
           },
           "name": "preSynthCommands",
           "optional": true,
@@ -828,7 +876,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 105
+            "line": 132
           },
           "name": "preSynthSteps",
           "optional": true,
@@ -851,7 +899,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 68
+            "line": 87
           },
           "name": "stackPrefix",
           "optional": true,
@@ -866,13 +914,17 @@
       "assembly": "projen-pipelines",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Options for stages that are part of the pipeline."
       },
       "fqn": "projen-pipelines.DeploymentStage",
+      "interfaces": [
+        "projen-pipelines.NamedStageOptions"
+      ],
       "kind": "interface",
       "locationInModule": {
         "filename": "src/awscdk/base.ts",
-        "line": 38
+        "line": 41
       },
       "name": "DeploymentStage",
       "properties": [
@@ -884,37 +936,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 40
-          },
-          "name": "env",
-          "type": {
-            "fqn": "projen-pipelines.Environment"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/awscdk/base.ts",
-            "line": 39
-          },
-          "name": "name",
-          "type": {
-            "primitive": "string"
-          }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "stability": "stable"
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/awscdk/base.ts",
-            "line": 41
+            "line": 42
           },
           "name": "manualApproval",
           "optional": true,
@@ -993,7 +1015,7 @@
         },
         "locationInModule": {
           "filename": "src/awscdk/github.ts",
-          "line": 64
+          "line": 67
         },
         "parameters": [
           {
@@ -1019,7 +1041,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/awscdk/github.ts",
-        "line": 47
+        "line": 50
       },
       "methods": [
         {
@@ -1029,7 +1051,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/github.ts",
-            "line": 173
+            "line": 169
           },
           "name": "createAssetUpload"
         },
@@ -1040,7 +1062,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/github.ts",
-            "line": 228
+            "line": 217
           },
           "name": "createDeployment",
           "parameters": [
@@ -1055,6 +1077,28 @@
             }
           ]
         },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Creates a job to deploy the CDK application to AWS."
+          },
+          "locationInModule": {
+            "filename": "src/awscdk/github.ts",
+            "line": 324
+          },
+          "name": "createIndependentDeployment",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "- The independent stage to create."
+              },
+              "name": "stage",
+              "type": {
+                "fqn": "projen-pipelines.IndependentStage"
+              }
+            }
+          ]
+        },
         {
           "docs": {
             "stability": "stable",
@@ -1062,7 +1106,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/github.ts",
-            "line": 105
+            "line": 111
           },
           "name": "engineType",
           "overrides": "projen-pipelines.CDKPipeline",
@@ -1083,7 +1127,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/github.ts",
-            "line": 50
+            "line": 53
           },
           "name": "needsVersionedArtifacts",
           "type": {
@@ -1096,7 +1140,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/github.ts",
-            "line": 57
+            "line": 60
           },
           "name": "useGithubPackages",
           "protected": true,
@@ -1121,7 +1165,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/awscdk/github.ts",
-        "line": 27
+        "line": 30
       },
       "name": "GithubCDKPipelineOptions",
       "properties": [
@@ -1134,7 +1178,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/github.ts",
-            "line": 30
+            "line": 33
           },
           "name": "iamRoleArns",
           "type": {
@@ -1151,7 +1195,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/github.ts",
-            "line": 37
+            "line": 40
           },
           "name": "runnerTags",
           "optional": true,
@@ -1174,7 +1218,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/github.ts",
-            "line": 40
+            "line": 43
           },
           "name": "useGithubPackagesForAssembly",
           "optional": true,
@@ -1196,7 +1240,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/awscdk/github.ts",
-        "line": 12
+        "line": 15
       },
       "name": "GithubIamRoleConfig",
       "properties": [
@@ -1209,7 +1253,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/github.ts",
-            "line": 19
+            "line": 22
           },
           "name": "assetPublishing",
           "optional": true,
@@ -1226,7 +1270,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/github.ts",
-            "line": 15
+            "line": 18
           },
           "name": "default",
           "optional": true,
@@ -1243,7 +1287,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/github.ts",
-            "line": 21
+            "line": 24
           },
           "name": "deployment",
           "optional": true,
@@ -1265,7 +1309,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/github.ts",
-            "line": 17
+            "line": 20
           },
           "name": "synth",
           "optional": true,
@@ -1287,10 +1331,31 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/steps/step.ts",
-        "line": 23
+        "line": 26
       },
       "name": "GithubStepConfig",
       "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Additional environment variables to set for this step."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/steps/step.ts",
+            "line": 35
+          },
+          "name": "env",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "map"
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -1300,7 +1365,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/steps/step.ts",
-            "line": 26
+            "line": 29
           },
           "name": "needs",
           "type": {
@@ -1321,7 +1386,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/steps/step.ts",
-            "line": 29
+            "line": 32
           },
           "name": "steps",
           "type": {
@@ -1352,7 +1417,7 @@
         },
         "locationInModule": {
           "filename": "src/awscdk/gitlab.ts",
-          "line": 80
+          "line": 82
         },
         "parameters": [
           {
@@ -1378,7 +1443,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/awscdk/gitlab.ts",
-        "line": 59
+        "line": 61
       },
       "methods": [
         {
@@ -1389,7 +1454,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 211
+            "line": 209
           },
           "name": "createAssetUpload",
           "protected": true
@@ -1402,7 +1467,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 242
+            "line": 244
           },
           "name": "createDeployment",
           "parameters": [
@@ -1418,6 +1483,28 @@
           ],
           "protected": true
         },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Creates a job to deploy the CDK application to AWS."
+          },
+          "locationInModule": {
+            "filename": "src/awscdk/gitlab.ts",
+            "line": 311
+          },
+          "name": "createIndependentDeployment",
+          "parameters": [
+            {
+              "docs": {
+                "summary": "- The independent stage to create."
+              },
+              "name": "stage",
+              "type": {
+                "fqn": "projen-pipelines.IndependentStage"
+              }
+            }
+          ]
+        },
         {
           "docs": {
             "remarks": "This method configures the job to execute CDK synthesis, applying the appropriate IAM role\nfor AWS commands and specifying runner tags for job execution. The synthesized outputs are\nconfigured to be cached as artifacts.",
@@ -1426,7 +1513,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 166
+            "line": 173
           },
           "name": "createSynth",
           "protected": true
@@ -1437,7 +1524,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 294
+            "line": 346
           },
           "name": "engineType",
           "overrides": "projen-pipelines.CDKPipeline",
@@ -1455,7 +1542,7 @@
           },
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 108
+            "line": 114
           },
           "name": "setupSnippets",
           "protected": true
@@ -1471,7 +1558,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 68
+            "line": 70
           },
           "name": "config",
           "type": {
@@ -1487,7 +1574,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 65
+            "line": 67
           },
           "name": "jobImage",
           "type": {
@@ -1503,7 +1590,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 62
+            "line": 64
           },
           "name": "needsVersionedArtifacts",
           "type": {
@@ -1527,7 +1614,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/awscdk/gitlab.ts",
-        "line": 43
+        "line": 45
       },
       "name": "GitlabCDKPipelineOptions",
       "properties": [
@@ -1540,7 +1627,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 45
+            "line": 47
           },
           "name": "iamRoleArns",
           "type": {
@@ -1556,7 +1643,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 49
+            "line": 51
           },
           "name": "image",
           "optional": true,
@@ -1573,7 +1660,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 47
+            "line": 49
           },
           "name": "runnerTags",
           "optional": true,
@@ -1596,7 +1683,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/awscdk/gitlab.ts",
-        "line": 10
+        "line": 12
       },
       "name": "GitlabIamRoleConfig",
       "properties": [
@@ -1609,7 +1696,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 16
+            "line": 18
           },
           "name": "assetPublishing",
           "optional": true,
@@ -1626,7 +1713,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 12
+            "line": 14
           },
           "name": "default",
           "optional": true,
@@ -1643,7 +1730,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 20
+            "line": 22
           },
           "name": "deployment",
           "optional": true,
@@ -1665,7 +1752,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 18
+            "line": 20
           },
           "name": "diff",
           "optional": true,
@@ -1687,7 +1774,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 14
+            "line": 16
           },
           "name": "synth",
           "optional": true,
@@ -1710,7 +1797,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/awscdk/gitlab.ts",
-        "line": 27
+        "line": 29
       },
       "name": "GitlabRunnerTags",
       "properties": [
@@ -1723,7 +1810,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 33
+            "line": 35
           },
           "name": "assetPublishing",
           "optional": true,
@@ -1745,7 +1832,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 29
+            "line": 31
           },
           "name": "default",
           "optional": true,
@@ -1767,7 +1854,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 37
+            "line": 39
           },
           "name": "deployment",
           "optional": true,
@@ -1794,7 +1881,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 35
+            "line": 37
           },
           "name": "diff",
           "optional": true,
@@ -1821,7 +1908,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/gitlab.ts",
-            "line": 31
+            "line": 33
           },
           "name": "synth",
           "optional": true,
@@ -1873,6 +1960,27 @@
             }
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Additional environment variables to set for this step."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/steps/step.ts",
+            "line": 20
+          },
+          "name": "env",
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "map"
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -1918,6 +2026,105 @@
       ],
       "symbolId": "src/steps/step:GitlabStepConfig"
     },
+    "projen-pipelines.IndependentStage": {
+      "assembly": "projen-pipelines",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Options for stages that are not part of the pipeline."
+      },
+      "fqn": "projen-pipelines.IndependentStage",
+      "interfaces": [
+        "projen-pipelines.NamedStageOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/awscdk/base.ts",
+        "line": 48
+      },
+      "name": "IndependentStage",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/awscdk/base.ts",
+            "line": 50
+          },
+          "name": "postDeploySteps",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "projen-pipelines.PipelineStep"
+              },
+              "kind": "array"
+            }
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/awscdk/base.ts",
+            "line": 49
+          },
+          "name": "postDiffSteps",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "fqn": "projen-pipelines.PipelineStep"
+              },
+              "kind": "array"
+            }
+          }
+        }
+      ],
+      "symbolId": "src/awscdk/base:IndependentStage"
+    },
+    "projen-pipelines.NamedStageOptions": {
+      "assembly": "projen-pipelines",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Options for a CDK stage with a name."
+      },
+      "fqn": "projen-pipelines.NamedStageOptions",
+      "interfaces": [
+        "projen-pipelines.StageOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/awscdk/base.ts",
+        "line": 56
+      },
+      "name": "NamedStageOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/awscdk/base.ts",
+            "line": 57
+          },
+          "name": "name",
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/awscdk/base:NamedStageOptions"
+    },
     "projen-pipelines.PipelineEngine": {
       "assembly": "projen-pipelines",
       "docs": {
@@ -1972,7 +2179,7 @@
         },
         "locationInModule": {
           "filename": "src/steps/step.ts",
-          "line": 50
+          "line": 56
         },
         "parameters": [
           {
@@ -1989,19 +2196,18 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/steps/step.ts",
-        "line": 44
+        "line": 50
       },
       "methods": [
         {
-          "abstract": true,
           "docs": {
-            "remarks": "Must be implemented by subclasses.",
+            "remarks": "Should be implemented by subclasses.",
             "stability": "stable",
             "summary": "Generates a configuration for a bash script step."
           },
           "locationInModule": {
             "filename": "src/steps/step.ts",
-            "line": 67
+            "line": 77
           },
           "name": "toBash",
           "returns": {
@@ -2011,15 +2217,14 @@
           }
         },
         {
-          "abstract": true,
           "docs": {
-            "remarks": "Must be implemented by subclasses.",
+            "remarks": "Should be implemented by subclasses.",
             "stability": "stable",
             "summary": "Generates a configuration for a GitHub Actions step."
           },
           "locationInModule": {
             "filename": "src/steps/step.ts",
-            "line": 62
+            "line": 70
           },
           "name": "toGithub",
           "returns": {
@@ -2029,15 +2234,14 @@
           }
         },
         {
-          "abstract": true,
           "docs": {
-            "remarks": "Must be implemented by subclasses.",
+            "remarks": "Should be implemented by subclasses.",
             "stability": "stable",
             "summary": "Generates a configuration for a GitLab CI step."
           },
           "locationInModule": {
             "filename": "src/steps/step.ts",
-            "line": 57
+            "line": 63
           },
           "name": "toGitlab",
           "returns": {
@@ -2056,7 +2260,7 @@
           },
           "locationInModule": {
             "filename": "src/steps/step.ts",
-            "line": 50
+            "line": 56
           },
           "name": "project",
           "protected": true,
@@ -2082,7 +2286,7 @@
         },
         "locationInModule": {
           "filename": "src/steps/step.ts",
-          "line": 80
+          "line": 92
         },
         "parameters": [
           {
@@ -2113,7 +2317,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/steps/step.ts",
-        "line": 73
+        "line": 85
       },
       "methods": [
         {
@@ -2123,7 +2327,7 @@
           },
           "locationInModule": {
             "filename": "src/steps/step.ts",
-            "line": 98
+            "line": 111
           },
           "name": "toBash",
           "overrides": "projen-pipelines.PipelineStep",
@@ -2140,7 +2344,7 @@
           },
           "locationInModule": {
             "filename": "src/steps/step.ts",
-            "line": 107
+            "line": 120
           },
           "name": "toGithub",
           "overrides": "projen-pipelines.PipelineStep",
@@ -2157,7 +2361,7 @@
           },
           "locationInModule": {
             "filename": "src/steps/step.ts",
-            "line": 87
+            "line": 99
           },
           "name": "toGitlab",
           "overrides": "projen-pipelines.PipelineStep",
@@ -2177,7 +2381,7 @@
           },
           "locationInModule": {
             "filename": "src/steps/step.ts",
-            "line": 80
+            "line": 92
           },
           "name": "commands",
           "protected": true,
@@ -2197,13 +2401,14 @@
       "assembly": "projen-pipelines",
       "datatype": true,
       "docs": {
-        "stability": "stable"
+        "stability": "stable",
+        "summary": "Options for a CDK stage like the target environment."
       },
       "fqn": "projen-pipelines.StageOptions",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/awscdk/base.ts",
-        "line": 44
+        "line": 63
       },
       "name": "StageOptions",
       "properties": [
@@ -2215,7 +2420,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/awscdk/base.ts",
-            "line": 45
+            "line": 64
           },
           "name": "env",
           "type": {
@@ -2226,6 +2431,6 @@
       "symbolId": "src/awscdk/base:StageOptions"
     }
   },
-  "version": "0.0.61",
-  "fingerprint": "5VhJlbfD8rWkC8XX001JgTcBR5OpHDa0kQTbamH1Gco="
+  "version": "0.0.63",
+  "fingerprint": "iZ0Oz6yTuqWRnrLhX4ire3pd3/2Vh+Byz0cidSDXSf8="
 }