@cdklabs/cdk-cicd-wrapper 2.3.1 → 2.3.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/.jsii +758 -196
  2. package/API.md +526 -45
  3. package/README.md +11 -0
  4. package/lib/app/DeploymentPipelineApp.js +7 -3
  5. package/lib/app/PipelineApp.js +12 -4
  6. package/lib/appconfig/accessor.js +1 -1
  7. package/lib/config/build-image.d.ts +17 -1
  8. package/lib/config/build-image.js +57 -3
  9. package/lib/config/default-synthesizer-role-arn.d.ts +38 -0
  10. package/lib/config/default-synthesizer-role-arn.js +63 -0
  11. package/lib/config/define.d.ts +50 -1
  12. package/lib/config/define.js +117 -6
  13. package/lib/config/naming.d.ts +7 -2
  14. package/lib/config/naming.js +9 -9
  15. package/lib/config/repository.js +1 -1
  16. package/lib/config/types.d.ts +123 -11
  17. package/lib/config/types.js +6 -2
  18. package/lib/engine/cdkpipelines/CdkPipelinesEngine.d.ts +6 -0
  19. package/lib/engine/cdkpipelines/CdkPipelinesEngine.js +419 -43
  20. package/lib/engine/codepipeline/CodePipelineEngine.d.ts +22 -15
  21. package/lib/engine/codepipeline/CodePipelineEngine.js +681 -127
  22. package/lib/engine/codepipeline/DeploymentPipeline.d.ts +8 -5
  23. package/lib/engine/codepipeline/DeploymentPipeline.js +937 -72
  24. package/lib/engine/external-id-secrets.d.ts +17 -0
  25. package/lib/engine/external-id-secrets.js +53 -0
  26. package/lib/engine/github/GitHubActionsEngine.d.ts +3 -4
  27. package/lib/engine/github/GitHubActionsEngine.js +446 -34
  28. package/lib/index.d.ts +3 -1
  29. package/lib/index.js +6 -2
  30. package/lib/runtime/attach.js +1 -1
  31. package/lib/runtime/inject.d.ts +41 -3
  32. package/lib/runtime/inject.js +259 -22
  33. package/lib/runtime/pipeline-assembler.d.ts +7 -1
  34. package/lib/runtime/pipeline-assembler.js +144 -36
  35. package/lib/runtime/register.js +10 -1
  36. package/lib/support/AccessLogsForBucketAspect.d.ts +14 -8
  37. package/lib/support/AccessLogsForBucketAspect.js +52 -37
  38. package/lib/support/DestroyEncryptionKeysOnDeleteAspect.js +1 -1
  39. package/lib/support/DisablePublicIPAssignmentForEC2Aspect.js +1 -1
  40. package/lib/support/EncryptBucketOnTransitAspect.js +1 -1
  41. package/lib/support/EncryptCloudWatchLogGroupsAspect.js +1 -1
  42. package/lib/support/EncryptSNSTopicOnTransitAspect.js +1 -1
  43. package/lib/support/LambdaDLQAspect.js +1 -1
  44. package/lib/support/LogRetentionAspect.js +1 -1
  45. package/lib/support/RotateEncryptionKeysAspect.js +1 -1
  46. package/lib/support/SupportResources.d.ts +24 -14
  47. package/lib/support/SupportResources.js +42 -24
  48. package/package.json +6 -5
package/.jsii CHANGED
@@ -11,12 +11,44 @@
11
11
  "yaml": "^2.8.1"
12
12
  },
13
13
  "dependencies": {
14
+ "@aws-cdk/app-staging-synthesizer-alpha": "2.195.0-alpha.0",
14
15
  "aws-cdk-lib": "^2.195.0",
15
16
  "cdk-nag": "^2.37.55",
16
17
  "cdk-pipelines-github": "^0.4.132",
17
18
  "constructs": "^10.5.0"
18
19
  },
19
20
  "dependencyClosure": {
21
+ "@aws-cdk/app-staging-synthesizer-alpha": {
22
+ "targets": {
23
+ "dotnet": {
24
+ "iconUrl": "https://raw.githubusercontent.com/aws/aws-cdk/main/logo/default-256-dark.png",
25
+ "namespace": "Amazon.CDK.AppStagingSynthesizer.Alpha",
26
+ "packageId": "Amazon.CDK.AppStagingSynthesizer.Alpha"
27
+ },
28
+ "go": {
29
+ "moduleName": "github.com/aws/aws-cdk-go",
30
+ "packageName": "appstagingsynthesizeralpha"
31
+ },
32
+ "java": {
33
+ "maven": {
34
+ "artifactId": "cdk-app-staging-synthesizer-alpha",
35
+ "groupId": "software.amazon.awscdk"
36
+ },
37
+ "package": "software.amazon.awscdk.app.staging.synthesizer.alpha"
38
+ },
39
+ "js": {
40
+ "npm": "@aws-cdk/app-staging-synthesizer-alpha"
41
+ },
42
+ "python": {
43
+ "classifiers": [
44
+ "Framework :: AWS CDK",
45
+ "Framework :: AWS CDK :: 2"
46
+ ],
47
+ "distName": "aws-cdk.app-staging-synthesizer-alpha",
48
+ "module": "aws_cdk.app_staging_synthesizer_alpha"
49
+ }
50
+ }
51
+ },
20
52
  "@aws-cdk/asset-awscli-v1": {
21
53
  "targets": {
22
54
  "dotnet": {
@@ -4088,7 +4120,7 @@
4088
4120
  },
4089
4121
  "name": "@cdklabs/cdk-cicd-wrapper",
4090
4122
  "readme": {
4091
- "markdown": "## CDK CI/CD Wrapper\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\nThe [CDK CI/CD Wrapper](https://cdklabs.github.io/cdk-cicd-wrapper/) is a comprehensive solution that streamlines the delivery of your AWS Cloud Development Kit (CDK) applications. It provides a robust and standardized multi-stage CI/CD pipeline, ensuring high quality and confidence throughout the development and deployment process.\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Features](#features)\n- [Getting Started](#getting-started)\n - [Prerequisites](#prerequisites)\n - [Installation](#installation)\n- [Usage](#usage)\n - [Defining Stages](#defining-stages)\n - [Configuring Stacks](#configuring-stacks)\n - [Customizing CI/CD Steps](#customizing-cicd-steps)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Introduction\n\nThe CDK CI/CD Wrapper builds upon the success of the [aws-cdk-cicd-boot-sample](https://github.com/aws-samples/aws-cdk-cicd-boot-sample) and takes it a step further by providing additional tools and features to simplify and standardize the multi-stage CI/CD process for your Infrastructure as Code (IaC) projects.\n\n## Features\n\n- **Multi-staged CI/CD Pipeline**: Seamlessly deploy your CDK applications across multiple stages (e.g., DEV, INT, PROD) and AWS accounts.\n- **Security Scanning**: Perform security scanning on dependencies and codebase, blocking the pipeline in case of CVE findings.\n- **License Management**: Manage licenses for NPM and Python dependencies, ensuring compliance with your organization's policies.\n- **Private NPM Registry**: Securely store and utilize private NPM libraries.\n- **Customizable Pipeline**: Tailor the CI/CD pipeline to your project's specific needs with built-in dependency injection.\n- **Workbench Deployment**: Develop and experiment with your solutions in isolation before introducing them to the delivery pipeline.\n- **Pre/Post Deploy Hooks**: Execute custom scripts before and after deployments in each stage (e.g., unit tests, functional tests, load testing).\n- **Centralized Compliance Logs**: Store compliance logs in pre-configured S3 buckets on a per-stage/environment basis.\n- **Lambda Layer Support**: Build and scan dependencies for Python Lambda Layers.\n\n## Getting Started\n\n### Prerequisites\n\nBefore you begin, ensure that you have the following dependencies installed:\n\n- AWS Account (RES/DEV/INT/PROD)\n- macOS or Cloud9 with Ubuntu Server 22.04 LTS Platform in the RES Account\n- Bash/ZSH terminal\n- Docker version >= 24.0.x\n- AWS CLI v2 ([installation guide](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html))\n- AWS credentials and profiles for each environment in `~/.aws/config` ([configuration guide](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html))\n- Node.js >= v18.17._ && NPM >= v10.2._\n- jq command-line JSON processor (jq-1.7)\n\nFor developing Python Lambdas, you'll also need:\n\n- Python >= 3.11\n- Pipenv 2023.* ([installation guide](https://pipenv.pypa.io/en/latest/))\n\n### Installation\n\n1. Clone the CDK CI/CD Wrapper repository:\n\n ```bash\n git clone https://github.com/your-repo/cdk-cicd-wrapper.git\n cd cdk-cicd-wrapper\n ```\n\n2. Install the required dependencies:\n\n ```bash\n npm install\n ```\n\n## Usage\n\n### Defining Stages\n\nThe CDK CI/CD Wrapper comes with a default set of stages (DEV, INT, PROD), but you can easily extend or modify these stages to suit your project's needs. Follow the step-by-step guide in the documentation to define your desired stages.\n\n### Configuring Stacks\n\nConfigure the CDK stacks you want to deploy in each stage. The CDK CI/CD Wrapper allows you to specify which stacks should be deployed in each stage, giving you granular control over your deployment process.\n\n### Customizing CI/CD Steps\n\nTailor the CI/CD pipeline to meet your project's specific requirements. The CDK CI/CD Wrapper provides built-in dependency injection, allowing you to customize the CI/CD steps seamlessly.\n\n## Contributing\n\nContributions to the CDK CI/CD Wrapper are welcome! If you'd like to contribute, please follow the guidelines outlined in the [CONTRIBUTING.md](CONTRIBUTING.md) file.\n\n## License\n\nThis project is licensed under the [Apache 2.0 License](LICENSE).\n"
4123
+ "markdown": "## CDK CI/CD Wrapper\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\nThe [CDK CI/CD Wrapper](https://cdklabs.github.io/cdk-cicd-wrapper/) is a comprehensive solution that streamlines the delivery of your AWS Cloud Development Kit (CDK) applications. It provides a robust and standardized multi-stage CI/CD pipeline, ensuring high quality and confidence throughout the development and deployment process.\n\n## Table of Contents\n\n- [Introduction](#introduction)\n- [Features](#features)\n- [Getting Started](#getting-started)\n - [Prerequisites](#prerequisites)\n - [Installation](#installation)\n- [Usage](#usage)\n - [Defining Stages](#defining-stages)\n - [Configuring Stacks](#configuring-stacks)\n - [Customizing CI/CD Steps](#customizing-cicd-steps)\n- [Autopilot Deployment Contracts](#autopilot-deployment-contracts)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Introduction\n\nThe CDK CI/CD Wrapper builds upon the success of the [aws-cdk-cicd-boot-sample](https://github.com/aws-samples/aws-cdk-cicd-boot-sample) and takes it a step further by providing additional tools and features to simplify and standardize the multi-stage CI/CD process for your Infrastructure as Code (IaC) projects.\n\n## Features\n\n- **Multi-staged CI/CD Pipeline**: Seamlessly deploy your CDK applications across multiple stages (e.g., DEV, INT, PROD) and AWS accounts.\n- **Security Scanning**: Perform security scanning on dependencies and codebase, blocking the pipeline in case of CVE findings.\n- **License Management**: Manage licenses for NPM and Python dependencies, ensuring compliance with your organization's policies.\n- **Private NPM Registry**: Securely store and utilize private NPM libraries.\n- **Customizable Pipeline**: Tailor the CI/CD pipeline to your project's specific needs with built-in dependency injection.\n- **Workbench Deployment**: Develop and experiment with your solutions in isolation before introducing them to the delivery pipeline.\n- **Pre/Post Deploy Hooks**: Execute custom scripts before and after deployments in each stage (e.g., unit tests, functional tests, load testing).\n- **Centralized Compliance Logs**: Store compliance logs in pre-configured S3 buckets on a per-stage/environment basis.\n- **Lambda Layer Support**: Build and scan dependencies for Python Lambda Layers.\n\n## Getting Started\n\n### Prerequisites\n\nBefore you begin, ensure that you have the following dependencies installed:\n\n- AWS Account (RES/DEV/INT/PROD)\n- macOS or Cloud9 with Ubuntu Server 22.04 LTS Platform in the RES Account\n- Bash/ZSH terminal\n- Docker version >= 24.0.x\n- AWS CLI v2 ([installation guide](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html))\n- AWS credentials and profiles for each environment in `~/.aws/config` ([configuration guide](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html))\n- Node.js >= v18.17._ && NPM >= v10.2._\n- jq command-line JSON processor (jq-1.7)\n\nFor developing Python Lambdas, you'll also need:\n\n- Python >= 3.11\n- Pipenv 2023.* ([installation guide](https://pipenv.pypa.io/en/latest/))\n\n### Installation\n\n1. Clone the CDK CI/CD Wrapper repository:\n\n ```bash\n git clone https://github.com/your-repo/cdk-cicd-wrapper.git\n cd cdk-cicd-wrapper\n ```\n\n2. Install the required dependencies:\n\n ```bash\n npm install\n ```\n\n## Usage\n\n### Defining Stages\n\nThe CDK CI/CD Wrapper comes with a default set of stages (DEV, INT, PROD), but you can easily extend or modify these stages to suit your project's needs. Follow the step-by-step guide in the documentation to define your desired stages.\n\n### Configuring Stacks\n\nConfigure the CDK stacks you want to deploy in each stage. The CDK CI/CD Wrapper allows you to specify which stacks should be deployed in each stage, giving you granular control over your deployment process.\n\n### Customizing CI/CD Steps\n\nTailor the CI/CD pipeline to meet your project's specific requirements. The CDK CI/CD Wrapper provides built-in dependency injection, allowing you to customize the CI/CD steps seamlessly.\n\n## Autopilot Deployment Contracts\n\n| Area | Contract |\n| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `APP_STAGING` | Valid for direct/local `cdk deploy` (including local `cdk-cicd deploy --from-image`) and Repo 1 container-image synthesis. Wrapper-generated deployment pipelines—flat `CODEPIPELINE`, Repo 2, `CDK_PIPELINES`, and `GITHUB_ACTIONS`—reject it. On direct/local paths, custom deploy and CloudFormation execution roles govern application stacks; staging support resources use caller/base credentials. |\n| Deploy-role `ExternalId` | `CDK_PIPELINES` and `GITHUB_ACTIONS` reject configured deploy-role ExternalIds rather than silently dropping them. `APP_STAGING` accepts custom deployment identities but rejects a deploy-role ExternalId because the alpha API does not expose one. |\n| CloudFormation execution role | CodeBuild assumes the deployment role; that assumed role passes the configured CloudFormation execution role to CloudFormation. Grant `iam:PassRole` to the deployment role, not directly to the CodeBuild project role. |\n| Custom CodeBuild ECR image | A private ECR environment image must be in the CodeBuild project's Region; flat CodePipeline and CDK Pipelines also require the pipeline account. Repo 2 supports its explicit cross-account image path only after the owner-side repository policy is configured and `crossAccountEcrRepositoryPolicyConfigured` is acknowledged; the build-image Region rule still applies. |\n| GitHub manual approval | Configure required reviewers on each generated GitHub Environment, then set `githubActions.environmentProtectionConfigured: true`. Referencing an environment in workflow YAML does not configure its protection rules. |\n\n## Contributing\n\nContributions to the CDK CI/CD Wrapper are welcome! If you'd like to contribute, please follow the guidelines outlined in the [CONTRIBUTING.md](CONTRIBUTING.md) file.\n\n## License\n\nThis project is licensed under the [Apache 2.0 License](LICENSE).\n"
4092
4124
  },
4093
4125
  "repository": {
4094
4126
  "directory": "packages/@cdklabs/cdk-cicd-wrapper",
@@ -4120,8 +4152,9 @@
4120
4152
  "@cdklabs/cdk-cicd-wrapper.AccessLogsForBucketAspect": {
4121
4153
  "assembly": "@cdklabs/cdk-cicd-wrapper",
4122
4154
  "docs": {
4155
+ "remarks": "The compliance destination\nalways wins; an existing user prefix is preserved, otherwise a bucket-specific prefix is generated.",
4123
4156
  "stability": "experimental",
4124
- "summary": "Configures S3 server access logging (destination + prefix) on every L1 `CfnBucket` it visits that does not already set a logging destination, matching Blueprint's default-on `AccessLogsForBucketPlugin`."
4157
+ "summary": "Configures S3 server access logging on every L1 `CfnBucket` it visits."
4125
4158
  },
4126
4159
  "fqn": "@cdklabs/cdk-cicd-wrapper.AccessLogsForBucketAspect",
4127
4160
  "initializer": {
@@ -4130,7 +4163,7 @@
4130
4163
  },
4131
4164
  "locationInModule": {
4132
4165
  "filename": "src/support/AccessLogsForBucketAspect.ts",
4133
- "line": 40
4166
+ "line": 46
4134
4167
  },
4135
4168
  "parameters": [
4136
4169
  {
@@ -4147,7 +4180,7 @@
4147
4180
  "kind": "class",
4148
4181
  "locationInModule": {
4149
4182
  "filename": "src/support/AccessLogsForBucketAspect.ts",
4150
- "line": 35
4183
+ "line": 37
4151
4184
  },
4152
4185
  "methods": [
4153
4186
  {
@@ -4157,7 +4190,7 @@
4157
4190
  },
4158
4191
  "locationInModule": {
4159
4192
  "filename": "src/support/AccessLogsForBucketAspect.ts",
4160
- "line": 45
4193
+ "line": 53
4161
4194
  },
4162
4195
  "name": "visit",
4163
4196
  "overrides": "aws-cdk-lib.IAspect",
@@ -4189,6 +4222,23 @@
4189
4222
  },
4190
4223
  "name": "AccessLogsForBucketAspectProps",
4191
4224
  "properties": [
4225
+ {
4226
+ "abstract": true,
4227
+ "docs": {
4228
+ "remarks": "S3 access-log delivery cannot cross accounts.",
4229
+ "stability": "experimental",
4230
+ "summary": "AWS account that owns the compliance bucket."
4231
+ },
4232
+ "immutable": true,
4233
+ "locationInModule": {
4234
+ "filename": "src/support/AccessLogsForBucketAspect.ts",
4235
+ "line": 23
4236
+ },
4237
+ "name": "complianceLogBucketAccount",
4238
+ "type": {
4239
+ "primitive": "string"
4240
+ }
4241
+ },
4192
4242
  {
4193
4243
  "abstract": true,
4194
4244
  "docs": {
@@ -4208,19 +4258,37 @@
4208
4258
  {
4209
4259
  "abstract": true,
4210
4260
  "docs": {
4211
- "remarks": "When a visited bucket's stack is deployed to a\ndifferent region, `complianceLogBucketName` is rewritten by substituting `mainRegion` for that\nstack's region -- same cross-region name convention as Blueprint.",
4261
+ "remarks": "S3 access-log delivery cannot cross Regions.",
4212
4262
  "stability": "experimental",
4213
- "summary": "The region the compliance log bucket lives in."
4263
+ "summary": "AWS Region containing the compliance bucket."
4214
4264
  },
4215
4265
  "immutable": true,
4216
4266
  "locationInModule": {
4217
4267
  "filename": "src/support/AccessLogsForBucketAspect.ts",
4218
- "line": 28
4268
+ "line": 25
4219
4269
  },
4220
- "name": "mainRegion",
4270
+ "name": "complianceLogBucketRegion",
4221
4271
  "type": {
4222
4272
  "primitive": "string"
4223
4273
  }
4274
+ },
4275
+ {
4276
+ "abstract": true,
4277
+ "docs": {
4278
+ "remarks": "Supplying it lets same-stack\nsource buckets depend explicitly on the destination bucket and its policy.",
4279
+ "stability": "experimental",
4280
+ "summary": "The concrete destination bucket when it exists in the same CDK app."
4281
+ },
4282
+ "immutable": true,
4283
+ "locationInModule": {
4284
+ "filename": "src/support/AccessLogsForBucketAspect.ts",
4285
+ "line": 30
4286
+ },
4287
+ "name": "complianceLogBucket",
4288
+ "optional": true,
4289
+ "type": {
4290
+ "fqn": "aws-cdk-lib.aws_s3.IBucket"
4291
+ }
4224
4292
  }
4225
4293
  ],
4226
4294
  "symbolId": "src/support/AccessLogsForBucketAspect:AccessLogsForBucketAspectProps"
@@ -4624,7 +4692,7 @@
4624
4692
  "kind": "class",
4625
4693
  "locationInModule": {
4626
4694
  "filename": "src/config/build-image.ts",
4627
- "line": 41
4695
+ "line": 103
4628
4696
  },
4629
4697
  "methods": [
4630
4698
  {
@@ -4634,7 +4702,7 @@
4634
4702
  },
4635
4703
  "locationInModule": {
4636
4704
  "filename": "src/config/build-image.ts",
4637
- "line": 43
4705
+ "line": 105
4638
4706
  },
4639
4707
  "name": "docker",
4640
4708
  "parameters": [
@@ -4664,7 +4732,7 @@
4664
4732
  "immutable": true,
4665
4733
  "locationInModule": {
4666
4734
  "filename": "src/config/build-image.ts",
4667
- "line": 55
4735
+ "line": 117
4668
4736
  },
4669
4737
  "name": "dockerfile",
4670
4738
  "type": {
@@ -4679,7 +4747,7 @@
4679
4747
  "immutable": true,
4680
4748
  "locationInModule": {
4681
4749
  "filename": "src/config/build-image.ts",
4682
- "line": 53
4750
+ "line": 115
4683
4751
  },
4684
4752
  "name": "kind",
4685
4753
  "type": {
@@ -4694,7 +4762,7 @@
4694
4762
  "immutable": true,
4695
4763
  "locationInModule": {
4696
4764
  "filename": "src/config/build-image.ts",
4697
- "line": 57
4765
+ "line": 119
4698
4766
  },
4699
4767
  "name": "tagStrategy",
4700
4768
  "type": {
@@ -4710,7 +4778,7 @@
4710
4778
  "immutable": true,
4711
4779
  "locationInModule": {
4712
4780
  "filename": "src/config/build-image.ts",
4713
- "line": 59
4781
+ "line": 121
4714
4782
  },
4715
4783
  "name": "repositoryName",
4716
4784
  "optional": true,
@@ -4732,7 +4800,7 @@
4732
4800
  "kind": "enum",
4733
4801
  "locationInModule": {
4734
4802
  "filename": "src/config/build-image.ts",
4735
- "line": 33
4803
+ "line": 95
4736
4804
  },
4737
4805
  "members": [
4738
4806
  {
@@ -4839,7 +4907,7 @@
4839
4907
  },
4840
4908
  "locationInModule": {
4841
4909
  "filename": "src/engine/cdkpipelines/CdkPipelinesEngine.ts",
4842
- "line": 98
4910
+ "line": 230
4843
4911
  },
4844
4912
  "parameters": [
4845
4913
  {
@@ -4865,7 +4933,7 @@
4865
4933
  "kind": "class",
4866
4934
  "locationInModule": {
4867
4935
  "filename": "src/engine/cdkpipelines/CdkPipelinesEngine.ts",
4868
- "line": 95
4936
+ "line": 227
4869
4937
  },
4870
4938
  "name": "CdkPipelinesEngine",
4871
4939
  "properties": [
@@ -4876,7 +4944,7 @@
4876
4944
  "immutable": true,
4877
4945
  "locationInModule": {
4878
4946
  "filename": "src/engine/cdkpipelines/CdkPipelinesEngine.ts",
4879
- "line": 96
4947
+ "line": 228
4880
4948
  },
4881
4949
  "name": "pipeline",
4882
4950
  "type": {
@@ -4897,7 +4965,7 @@
4897
4965
  "kind": "interface",
4898
4966
  "locationInModule": {
4899
4967
  "filename": "src/engine/cdkpipelines/CdkPipelinesEngine.ts",
4900
- "line": 50
4968
+ "line": 72
4901
4969
  },
4902
4970
  "name": "CdkPipelinesEngineProps",
4903
4971
  "properties": [
@@ -4910,7 +4978,7 @@
4910
4978
  "immutable": true,
4911
4979
  "locationInModule": {
4912
4980
  "filename": "src/engine/cdkpipelines/CdkPipelinesEngine.ts",
4913
- "line": 52
4981
+ "line": 74
4914
4982
  },
4915
4983
  "name": "config",
4916
4984
  "type": {
@@ -4926,7 +4994,7 @@
4926
4994
  "immutable": true,
4927
4995
  "locationInModule": {
4928
4996
  "filename": "src/engine/cdkpipelines/CdkPipelinesEngine.ts",
4929
- "line": 54
4997
+ "line": 76
4930
4998
  },
4931
4999
  "name": "stages",
4932
5000
  "type": {
@@ -4943,7 +5011,7 @@
4943
5011
  "immutable": true,
4944
5012
  "locationInModule": {
4945
5013
  "filename": "src/engine/cdkpipelines/CdkPipelinesEngine.ts",
4946
- "line": 56
5014
+ "line": 78
4947
5015
  },
4948
5016
  "name": "pipelineName",
4949
5017
  "optional": true,
@@ -4965,7 +5033,7 @@
4965
5033
  "kind": "interface",
4966
5034
  "locationInModule": {
4967
5035
  "filename": "src/engine/cdkpipelines/CdkPipelinesEngine.ts",
4968
- "line": 32
5036
+ "line": 54
4969
5037
  },
4970
5038
  "name": "CdkPipelinesStageContext",
4971
5039
  "properties": [
@@ -4978,7 +5046,7 @@
4978
5046
  "immutable": true,
4979
5047
  "locationInModule": {
4980
5048
  "filename": "src/engine/cdkpipelines/CdkPipelinesEngine.ts",
4981
- "line": 36
5049
+ "line": 58
4982
5050
  },
4983
5051
  "name": "env",
4984
5052
  "type": {
@@ -4994,7 +5062,7 @@
4994
5062
  "immutable": true,
4995
5063
  "locationInModule": {
4996
5064
  "filename": "src/engine/cdkpipelines/CdkPipelinesEngine.ts",
4997
- "line": 34
5065
+ "line": 56
4998
5066
  },
4999
5067
  "name": "stageName",
5000
5068
  "type": {
@@ -5015,7 +5083,7 @@
5015
5083
  "kind": "interface",
5016
5084
  "locationInModule": {
5017
5085
  "filename": "src/config/types.ts",
5018
- "line": 121
5086
+ "line": 159
5019
5087
  },
5020
5088
  "name": "CiConfig",
5021
5089
  "properties": [
@@ -5028,7 +5096,7 @@
5028
5096
  "immutable": true,
5029
5097
  "locationInModule": {
5030
5098
  "filename": "src/config/types.ts",
5031
- "line": 126
5099
+ "line": 164
5032
5100
  },
5033
5101
  "name": "steps",
5034
5102
  "type": {
@@ -5050,7 +5118,7 @@
5050
5118
  "immutable": true,
5051
5119
  "locationInModule": {
5052
5120
  "filename": "src/config/types.ts",
5053
- "line": 132
5121
+ "line": 170
5054
5122
  },
5055
5123
  "name": "synthStages",
5056
5124
  "type": {
@@ -5062,6 +5130,24 @@
5062
5130
  }
5063
5131
  }
5064
5132
  },
5133
+ {
5134
+ "abstract": true,
5135
+ "docs": {
5136
+ "remarks": "Supported by the CodeBuild engines only. Managed CodeBuild images and private ECR images use\ntheir own credential models and reject this setting.",
5137
+ "stability": "experimental",
5138
+ "summary": "Secrets Manager credentials for an authenticated external-registry `image`."
5139
+ },
5140
+ "immutable": true,
5141
+ "locationInModule": {
5142
+ "filename": "src/config/types.ts",
5143
+ "line": 179
5144
+ },
5145
+ "name": "codeBuildImageCredentials",
5146
+ "optional": true,
5147
+ "type": {
5148
+ "fqn": "@cdklabs/cdk-cicd-wrapper.CodeBuildImageCredentials"
5149
+ }
5150
+ },
5065
5151
  {
5066
5152
  "abstract": true,
5067
5153
  "docs": {
@@ -5071,7 +5157,7 @@
5071
5157
  "immutable": true,
5072
5158
  "locationInModule": {
5073
5159
  "filename": "src/config/types.ts",
5074
- "line": 134
5160
+ "line": 172
5075
5161
  },
5076
5162
  "name": "image",
5077
5163
  "optional": true,
@@ -5088,7 +5174,7 @@
5088
5174
  "immutable": true,
5089
5175
  "locationInModule": {
5090
5176
  "filename": "src/config/types.ts",
5091
- "line": 141
5177
+ "line": 186
5092
5178
  },
5093
5179
  "name": "partialBuildSpec",
5094
5180
  "optional": true,
@@ -5111,7 +5197,7 @@
5111
5197
  "kind": "interface",
5112
5198
  "locationInModule": {
5113
5199
  "filename": "src/config/types.ts",
5114
- "line": 150
5200
+ "line": 195
5115
5201
  },
5116
5202
  "name": "CodeArtifactConfig",
5117
5203
  "properties": [
@@ -5124,7 +5210,7 @@
5124
5210
  "immutable": true,
5125
5211
  "locationInModule": {
5126
5212
  "filename": "src/config/types.ts",
5127
- "line": 152
5213
+ "line": 197
5128
5214
  },
5129
5215
  "name": "domain",
5130
5216
  "type": {
@@ -5140,7 +5226,7 @@
5140
5226
  "immutable": true,
5141
5227
  "locationInModule": {
5142
5228
  "filename": "src/config/types.ts",
5143
- "line": 154
5229
+ "line": 199
5144
5230
  },
5145
5231
  "name": "repository",
5146
5232
  "type": {
@@ -5157,7 +5243,7 @@
5157
5243
  "immutable": true,
5158
5244
  "locationInModule": {
5159
5245
  "filename": "src/config/types.ts",
5160
- "line": 156
5246
+ "line": 201
5161
5247
  },
5162
5248
  "name": "account",
5163
5249
  "optional": true,
@@ -5174,7 +5260,7 @@
5174
5260
  "immutable": true,
5175
5261
  "locationInModule": {
5176
5262
  "filename": "src/config/types.ts",
5177
- "line": 160
5263
+ "line": 205
5178
5264
  },
5179
5265
  "name": "npmScope",
5180
5266
  "optional": true,
@@ -5192,7 +5278,7 @@
5192
5278
  "immutable": true,
5193
5279
  "locationInModule": {
5194
5280
  "filename": "src/config/types.ts",
5195
- "line": 158
5281
+ "line": 203
5196
5282
  },
5197
5283
  "name": "region",
5198
5284
  "optional": true,
@@ -5203,6 +5289,57 @@
5203
5289
  ],
5204
5290
  "symbolId": "src/config/types:CodeArtifactConfig"
5205
5291
  },
5292
+ "@cdklabs/cdk-cicd-wrapper.CodeBuildImageCredentials": {
5293
+ "assembly": "@cdklabs/cdk-cicd-wrapper",
5294
+ "datatype": true,
5295
+ "docs": {
5296
+ "stability": "experimental",
5297
+ "summary": "Secrets Manager credentials used by CodeBuild to pull an authenticated external-registry image."
5298
+ },
5299
+ "fqn": "@cdklabs/cdk-cicd-wrapper.CodeBuildImageCredentials",
5300
+ "kind": "interface",
5301
+ "locationInModule": {
5302
+ "filename": "src/config/types.ts",
5303
+ "line": 151
5304
+ },
5305
+ "name": "CodeBuildImageCredentials",
5306
+ "properties": [
5307
+ {
5308
+ "abstract": true,
5309
+ "docs": {
5310
+ "stability": "experimental",
5311
+ "summary": "Complete ARN of the Secrets Manager secret containing the registry username and password."
5312
+ },
5313
+ "immutable": true,
5314
+ "locationInModule": {
5315
+ "filename": "src/config/types.ts",
5316
+ "line": 153
5317
+ },
5318
+ "name": "secretArn",
5319
+ "type": {
5320
+ "primitive": "string"
5321
+ }
5322
+ },
5323
+ {
5324
+ "abstract": true,
5325
+ "docs": {
5326
+ "stability": "experimental",
5327
+ "summary": "Customer-managed KMS key encrypting `secretArn`, when one is used."
5328
+ },
5329
+ "immutable": true,
5330
+ "locationInModule": {
5331
+ "filename": "src/config/types.ts",
5332
+ "line": 155
5333
+ },
5334
+ "name": "encryptionKeyArn",
5335
+ "optional": true,
5336
+ "type": {
5337
+ "primitive": "string"
5338
+ }
5339
+ }
5340
+ ],
5341
+ "symbolId": "src/config/types:CodeBuildImageCredentials"
5342
+ },
5206
5343
  "@cdklabs/cdk-cicd-wrapper.CodeCommitSourceOptions": {
5207
5344
  "assembly": "@cdklabs/cdk-cicd-wrapper",
5208
5345
  "datatype": true,
@@ -5253,7 +5390,7 @@
5253
5390
  },
5254
5391
  "locationInModule": {
5255
5392
  "filename": "src/engine/codepipeline/CodePipelineEngine.ts",
5256
- "line": 95
5393
+ "line": 294
5257
5394
  },
5258
5395
  "parameters": [
5259
5396
  {
@@ -5271,7 +5408,7 @@
5271
5408
  "kind": "class",
5272
5409
  "locationInModule": {
5273
5410
  "filename": "src/engine/codepipeline/CodePipelineEngine.ts",
5274
- "line": 91
5411
+ "line": 290
5275
5412
  },
5276
5413
  "methods": [
5277
5414
  {
@@ -5282,7 +5419,7 @@
5282
5419
  },
5283
5420
  "locationInModule": {
5284
5421
  "filename": "src/engine/codepipeline/CodePipelineEngine.ts",
5285
- "line": 100
5422
+ "line": 299
5286
5423
  },
5287
5424
  "name": "render",
5288
5425
  "overrides": "@cdklabs/cdk-cicd-wrapper.IEngine",
@@ -5316,21 +5453,21 @@
5316
5453
  "kind": "interface",
5317
5454
  "locationInModule": {
5318
5455
  "filename": "src/engine/codepipeline/CodePipelineEngine.ts",
5319
- "line": 80
5456
+ "line": 276
5320
5457
  },
5321
5458
  "name": "CodePipelineEngineProps",
5322
5459
  "properties": [
5323
5460
  {
5324
5461
  "abstract": true,
5325
5462
  "docs": {
5326
- "remarks": "Defaults to the standard Amazon Linux image.",
5463
+ "remarks": "Overrides `config.ci.image`; defaults to the\nstandard Amazon Linux image.",
5327
5464
  "stability": "experimental",
5328
- "summary": "CodeBuild image for the CI and deploy projects."
5465
+ "summary": "CodeBuild image for the CI Build project only."
5329
5466
  },
5330
5467
  "immutable": true,
5331
5468
  "locationInModule": {
5332
5469
  "filename": "src/engine/codepipeline/CodePipelineEngine.ts",
5333
- "line": 82
5470
+ "line": 281
5334
5471
  },
5335
5472
  "name": "buildImage",
5336
5473
  "optional": true,
@@ -5348,7 +5485,7 @@
5348
5485
  "immutable": true,
5349
5486
  "locationInModule": {
5350
5487
  "filename": "src/engine/codepipeline/CodePipelineEngine.ts",
5351
- "line": 87
5488
+ "line": 286
5352
5489
  },
5353
5490
  "name": "removalPolicy",
5354
5491
  "optional": true,
@@ -5371,21 +5508,21 @@
5371
5508
  "kind": "interface",
5372
5509
  "locationInModule": {
5373
5510
  "filename": "src/config/types.ts",
5374
- "line": 299
5511
+ "line": 354
5375
5512
  },
5376
5513
  "name": "CodePipelineRoleNames",
5377
5514
  "properties": [
5378
5515
  {
5379
5516
  "abstract": true,
5380
5517
  "docs": {
5381
- "remarks": "Omit to keep CDK-generated names.",
5518
+ "remarks": "The suffix is the lower-cased construct id\nwith a trailing `Project` removed: `BuildProject` -> `build`, `UpdatePipeline` ->\n`updatepipeline`, and `Deploy-dev` -> `deploy-dev`.\n\nOmit to keep CDK-generated names.",
5382
5519
  "stability": "experimental",
5383
- "summary": "Prefix for the per-stage CodeBuild project roles: each stage's build role is named `<buildRolePrefix>-<stage>` (plus the CI/self-update projects, `<buildRolePrefix>-build` / `<buildRolePrefix>-selfupdate`)."
5520
+ "summary": "Prefix for every flat-engine CodeBuild project role."
5384
5521
  },
5385
5522
  "immutable": true,
5386
5523
  "locationInModule": {
5387
5524
  "filename": "src/config/types.ts",
5388
- "line": 307
5525
+ "line": 364
5389
5526
  },
5390
5527
  "name": "buildRolePrefix",
5391
5528
  "optional": true,
@@ -5402,7 +5539,7 @@
5402
5539
  "immutable": true,
5403
5540
  "locationInModule": {
5404
5541
  "filename": "src/config/types.ts",
5405
- "line": 301
5542
+ "line": 356
5406
5543
  },
5407
5544
  "name": "pipeline",
5408
5545
  "optional": true,
@@ -5598,6 +5735,92 @@
5598
5735
  ],
5599
5736
  "symbolId": "src/appconfig/validation:ConfigSchema"
5600
5737
  },
5738
+ "@cdklabs/cdk-cicd-wrapper.DefaultSynthesizerRoleArnOptions": {
5739
+ "assembly": "@cdklabs/cdk-cicd-wrapper",
5740
+ "datatype": true,
5741
+ "docs": {
5742
+ "stability": "experimental",
5743
+ "summary": "Target values used to specialize a DefaultStackSynthesizer role ARN."
5744
+ },
5745
+ "fqn": "@cdklabs/cdk-cicd-wrapper.DefaultSynthesizerRoleArnOptions",
5746
+ "kind": "interface",
5747
+ "locationInModule": {
5748
+ "filename": "src/config/default-synthesizer-role-arn.ts",
5749
+ "line": 27
5750
+ },
5751
+ "name": "DefaultSynthesizerRoleArnOptions",
5752
+ "properties": [
5753
+ {
5754
+ "abstract": true,
5755
+ "docs": {
5756
+ "stability": "experimental",
5757
+ "summary": "Concrete target AWS account."
5758
+ },
5759
+ "immutable": true,
5760
+ "locationInModule": {
5761
+ "filename": "src/config/default-synthesizer-role-arn.ts",
5762
+ "line": 31
5763
+ },
5764
+ "name": "account",
5765
+ "type": {
5766
+ "primitive": "string"
5767
+ }
5768
+ },
5769
+ {
5770
+ "abstract": true,
5771
+ "docs": {
5772
+ "stability": "experimental",
5773
+ "summary": "Concrete target AWS Region."
5774
+ },
5775
+ "immutable": true,
5776
+ "locationInModule": {
5777
+ "filename": "src/config/default-synthesizer-role-arn.ts",
5778
+ "line": 33
5779
+ },
5780
+ "name": "region",
5781
+ "type": {
5782
+ "primitive": "string"
5783
+ }
5784
+ },
5785
+ {
5786
+ "abstract": true,
5787
+ "docs": {
5788
+ "remarks": "When omitted, `${AWS::Partition}` remains intact to match the role ARN emitted in a cloud assembly.",
5789
+ "stability": "experimental",
5790
+ "summary": "Concrete target AWS partition."
5791
+ },
5792
+ "immutable": true,
5793
+ "locationInModule": {
5794
+ "filename": "src/config/default-synthesizer-role-arn.ts",
5795
+ "line": 39
5796
+ },
5797
+ "name": "partition",
5798
+ "optional": true,
5799
+ "type": {
5800
+ "primitive": "string"
5801
+ }
5802
+ },
5803
+ {
5804
+ "abstract": true,
5805
+ "docs": {
5806
+ "remarks": "Defaults to the CDK default qualifier (`hnb659fds`).",
5807
+ "stability": "experimental",
5808
+ "summary": "Bootstrap qualifier."
5809
+ },
5810
+ "immutable": true,
5811
+ "locationInModule": {
5812
+ "filename": "src/config/default-synthesizer-role-arn.ts",
5813
+ "line": 29
5814
+ },
5815
+ "name": "qualifier",
5816
+ "optional": true,
5817
+ "type": {
5818
+ "primitive": "string"
5819
+ }
5820
+ }
5821
+ ],
5822
+ "symbolId": "src/config/default-synthesizer-role-arn:DefaultSynthesizerRoleArnOptions"
5823
+ },
5601
5824
  "@cdklabs/cdk-cicd-wrapper.DeployModel": {
5602
5825
  "assembly": "@cdklabs/cdk-cicd-wrapper",
5603
5826
  "docs": {
@@ -5609,7 +5832,7 @@
5609
5832
  "kind": "enum",
5610
5833
  "locationInModule": {
5611
5834
  "filename": "src/config/types.ts",
5612
- "line": 104
5835
+ "line": 134
5613
5836
  },
5614
5837
  "members": [
5615
5838
  {
@@ -5642,7 +5865,7 @@
5642
5865
  "kind": "interface",
5643
5866
  "locationInModule": {
5644
5867
  "filename": "src/config/types.ts",
5645
- "line": 262
5868
+ "line": 312
5646
5869
  },
5647
5870
  "name": "DeploymentConfig",
5648
5871
  "properties": [
@@ -5655,7 +5878,7 @@
5655
5878
  "immutable": true,
5656
5879
  "locationInModule": {
5657
5880
  "filename": "src/config/types.ts",
5658
- "line": 266
5881
+ "line": 319
5659
5882
  },
5660
5883
  "name": "cfnExecutionRole",
5661
5884
  "optional": true,
@@ -5666,13 +5889,14 @@
5666
5889
  {
5667
5890
  "abstract": true,
5668
5891
  "docs": {
5892
+ "remarks": "It is written to the cloud assembly as the stack's\ndeployment-role assumption; it is not CloudFormation's execution `RoleARN`.",
5669
5893
  "stability": "experimental",
5670
- "summary": "ARN the CLI assumes to deploy (passed as `cdk deploy --role-arn`)."
5894
+ "summary": "ARN CDK assumes for deployment operations."
5671
5895
  },
5672
5896
  "immutable": true,
5673
5897
  "locationInModule": {
5674
5898
  "filename": "src/config/types.ts",
5675
- "line": 264
5899
+ "line": 317
5676
5900
  },
5677
5901
  "name": "deployRole",
5678
5902
  "optional": true,
@@ -5683,14 +5907,14 @@
5683
5907
  {
5684
5908
  "abstract": true,
5685
5909
  "docs": {
5686
- "remarks": "Overrides the pipeline-level `ResolvedCicdConfig.deployRoleExternalId` for\nthis stage. A literal, or a `resolve:secretsmanager:<arn>` reference resolved at synth time (the\nsame `resolve:` convention `VpcConfig.vpcId` uses). Ignored when `deployRole` is unset -- an\nExternalId only applies to a role assumption the wrapper actually performs.",
5910
+ "remarks": "Overrides the pipeline-level `ResolvedCicdConfig.deployRoleExternalId` for\nthis stage. A literal, or a `resolve:secretsmanager:<arn>` reference resolved at synth time (the\nsame `resolve:` convention `VpcConfig.vpcId` uses). Ignored when `deployRole` is unset -- an\nExternalId only applies to a role assumption the wrapper actually performs. A literal, or a\n`resolve:secretsmanager:<complete literal secret ARN>` reference resolved at synth time (the same\n`resolve:` convention `VpcConfig.vpcId` uses). Wildcards and non-ARN secret identifiers are rejected.",
5687
5911
  "stability": "experimental",
5688
5912
  "summary": "ExternalId presented when assuming `deployRole` (the `sts:ExternalId` a hardened cross-account trust policy requires)."
5689
5913
  },
5690
5914
  "immutable": true,
5691
5915
  "locationInModule": {
5692
5916
  "filename": "src/config/types.ts",
5693
- "line": 274
5917
+ "line": 329
5694
5918
  },
5695
5919
  "name": "externalId",
5696
5920
  "optional": true,
@@ -5705,9 +5929,9 @@
5705
5929
  "assembly": "@cdklabs/cdk-cicd-wrapper",
5706
5930
  "base": "constructs.Construct",
5707
5931
  "docs": {
5708
- "remarks": "Each action runs `cdk-cicd deploy --from-image --target\n<stage>` -- pulling that target's own image version, read from deploy.config at run time. The CLI is\ninstalled from the source repo's `package.json` (`npm ci`), so the config repo carries no CDK code.",
5932
+ "remarks": "Each contiguous run of ungated targets shares one stage and can deploy in parallel.\nEach gated target has its own stage, with its approval at run order 1 and only that target's deploy\naction(s) at run order 2, so the gate blocks every later target without reordering the declaration.\nA sequential target uses one action for all regions; a parallel multi-region target fans out one action\nper region. Each action runs `cdk-cicd deploy --from-image --target <stage>` -- pulling that target's own\nimage version, read from deploy.config at run time. The CLI is installed from the source repo's\n`package.json` (`npm ci`), so the config repo carries no CDK code.",
5709
5933
  "stability": "experimental",
5710
- "summary": "Renders the CD CodePipeline into `scope` (a Stack): Source (the config repo) -> a \"Deploy\" stage with one privileged-CodeBuild action per ungated target (parallel), then a \"DeployGated\" stage with the gated targets, each behind its own manual approval."
5934
+ "summary": "Renders the CD CodePipeline into `scope` (a Stack): Source (the config repo) followed by ordered deployment stages."
5711
5935
  },
5712
5936
  "fqn": "@cdklabs/cdk-cicd-wrapper.DeploymentPipeline",
5713
5937
  "initializer": {
@@ -5716,7 +5940,7 @@
5716
5940
  },
5717
5941
  "locationInModule": {
5718
5942
  "filename": "src/engine/codepipeline/DeploymentPipeline.ts",
5719
- "line": 50
5943
+ "line": 76
5720
5944
  },
5721
5945
  "parameters": [
5722
5946
  {
@@ -5742,7 +5966,7 @@
5742
5966
  "kind": "class",
5743
5967
  "locationInModule": {
5744
5968
  "filename": "src/engine/codepipeline/DeploymentPipeline.ts",
5745
- "line": 47
5969
+ "line": 73
5746
5970
  },
5747
5971
  "name": "DeploymentPipeline",
5748
5972
  "properties": [
@@ -5753,7 +5977,7 @@
5753
5977
  "immutable": true,
5754
5978
  "locationInModule": {
5755
5979
  "filename": "src/engine/codepipeline/DeploymentPipeline.ts",
5756
- "line": 48
5980
+ "line": 74
5757
5981
  },
5758
5982
  "name": "pipeline",
5759
5983
  "type": {
@@ -5878,7 +6102,7 @@
5878
6102
  "kind": "interface",
5879
6103
  "locationInModule": {
5880
6104
  "filename": "src/engine/codepipeline/DeploymentPipeline.ts",
5881
- "line": 31
6105
+ "line": 54
5882
6106
  },
5883
6107
  "name": "DeploymentPipelineProps",
5884
6108
  "properties": [
@@ -5892,7 +6116,7 @@
5892
6116
  "immutable": true,
5893
6117
  "locationInModule": {
5894
6118
  "filename": "src/engine/codepipeline/DeploymentPipeline.ts",
5895
- "line": 33
6119
+ "line": 56
5896
6120
  },
5897
6121
  "name": "config",
5898
6122
  "type": {
@@ -5908,7 +6132,7 @@
5908
6132
  "immutable": true,
5909
6133
  "locationInModule": {
5910
6134
  "filename": "src/engine/codepipeline/DeploymentPipeline.ts",
5911
- "line": 37
6135
+ "line": 60
5912
6136
  },
5913
6137
  "name": "buildImage",
5914
6138
  "optional": true,
@@ -5926,7 +6150,7 @@
5926
6150
  "immutable": true,
5927
6151
  "locationInModule": {
5928
6152
  "filename": "src/engine/codepipeline/DeploymentPipeline.ts",
5929
- "line": 35
6153
+ "line": 58
5930
6154
  },
5931
6155
  "name": "removalPolicy",
5932
6156
  "optional": true,
@@ -6038,7 +6262,7 @@
6038
6262
  "kind": "interface",
6039
6263
  "locationInModule": {
6040
6264
  "filename": "src/config/build-image.ts",
6041
- "line": 19
6265
+ "line": 81
6042
6266
  },
6043
6267
  "name": "DockerBuildProps",
6044
6268
  "properties": [
@@ -6052,7 +6276,7 @@
6052
6276
  "immutable": true,
6053
6277
  "locationInModule": {
6054
6278
  "filename": "src/config/build-image.ts",
6055
- "line": 21
6279
+ "line": 83
6056
6280
  },
6057
6281
  "name": "dockerfile",
6058
6282
  "optional": true,
@@ -6070,7 +6294,7 @@
6070
6294
  "immutable": true,
6071
6295
  "locationInModule": {
6072
6296
  "filename": "src/config/build-image.ts",
6073
- "line": 27
6297
+ "line": 89
6074
6298
  },
6075
6299
  "name": "repositoryName",
6076
6300
  "optional": true,
@@ -6088,7 +6312,7 @@
6088
6312
  "immutable": true,
6089
6313
  "locationInModule": {
6090
6314
  "filename": "src/config/build-image.ts",
6091
- "line": 29
6315
+ "line": 91
6092
6316
  },
6093
6317
  "name": "tagStrategy",
6094
6318
  "optional": true,
@@ -6342,7 +6566,7 @@
6342
6566
  "kind": "enum",
6343
6567
  "locationInModule": {
6344
6568
  "filename": "src/config/types.ts",
6345
- "line": 44
6569
+ "line": 48
6346
6570
  },
6347
6571
  "members": [
6348
6572
  {
@@ -6416,10 +6640,47 @@
6416
6640
  "kind": "interface",
6417
6641
  "locationInModule": {
6418
6642
  "filename": "src/config/types.ts",
6419
- "line": 71
6643
+ "line": 83
6420
6644
  },
6421
6645
  "name": "GitHubActionsConfig",
6422
6646
  "properties": [
6647
+ {
6648
+ "abstract": true,
6649
+ "docs": {
6650
+ "remarks": "Only external-registry `ci.image` values support this setting. Values are rendered as\n`${{ secrets.NAME }}` expressions; literal credentials are never accepted.",
6651
+ "stability": "experimental",
6652
+ "summary": "GitHub Actions secret names used as the Build-Synth container's registry credentials."
6653
+ },
6654
+ "immutable": true,
6655
+ "locationInModule": {
6656
+ "filename": "src/config/types.ts",
6657
+ "line": 116
6658
+ },
6659
+ "name": "buildContainerCredentials",
6660
+ "optional": true,
6661
+ "type": {
6662
+ "fqn": "@cdklabs/cdk-cicd-wrapper.GitHubBuildContainerCredentials"
6663
+ }
6664
+ },
6665
+ {
6666
+ "abstract": true,
6667
+ "docs": {
6668
+ "default": "false",
6669
+ "remarks": "The workflow file can name an environment, but GitHub does not let CDK configure that\nenvironment's protection rules. The engine therefore fails closed for approval-gated stages\nunless this acknowledgement is explicitly set.",
6670
+ "stability": "experimental",
6671
+ "summary": "Confirms that every generated GitHub Environment used by a stage with `manualApproval: true` has a required-reviewer protection rule configured in GitHub."
6672
+ },
6673
+ "immutable": true,
6674
+ "locationInModule": {
6675
+ "filename": "src/config/types.ts",
6676
+ "line": 127
6677
+ },
6678
+ "name": "environmentProtectionConfigured",
6679
+ "optional": true,
6680
+ "type": {
6681
+ "primitive": "boolean"
6682
+ }
6683
+ },
6423
6684
  {
6424
6685
  "abstract": true,
6425
6686
  "docs": {
@@ -6430,7 +6691,7 @@
6430
6691
  "immutable": true,
6431
6692
  "locationInModule": {
6432
6693
  "filename": "src/config/types.ts",
6433
- "line": 84
6694
+ "line": 96
6434
6695
  },
6435
6696
  "name": "openIdConnectProviderArn",
6436
6697
  "optional": true,
@@ -6441,14 +6702,14 @@
6441
6702
  {
6442
6703
  "abstract": true,
6443
6704
  "docs": {
6444
- "default": "\"us-west-2\"",
6705
+ "default": "- the concrete pipeline stack region",
6445
6706
  "stability": "experimental",
6446
6707
  "summary": "Region the workflow assumes the OIDC role in when publishing assets (NOT the region assets publish to)."
6447
6708
  },
6448
6709
  "immutable": true,
6449
6710
  "locationInModule": {
6450
6711
  "filename": "src/config/types.ts",
6451
- "line": 97
6712
+ "line": 109
6452
6713
  },
6453
6714
  "name": "publishAssetsAuthRegion",
6454
6715
  "optional": true,
@@ -6467,7 +6728,7 @@
6467
6728
  "immutable": true,
6468
6729
  "locationInModule": {
6469
6730
  "filename": "src/config/types.ts",
6470
- "line": 77
6731
+ "line": 89
6471
6732
  },
6472
6733
  "name": "roleName",
6473
6734
  "optional": true,
@@ -6484,7 +6745,7 @@
6484
6745
  "immutable": true,
6485
6746
  "locationInModule": {
6486
6747
  "filename": "src/config/types.ts",
6487
- "line": 82
6748
+ "line": 94
6488
6749
  },
6489
6750
  "name": "subjectClaims",
6490
6751
  "optional": true,
@@ -6507,7 +6768,7 @@
6507
6768
  "immutable": true,
6508
6769
  "locationInModule": {
6509
6770
  "filename": "src/config/types.ts",
6510
- "line": 86
6771
+ "line": 98
6511
6772
  },
6512
6773
  "name": "thumbprints",
6513
6774
  "optional": true,
@@ -6530,7 +6791,7 @@
6530
6791
  "immutable": true,
6531
6792
  "locationInModule": {
6532
6793
  "filename": "src/config/types.ts",
6533
- "line": 90
6794
+ "line": 102
6534
6795
  },
6535
6796
  "name": "workflowName",
6536
6797
  "optional": true,
@@ -6548,7 +6809,7 @@
6548
6809
  "immutable": true,
6549
6810
  "locationInModule": {
6550
6811
  "filename": "src/config/types.ts",
6551
- "line": 88
6812
+ "line": 100
6552
6813
  },
6553
6814
  "name": "workflowPath",
6554
6815
  "optional": true,
@@ -6566,7 +6827,7 @@
6566
6827
  "immutable": true,
6567
6828
  "locationInModule": {
6568
6829
  "filename": "src/config/types.ts",
6569
- "line": 92
6830
+ "line": 104
6570
6831
  },
6571
6832
  "name": "workflowTriggers",
6572
6833
  "optional": true,
@@ -6581,7 +6842,7 @@
6581
6842
  "assembly": "@cdklabs/cdk-cicd-wrapper",
6582
6843
  "base": "constructs.Construct",
6583
6844
  "docs": {
6584
- "remarks": "Reproduces the Blueprint shape: a\n`GitHubActionRole` the workflow assumes over OIDC, a Synth job, and one job (with a GitHub Environment,\nso an environment protection rule set up on GitHub's side gates it) per deployment stage. Manual-approval\nconfig is NOT translated into a CDK step here -- as in Blueprint, GitHub Environments are the gate; every stage\ngets its own environment regardless of `manualApproval`, and gating is configured in the GitHub UI.",
6845
+ "remarks": "Reproduces the Blueprint shape: a\n`GitHubActionRole` the workflow assumes over OIDC, a Synth job, and one job (with a GitHub Environment)\nper deployment stage. GitHub owns the environment protection rules, so approval-gated stages are accepted\nonly when config explicitly acknowledges that required reviewers are configured on those environments.",
6585
6846
  "stability": "experimental",
6586
6847
  "summary": "A GitHub Actions workflow rendered from an Autopilot config + a stage factory."
6587
6848
  },
@@ -6592,7 +6853,7 @@
6592
6853
  },
6593
6854
  "locationInModule": {
6594
6855
  "filename": "src/engine/github/GitHubActionsEngine.ts",
6595
- "line": 63
6856
+ "line": 77
6596
6857
  },
6597
6858
  "parameters": [
6598
6859
  {
@@ -6618,7 +6879,7 @@
6618
6879
  "kind": "class",
6619
6880
  "locationInModule": {
6620
6881
  "filename": "src/engine/github/GitHubActionsEngine.ts",
6621
- "line": 59
6882
+ "line": 73
6622
6883
  },
6623
6884
  "name": "GitHubActionsEngine",
6624
6885
  "properties": [
@@ -6629,7 +6890,7 @@
6629
6890
  "immutable": true,
6630
6891
  "locationInModule": {
6631
6892
  "filename": "src/engine/github/GitHubActionsEngine.ts",
6632
- "line": 61
6893
+ "line": 75
6633
6894
  },
6634
6895
  "name": "gitHubActionRole",
6635
6896
  "type": {
@@ -6643,7 +6904,7 @@
6643
6904
  "immutable": true,
6644
6905
  "locationInModule": {
6645
6906
  "filename": "src/engine/github/GitHubActionsEngine.ts",
6646
- "line": 60
6907
+ "line": 74
6647
6908
  },
6648
6909
  "name": "pipeline",
6649
6910
  "type": {
@@ -6664,7 +6925,7 @@
6664
6925
  "kind": "interface",
6665
6926
  "locationInModule": {
6666
6927
  "filename": "src/engine/github/GitHubActionsEngine.ts",
6667
- "line": 39
6928
+ "line": 54
6668
6929
  },
6669
6930
  "name": "GitHubActionsEngineProps",
6670
6931
  "properties": [
@@ -6678,7 +6939,7 @@
6678
6939
  "immutable": true,
6679
6940
  "locationInModule": {
6680
6941
  "filename": "src/engine/github/GitHubActionsEngine.ts",
6681
- "line": 41
6942
+ "line": 56
6682
6943
  },
6683
6944
  "name": "config",
6684
6945
  "type": {
@@ -6694,7 +6955,7 @@
6694
6955
  "immutable": true,
6695
6956
  "locationInModule": {
6696
6957
  "filename": "src/engine/github/GitHubActionsEngine.ts",
6697
- "line": 43
6958
+ "line": 58
6698
6959
  },
6699
6960
  "name": "stages",
6700
6961
  "type": {
@@ -6710,7 +6971,7 @@
6710
6971
  "immutable": true,
6711
6972
  "locationInModule": {
6712
6973
  "filename": "src/engine/github/GitHubActionsEngine.ts",
6713
- "line": 49
6974
+ "line": 64
6714
6975
  },
6715
6976
  "name": "pipelineName",
6716
6977
  "optional": true,
@@ -6721,19 +6982,69 @@
6721
6982
  ],
6722
6983
  "symbolId": "src/engine/github/GitHubActionsEngine:GitHubActionsEngineProps"
6723
6984
  },
6724
- "@cdklabs/cdk-cicd-wrapper.IEngine": {
6985
+ "@cdklabs/cdk-cicd-wrapper.GitHubBuildContainerCredentials": {
6725
6986
  "assembly": "@cdklabs/cdk-cicd-wrapper",
6987
+ "datatype": true,
6726
6988
  "docs": {
6727
6989
  "stability": "experimental",
6728
- "summary": "Renders a resolved cicd config into a concrete pipeline."
6990
+ "summary": "GitHub secret names used to authenticate the Build-Synth job container to an external registry."
6729
6991
  },
6730
- "fqn": "@cdklabs/cdk-cicd-wrapper.IEngine",
6992
+ "fqn": "@cdklabs/cdk-cicd-wrapper.GitHubBuildContainerCredentials",
6731
6993
  "kind": "interface",
6732
6994
  "locationInModule": {
6733
- "filename": "src/engine/types.ts",
6734
- "line": 22
6995
+ "filename": "src/config/types.ts",
6996
+ "line": 70
6735
6997
  },
6736
- "methods": [
6998
+ "name": "GitHubBuildContainerCredentials",
6999
+ "properties": [
7000
+ {
7001
+ "abstract": true,
7002
+ "docs": {
7003
+ "stability": "experimental",
7004
+ "summary": "GitHub Actions secret containing the registry password or access token."
7005
+ },
7006
+ "immutable": true,
7007
+ "locationInModule": {
7008
+ "filename": "src/config/types.ts",
7009
+ "line": 74
7010
+ },
7011
+ "name": "passwordSecretName",
7012
+ "type": {
7013
+ "primitive": "string"
7014
+ }
7015
+ },
7016
+ {
7017
+ "abstract": true,
7018
+ "docs": {
7019
+ "stability": "experimental",
7020
+ "summary": "GitHub Actions secret containing the registry username."
7021
+ },
7022
+ "immutable": true,
7023
+ "locationInModule": {
7024
+ "filename": "src/config/types.ts",
7025
+ "line": 72
7026
+ },
7027
+ "name": "usernameSecretName",
7028
+ "type": {
7029
+ "primitive": "string"
7030
+ }
7031
+ }
7032
+ ],
7033
+ "symbolId": "src/config/types:GitHubBuildContainerCredentials"
7034
+ },
7035
+ "@cdklabs/cdk-cicd-wrapper.IEngine": {
7036
+ "assembly": "@cdklabs/cdk-cicd-wrapper",
7037
+ "docs": {
7038
+ "stability": "experimental",
7039
+ "summary": "Renders a resolved cicd config into a concrete pipeline."
7040
+ },
7041
+ "fqn": "@cdklabs/cdk-cicd-wrapper.IEngine",
7042
+ "kind": "interface",
7043
+ "locationInModule": {
7044
+ "filename": "src/engine/types.ts",
7045
+ "line": 22
7046
+ },
7047
+ "methods": [
6737
7048
  {
6738
7049
  "abstract": true,
6739
7050
  "docs": {
@@ -6775,7 +7086,7 @@
6775
7086
  "kind": "interface",
6776
7087
  "locationInModule": {
6777
7088
  "filename": "src/engine/cdkpipelines/CdkPipelinesEngine.ts",
6778
- "line": 44
7089
+ "line": 66
6779
7090
  },
6780
7091
  "methods": [
6781
7092
  {
@@ -6786,7 +7097,7 @@
6786
7097
  },
6787
7098
  "locationInModule": {
6788
7099
  "filename": "src/engine/cdkpipelines/CdkPipelinesEngine.ts",
6789
- "line": 46
7100
+ "line": 68
6790
7101
  },
6791
7102
  "name": "stacks",
6792
7103
  "parameters": [
@@ -6818,14 +7129,14 @@
6818
7129
  "kind": "enum",
6819
7130
  "locationInModule": {
6820
7131
  "filename": "src/config/build-image.ts",
6821
- "line": 11
7132
+ "line": 70
6822
7133
  },
6823
7134
  "members": [
6824
7135
  {
6825
7136
  "docs": {
6826
7137
  "remarks": "The default.",
6827
7138
  "stability": "experimental",
6828
- "summary": "Tag with the resolved source commit sha (CODEBUILD_RESOLVED_SOURCE_VERSION)."
7139
+ "summary": "Tag with the resolved Git commit SHA, or a deterministic SHA-256 of a non-Git source revision."
6829
7140
  },
6830
7141
  "name": "GIT_SHA"
6831
7142
  },
@@ -7039,7 +7350,7 @@
7039
7350
  "kind": "interface",
7040
7351
  "locationInModule": {
7041
7352
  "filename": "src/config/types.ts",
7042
- "line": 203
7353
+ "line": 253
7043
7354
  },
7044
7355
  "name": "ManagedVpcConfig",
7045
7356
  "properties": [
@@ -7053,7 +7364,7 @@
7053
7364
  "immutable": true,
7054
7365
  "locationInModule": {
7055
7366
  "filename": "src/config/types.ts",
7056
- "line": 222
7367
+ "line": 272
7057
7368
  },
7058
7369
  "name": "allowAllOutbound",
7059
7370
  "optional": true,
@@ -7071,7 +7382,7 @@
7071
7382
  "immutable": true,
7072
7383
  "locationInModule": {
7073
7384
  "filename": "src/config/types.ts",
7074
- "line": 205
7385
+ "line": 255
7075
7386
  },
7076
7387
  "name": "cidrBlock",
7077
7388
  "optional": true,
@@ -7089,7 +7400,7 @@
7089
7400
  "immutable": true,
7090
7401
  "locationInModule": {
7091
7402
  "filename": "src/config/types.ts",
7092
- "line": 233
7403
+ "line": 283
7093
7404
  },
7094
7405
  "name": "codeBuildVpcInterfaces",
7095
7406
  "optional": true,
@@ -7112,7 +7423,7 @@
7112
7423
  "immutable": true,
7113
7424
  "locationInModule": {
7114
7425
  "filename": "src/config/types.ts",
7115
- "line": 228
7426
+ "line": 278
7116
7427
  },
7117
7428
  "name": "flowLogsBucketName",
7118
7429
  "optional": true,
@@ -7130,7 +7441,7 @@
7130
7441
  "immutable": true,
7131
7442
  "locationInModule": {
7132
7443
  "filename": "src/config/types.ts",
7133
- "line": 209
7444
+ "line": 259
7134
7445
  },
7135
7446
  "name": "maxAzs",
7136
7447
  "optional": true,
@@ -7148,7 +7459,7 @@
7148
7459
  "immutable": true,
7149
7460
  "locationInModule": {
7150
7461
  "filename": "src/config/types.ts",
7151
- "line": 220
7462
+ "line": 270
7152
7463
  },
7153
7464
  "name": "restrictDefaultSecurityGroup",
7154
7465
  "optional": true,
@@ -7166,7 +7477,7 @@
7166
7477
  "immutable": true,
7167
7478
  "locationInModule": {
7168
7479
  "filename": "src/config/types.ts",
7169
- "line": 207
7480
+ "line": 257
7170
7481
  },
7171
7482
  "name": "subnetCidrMask",
7172
7483
  "optional": true,
@@ -7184,7 +7495,7 @@
7184
7495
  "immutable": true,
7185
7496
  "locationInModule": {
7186
7497
  "filename": "src/config/types.ts",
7187
- "line": 215
7498
+ "line": 265
7188
7499
  },
7189
7500
  "name": "subnetType",
7190
7501
  "optional": true,
@@ -7199,7 +7510,7 @@
7199
7510
  "assembly": "@cdklabs/cdk-cicd-wrapper",
7200
7511
  "datatype": true,
7201
7512
  "docs": {
7202
- "remarks": "Unlike `CodeArtifactConfig` (an `aws codeartifact login`), this covers\nany npm-compatible registry: when set, every build project writes a `.npmrc` -- scoped to `scope` when\ngiven, otherwise overriding the default registry -- with an auth token read from Secrets Manager.",
7513
+ "remarks": "Unlike `CodeArtifactConfig` (an `aws codeartifact login`), this covers\nany npm-compatible registry: jobs that install packages use a temporary npm config outside the source\ncheckout -- scoped to `scope` when given, otherwise overriding the default registry -- with an auth\ntoken read from Secrets Manager.",
7203
7514
  "stability": "experimental",
7204
7515
  "summary": "A generic private npm registry the pipeline's builds authenticate against with a bearer token (Blueprint `NPMRegistryConfig`, migrated)."
7205
7516
  },
@@ -7207,7 +7518,7 @@
7207
7518
  "kind": "interface",
7208
7519
  "locationInModule": {
7209
7520
  "filename": "src/config/types.ts",
7210
- "line": 190
7521
+ "line": 238
7211
7522
  },
7212
7523
  "name": "NpmRegistryConfig",
7213
7524
  "properties": [
@@ -7220,7 +7531,7 @@
7220
7531
  "immutable": true,
7221
7532
  "locationInModule": {
7222
7533
  "filename": "src/config/types.ts",
7223
- "line": 194
7534
+ "line": 242
7224
7535
  },
7225
7536
  "name": "basicAuthSecretArn",
7226
7537
  "type": {
@@ -7236,13 +7547,30 @@
7236
7547
  "immutable": true,
7237
7548
  "locationInModule": {
7238
7549
  "filename": "src/config/types.ts",
7239
- "line": 192
7550
+ "line": 240
7240
7551
  },
7241
7552
  "name": "url",
7242
7553
  "type": {
7243
7554
  "primitive": "string"
7244
7555
  }
7245
7556
  },
7557
+ {
7558
+ "abstract": true,
7559
+ "docs": {
7560
+ "stability": "experimental",
7561
+ "summary": "Customer-managed KMS key encrypting `basicAuthSecretArn`, when one is used."
7562
+ },
7563
+ "immutable": true,
7564
+ "locationInModule": {
7565
+ "filename": "src/config/types.ts",
7566
+ "line": 244
7567
+ },
7568
+ "name": "encryptionKeyArn",
7569
+ "optional": true,
7570
+ "type": {
7571
+ "primitive": "string"
7572
+ }
7573
+ },
7246
7574
  {
7247
7575
  "abstract": true,
7248
7576
  "docs": {
@@ -7252,7 +7580,7 @@
7252
7580
  "immutable": true,
7253
7581
  "locationInModule": {
7254
7582
  "filename": "src/config/types.ts",
7255
- "line": 196
7583
+ "line": 246
7256
7584
  },
7257
7585
  "name": "scope",
7258
7586
  "optional": true,
@@ -7278,7 +7606,7 @@
7278
7606
  },
7279
7607
  "locationInModule": {
7280
7608
  "filename": "src/app/PipelineApp.ts",
7281
- "line": 59
7609
+ "line": 62
7282
7610
  },
7283
7611
  "parameters": [
7284
7612
  {
@@ -7292,7 +7620,7 @@
7292
7620
  "kind": "class",
7293
7621
  "locationInModule": {
7294
7622
  "filename": "src/app/PipelineApp.ts",
7295
- "line": 55
7623
+ "line": 58
7296
7624
  },
7297
7625
  "name": "PipelineApp",
7298
7626
  "properties": [
@@ -7305,7 +7633,7 @@
7305
7633
  "immutable": true,
7306
7634
  "locationInModule": {
7307
7635
  "filename": "src/app/PipelineApp.ts",
7308
- "line": 57
7636
+ "line": 60
7309
7637
  },
7310
7638
  "name": "pipelineStack",
7311
7639
  "type": {
@@ -7326,7 +7654,7 @@
7326
7654
  "kind": "interface",
7327
7655
  "locationInModule": {
7328
7656
  "filename": "src/app/PipelineApp.ts",
7329
- "line": 37
7657
+ "line": 40
7330
7658
  },
7331
7659
  "name": "PipelineAppProps",
7332
7660
  "properties": [
@@ -7339,7 +7667,7 @@
7339
7667
  "immutable": true,
7340
7668
  "locationInModule": {
7341
7669
  "filename": "src/app/PipelineApp.ts",
7342
- "line": 39
7670
+ "line": 42
7343
7671
  },
7344
7672
  "name": "config",
7345
7673
  "type": {
@@ -7356,7 +7684,7 @@
7356
7684
  "immutable": true,
7357
7685
  "locationInModule": {
7358
7686
  "filename": "src/app/PipelineApp.ts",
7359
- "line": 45
7687
+ "line": 48
7360
7688
  },
7361
7689
  "name": "disposable",
7362
7690
  "optional": true,
@@ -7378,7 +7706,7 @@
7378
7706
  "kind": "interface",
7379
7707
  "locationInModule": {
7380
7708
  "filename": "src/config/types.ts",
7381
- "line": 284
7709
+ "line": 339
7382
7710
  },
7383
7711
  "name": "PipelineRoleNames",
7384
7712
  "properties": [
@@ -7391,7 +7719,7 @@
7391
7719
  "immutable": true,
7392
7720
  "locationInModule": {
7393
7721
  "filename": "src/config/types.ts",
7394
- "line": 290
7722
+ "line": 345
7395
7723
  },
7396
7724
  "name": "assetsDocker",
7397
7725
  "optional": true,
@@ -7408,7 +7736,7 @@
7408
7736
  "immutable": true,
7409
7737
  "locationInModule": {
7410
7738
  "filename": "src/config/types.ts",
7411
- "line": 288
7739
+ "line": 343
7412
7740
  },
7413
7741
  "name": "assetsFile",
7414
7742
  "optional": true,
@@ -7425,7 +7753,7 @@
7425
7753
  "immutable": true,
7426
7754
  "locationInModule": {
7427
7755
  "filename": "src/config/types.ts",
7428
- "line": 286
7756
+ "line": 341
7429
7757
  },
7430
7758
  "name": "pipeline",
7431
7759
  "optional": true,
@@ -7500,7 +7828,7 @@
7500
7828
  "kind": "interface",
7501
7829
  "locationInModule": {
7502
7830
  "filename": "src/config/types.ts",
7503
- "line": 169
7831
+ "line": 214
7504
7832
  },
7505
7833
  "name": "ProxyConfig",
7506
7834
  "properties": [
@@ -7514,7 +7842,7 @@
7514
7842
  "immutable": true,
7515
7843
  "locationInModule": {
7516
7844
  "filename": "src/config/types.ts",
7517
- "line": 179
7845
+ "line": 226
7518
7846
  },
7519
7847
  "name": "noProxy",
7520
7848
  "type": {
@@ -7535,7 +7863,7 @@
7535
7863
  "immutable": true,
7536
7864
  "locationInModule": {
7537
7865
  "filename": "src/config/types.ts",
7538
- "line": 174
7866
+ "line": 219
7539
7867
  },
7540
7868
  "name": "proxySecretArn",
7541
7869
  "type": {
@@ -7551,12 +7879,29 @@
7551
7879
  "immutable": true,
7552
7880
  "locationInModule": {
7553
7881
  "filename": "src/config/types.ts",
7554
- "line": 181
7882
+ "line": 228
7555
7883
  },
7556
7884
  "name": "proxyTestUrl",
7557
7885
  "type": {
7558
7886
  "primitive": "string"
7559
7887
  }
7888
+ },
7889
+ {
7890
+ "abstract": true,
7891
+ "docs": {
7892
+ "stability": "experimental",
7893
+ "summary": "Customer-managed KMS key encrypting `proxySecretArn`, when one is used."
7894
+ },
7895
+ "immutable": true,
7896
+ "locationInModule": {
7897
+ "filename": "src/config/types.ts",
7898
+ "line": 221
7899
+ },
7900
+ "name": "encryptionKeyArn",
7901
+ "optional": true,
7902
+ "type": {
7903
+ "primitive": "string"
7904
+ }
7560
7905
  }
7561
7906
  ],
7562
7907
  "symbolId": "src/config/types:ProxyConfig"
@@ -8024,7 +8369,7 @@
8024
8369
  "kind": "interface",
8025
8370
  "locationInModule": {
8026
8371
  "filename": "src/config/types.ts",
8027
- "line": 329
8372
+ "line": 391
8028
8373
  },
8029
8374
  "name": "ResolvedCicdConfig",
8030
8375
  "properties": [
@@ -8038,7 +8383,7 @@
8038
8383
  "immutable": true,
8039
8384
  "locationInModule": {
8040
8385
  "filename": "src/config/types.ts",
8041
- "line": 427
8386
+ "line": 500
8042
8387
  },
8043
8388
  "name": "asyncDeploy",
8044
8389
  "type": {
@@ -8054,7 +8399,7 @@
8054
8399
  "immutable": true,
8055
8400
  "locationInModule": {
8056
8401
  "filename": "src/config/types.ts",
8057
- "line": 374
8402
+ "line": 437
8058
8403
  },
8059
8404
  "name": "ci",
8060
8405
  "type": {
@@ -8071,7 +8416,7 @@
8071
8416
  "immutable": true,
8072
8417
  "locationInModule": {
8073
8418
  "filename": "src/config/types.ts",
8074
- "line": 412
8419
+ "line": 485
8075
8420
  },
8076
8421
  "name": "deployModel",
8077
8422
  "type": {
@@ -8088,7 +8433,7 @@
8088
8433
  "immutable": true,
8089
8434
  "locationInModule": {
8090
8435
  "filename": "src/config/types.ts",
8091
- "line": 354
8436
+ "line": 416
8092
8437
  },
8093
8438
  "name": "engine",
8094
8439
  "type": {
@@ -8104,7 +8449,7 @@
8104
8449
  "immutable": true,
8105
8450
  "locationInModule": {
8106
8451
  "filename": "src/config/types.ts",
8107
- "line": 348
8452
+ "line": 410
8108
8453
  },
8109
8454
  "name": "repository",
8110
8455
  "type": {
@@ -8120,7 +8465,7 @@
8120
8465
  "immutable": true,
8121
8466
  "locationInModule": {
8122
8467
  "filename": "src/config/types.ts",
8123
- "line": 350
8468
+ "line": 412
8124
8469
  },
8125
8470
  "name": "stages",
8126
8471
  "type": {
@@ -8141,7 +8486,7 @@
8141
8486
  "immutable": true,
8142
8487
  "locationInModule": {
8143
8488
  "filename": "src/config/types.ts",
8144
- "line": 352
8489
+ "line": 414
8145
8490
  },
8146
8491
  "name": "synthesizer",
8147
8492
  "type": {
@@ -8151,14 +8496,14 @@
8151
8496
  {
8152
8497
  "abstract": true,
8153
8498
  "docs": {
8154
- "remarks": "drives the bootstrap qualifier and asset naming.",
8499
+ "remarks": "drives the derived bootstrap qualifier and asset naming.",
8155
8500
  "stability": "experimental",
8156
8501
  "summary": "Application name;"
8157
8502
  },
8158
8503
  "immutable": true,
8159
8504
  "locationInModule": {
8160
8505
  "filename": "src/config/types.ts",
8161
- "line": 331
8506
+ "line": 393
8162
8507
  },
8163
8508
  "name": "application",
8164
8509
  "optional": true,
@@ -8175,7 +8520,7 @@
8175
8520
  "immutable": true,
8176
8521
  "locationInModule": {
8177
8522
  "filename": "src/config/types.ts",
8178
- "line": 376
8523
+ "line": 439
8179
8524
  },
8180
8525
  "name": "codeArtifact",
8181
8526
  "optional": true,
@@ -8192,7 +8537,7 @@
8192
8537
  "immutable": true,
8193
8538
  "locationInModule": {
8194
8539
  "filename": "src/config/types.ts",
8195
- "line": 410
8540
+ "line": 483
8196
8541
  },
8197
8542
  "name": "codeBuildEnvSettings",
8198
8543
  "optional": true,
@@ -8210,7 +8555,7 @@
8210
8555
  "immutable": true,
8211
8556
  "locationInModule": {
8212
8557
  "filename": "src/config/types.ts",
8213
- "line": 366
8558
+ "line": 428
8214
8559
  },
8215
8560
  "name": "codePipelineRoleNames",
8216
8561
  "optional": true,
@@ -8228,7 +8573,7 @@
8228
8573
  "immutable": true,
8229
8574
  "locationInModule": {
8230
8575
  "filename": "src/config/types.ts",
8231
- "line": 400
8576
+ "line": 463
8232
8577
  },
8233
8578
  "name": "complianceLogBucketName",
8234
8579
  "optional": true,
@@ -8236,6 +8581,25 @@
8236
8581
  "primitive": "string"
8237
8582
  }
8238
8583
  },
8584
+ {
8585
+ "abstract": true,
8586
+ "docs": {
8587
+ "default": "true",
8588
+ "remarks": "Set to `false` during a Blueprint migration to reference an existing, owner-managed bucket.\nThe pipeline then creates neither the bucket nor its bucket policy; the bucket owner must keep\nthe encryption, TLS-enforcement, and S3 server-access-log delivery policy in place.",
8589
+ "stability": "experimental",
8590
+ "summary": "Whether the pipeline stack creates and manages `complianceLogBucketName`."
8591
+ },
8592
+ "immutable": true,
8593
+ "locationInModule": {
8594
+ "filename": "src/config/types.ts",
8595
+ "line": 473
8596
+ },
8597
+ "name": "createComplianceLogBucket",
8598
+ "optional": true,
8599
+ "type": {
8600
+ "primitive": "boolean"
8601
+ }
8602
+ },
8239
8603
  {
8240
8604
  "abstract": true,
8241
8605
  "docs": {
@@ -8246,7 +8610,7 @@
8246
8610
  "immutable": true,
8247
8611
  "locationInModule": {
8248
8612
  "filename": "src/config/types.ts",
8249
- "line": 418
8613
+ "line": 491
8250
8614
  },
8251
8615
  "name": "deployerImage",
8252
8616
  "optional": true,
@@ -8257,14 +8621,14 @@
8257
8621
  {
8258
8622
  "abstract": true,
8259
8623
  "docs": {
8260
- "remarks": "A stage's\nown `DeploymentConfig.externalId` overrides this. A literal or a `resolve:secretsmanager:<arn>`\nreference resolved at synth time.",
8624
+ "remarks": "A stage's\nown `DeploymentConfig.externalId` overrides this. A literal or a `resolve:secretsmanager:<arn>`\nreference resolved at synth time. Secret references currently require the Secrets Manager\nAWS-managed encryption key; customer-managed KMS keys are not supported without an external grant.",
8261
8625
  "stability": "experimental",
8262
8626
  "summary": "Pipeline-level default ExternalId presented when assuming a stage's forced `deployRole`."
8263
8627
  },
8264
8628
  "immutable": true,
8265
8629
  "locationInModule": {
8266
8630
  "filename": "src/config/types.ts",
8267
- "line": 372
8631
+ "line": 435
8268
8632
  },
8269
8633
  "name": "deployRoleExternalId",
8270
8634
  "optional": true,
@@ -8282,7 +8646,7 @@
8282
8646
  "immutable": true,
8283
8647
  "locationInModule": {
8284
8648
  "filename": "src/config/types.ts",
8285
- "line": 437
8649
+ "line": 510
8286
8650
  },
8287
8651
  "name": "express",
8288
8652
  "optional": true,
@@ -8300,7 +8664,7 @@
8300
8664
  "immutable": true,
8301
8665
  "locationInModule": {
8302
8666
  "filename": "src/config/types.ts",
8303
- "line": 356
8667
+ "line": 418
8304
8668
  },
8305
8669
  "name": "githubActions",
8306
8670
  "optional": true,
@@ -8317,7 +8681,7 @@
8317
8681
  "immutable": true,
8318
8682
  "locationInModule": {
8319
8683
  "filename": "src/config/types.ts",
8320
- "line": 378
8684
+ "line": 441
8321
8685
  },
8322
8686
  "name": "npmRegistry",
8323
8687
  "optional": true,
@@ -8335,7 +8699,7 @@
8335
8699
  "immutable": true,
8336
8700
  "locationInModule": {
8337
8701
  "filename": "src/config/types.ts",
8338
- "line": 361
8702
+ "line": 423
8339
8703
  },
8340
8704
  "name": "pipelineRoleNames",
8341
8705
  "optional": true,
@@ -8354,7 +8718,7 @@
8354
8718
  "immutable": true,
8355
8719
  "locationInModule": {
8356
8720
  "filename": "src/config/types.ts",
8357
- "line": 346
8721
+ "line": 408
8358
8722
  },
8359
8723
  "name": "pipelineStackName",
8360
8724
  "optional": true,
@@ -8372,7 +8736,7 @@
8372
8736
  "immutable": true,
8373
8737
  "locationInModule": {
8374
8738
  "filename": "src/config/types.ts",
8375
- "line": 444
8739
+ "line": 517
8376
8740
  },
8377
8741
  "name": "plugins",
8378
8742
  "optional": true,
@@ -8394,7 +8758,7 @@
8394
8758
  "immutable": true,
8395
8759
  "locationInModule": {
8396
8760
  "filename": "src/config/types.ts",
8397
- "line": 380
8761
+ "line": 443
8398
8762
  },
8399
8763
  "name": "proxy",
8400
8764
  "optional": true,
@@ -8411,7 +8775,7 @@
8411
8775
  "immutable": true,
8412
8776
  "locationInModule": {
8413
8777
  "filename": "src/config/types.ts",
8414
- "line": 333
8778
+ "line": 395
8415
8779
  },
8416
8780
  "name": "qualifier",
8417
8781
  "optional": true,
@@ -8428,7 +8792,7 @@
8428
8792
  "immutable": true,
8429
8793
  "locationInModule": {
8430
8794
  "filename": "src/config/types.ts",
8431
- "line": 394
8795
+ "line": 457
8432
8796
  },
8433
8797
  "name": "vpc",
8434
8798
  "optional": true,
@@ -8445,7 +8809,7 @@
8445
8809
  "immutable": true,
8446
8810
  "locationInModule": {
8447
8811
  "filename": "src/config/types.ts",
8448
- "line": 392
8812
+ "line": 455
8449
8813
  },
8450
8814
  "name": "warmAccountsFromSsm",
8451
8815
  "optional": true,
@@ -8468,7 +8832,7 @@
8468
8832
  "kind": "interface",
8469
8833
  "locationInModule": {
8470
8834
  "filename": "src/config/types.ts",
8471
- "line": 475
8835
+ "line": 558
8472
8836
  },
8473
8837
  "name": "ResolvedDeploymentConfig",
8474
8838
  "properties": [
@@ -8481,7 +8845,7 @@
8481
8845
  "immutable": true,
8482
8846
  "locationInModule": {
8483
8847
  "filename": "src/config/types.ts",
8484
- "line": 483
8848
+ "line": 590
8485
8849
  },
8486
8850
  "name": "targets",
8487
8851
  "type": {
@@ -8493,6 +8857,24 @@
8493
8857
  }
8494
8858
  }
8495
8859
  },
8860
+ {
8861
+ "abstract": true,
8862
+ "docs": {
8863
+ "remarks": "Optional for the default synthesizer; required\n(or supply `synthesizer.appId`) when the image uses `APP_STAGING` for direct `deploy --from-image`.\nThe generated Repo 2 CodePipeline itself supports only `DEFAULT`. Direct APP_STAGING targets can\nconfigure deployment roles, but cannot attach an ExternalId to the deployment role.",
8864
+ "stability": "experimental",
8865
+ "summary": "Application name baked into the deployer image."
8866
+ },
8867
+ "immutable": true,
8868
+ "locationInModule": {
8869
+ "filename": "src/config/types.ts",
8870
+ "line": 565
8871
+ },
8872
+ "name": "application",
8873
+ "optional": true,
8874
+ "type": {
8875
+ "primitive": "string"
8876
+ }
8877
+ },
8496
8878
  {
8497
8879
  "abstract": true,
8498
8880
  "docs": {
@@ -8503,7 +8885,7 @@
8503
8885
  "immutable": true,
8504
8886
  "locationInModule": {
8505
8887
  "filename": "src/config/types.ts",
8506
- "line": 495
8888
+ "line": 602
8507
8889
  },
8508
8890
  "name": "codeArtifact",
8509
8891
  "optional": true,
@@ -8511,6 +8893,42 @@
8511
8893
  "fqn": "@cdklabs/cdk-cicd-wrapper.CodeArtifactConfig"
8512
8894
  }
8513
8895
  },
8896
+ {
8897
+ "abstract": true,
8898
+ "docs": {
8899
+ "remarks": "Repo 2 references an existing bucket; it does not create one. A target using this default must\nhave a concrete account and exactly one concrete Region so S3's same-account/same-Region delivery\nrequirement can be verified. Targets in other environments may override the name individually.",
8900
+ "stability": "experimental",
8901
+ "summary": "Default compliance/access-log destination bucket name for targets that do not provide their own."
8902
+ },
8903
+ "immutable": true,
8904
+ "locationInModule": {
8905
+ "filename": "src/config/types.ts",
8906
+ "line": 588
8907
+ },
8908
+ "name": "complianceLogBucketName",
8909
+ "optional": true,
8910
+ "type": {
8911
+ "primitive": "string"
8912
+ }
8913
+ },
8914
+ {
8915
+ "abstract": true,
8916
+ "docs": {
8917
+ "default": "false",
8918
+ "stability": "experimental",
8919
+ "summary": "Confirms that owner-side repository policies permit the generated pipeline role to pull every cross-account ECR image referenced by this deployment config."
8920
+ },
8921
+ "immutable": true,
8922
+ "locationInModule": {
8923
+ "filename": "src/config/types.ts",
8924
+ "line": 614
8925
+ },
8926
+ "name": "crossAccountEcrRepositoryPolicyConfigured",
8927
+ "optional": true,
8928
+ "type": {
8929
+ "primitive": "boolean"
8930
+ }
8931
+ },
8514
8932
  {
8515
8933
  "abstract": true,
8516
8934
  "docs": {
@@ -8521,7 +8939,7 @@
8521
8939
  "immutable": true,
8522
8940
  "locationInModule": {
8523
8941
  "filename": "src/config/types.ts",
8524
- "line": 481
8942
+ "line": 580
8525
8943
  },
8526
8944
  "name": "image",
8527
8945
  "optional": true,
@@ -8539,7 +8957,7 @@
8539
8957
  "immutable": true,
8540
8958
  "locationInModule": {
8541
8959
  "filename": "src/config/types.ts",
8542
- "line": 500
8960
+ "line": 607
8543
8961
  },
8544
8962
  "name": "npmRegistry",
8545
8963
  "optional": true,
@@ -8547,6 +8965,24 @@
8547
8965
  "fqn": "@cdklabs/cdk-cicd-wrapper.NpmRegistryConfig"
8548
8966
  }
8549
8967
  },
8968
+ {
8969
+ "abstract": true,
8970
+ "docs": {
8971
+ "remarks": "derived from `application` when omitted.",
8972
+ "stability": "experimental",
8973
+ "summary": "Bootstrap qualifier used by the deployer image;"
8974
+ },
8975
+ "immutable": true,
8976
+ "locationInModule": {
8977
+ "filename": "src/config/types.ts",
8978
+ "line": 567
8979
+ },
8980
+ "name": "qualifier",
8981
+ "optional": true,
8982
+ "type": {
8983
+ "primitive": "string"
8984
+ }
8985
+ },
8550
8986
  {
8551
8987
  "abstract": true,
8552
8988
  "docs": {
@@ -8556,13 +8992,31 @@
8556
8992
  "immutable": true,
8557
8993
  "locationInModule": {
8558
8994
  "filename": "src/config/types.ts",
8559
- "line": 490
8995
+ "line": 597
8560
8996
  },
8561
8997
  "name": "repository",
8562
8998
  "optional": true,
8563
8999
  "type": {
8564
9000
  "fqn": "@cdklabs/cdk-cicd-wrapper.Repository"
8565
9001
  }
9002
+ },
9003
+ {
9004
+ "abstract": true,
9005
+ "docs": {
9006
+ "remarks": "Optional for compatibility with pre-synthesizer Repo 2 configs; consumers must treat omission\nas `SynthesizerType.DEFAULT`.",
9007
+ "stability": "experimental",
9008
+ "summary": "Synthesizer used by the deployer image; must match its `cicd.config`."
9009
+ },
9010
+ "immutable": true,
9011
+ "locationInModule": {
9012
+ "filename": "src/config/types.ts",
9013
+ "line": 574
9014
+ },
9015
+ "name": "synthesizer",
9016
+ "optional": true,
9017
+ "type": {
9018
+ "fqn": "@cdklabs/cdk-cicd-wrapper.SynthesizerConfig"
9019
+ }
8566
9020
  }
8567
9021
  ],
8568
9022
  "symbolId": "src/config/types:ResolvedDeploymentConfig"
@@ -8579,7 +9033,7 @@
8579
9033
  "kind": "interface",
8580
9034
  "locationInModule": {
8581
9035
  "filename": "src/config/types.ts",
8582
- "line": 453
9036
+ "line": 526
8583
9037
  },
8584
9038
  "name": "ResolvedDeploymentTarget",
8585
9039
  "properties": [
@@ -8592,7 +9046,7 @@
8592
9046
  "immutable": true,
8593
9047
  "locationInModule": {
8594
9048
  "filename": "src/config/types.ts",
8595
- "line": 457
9049
+ "line": 530
8596
9050
  },
8597
9051
  "name": "env",
8598
9052
  "type": {
@@ -8608,7 +9062,7 @@
8608
9062
  "immutable": true,
8609
9063
  "locationInModule": {
8610
9064
  "filename": "src/config/types.ts",
8611
- "line": 459
9065
+ "line": 532
8612
9066
  },
8613
9067
  "name": "manualApproval",
8614
9068
  "type": {
@@ -8624,13 +9078,65 @@
8624
9078
  "immutable": true,
8625
9079
  "locationInModule": {
8626
9080
  "filename": "src/config/types.ts",
8627
- "line": 455
9081
+ "line": 528
8628
9082
  },
8629
9083
  "name": "stage",
8630
9084
  "type": {
8631
9085
  "primitive": "string"
8632
9086
  }
8633
9087
  },
9088
+ {
9089
+ "abstract": true,
9090
+ "docs": {
9091
+ "stability": "experimental",
9092
+ "summary": "Account containing `complianceLogBucketName`."
9093
+ },
9094
+ "immutable": true,
9095
+ "locationInModule": {
9096
+ "filename": "src/config/types.ts",
9097
+ "line": 548
9098
+ },
9099
+ "name": "complianceLogBucketAccount",
9100
+ "optional": true,
9101
+ "type": {
9102
+ "primitive": "string"
9103
+ }
9104
+ },
9105
+ {
9106
+ "abstract": true,
9107
+ "docs": {
9108
+ "remarks": "When set, `complianceLogBucketAccount` and `complianceLogBucketRegion` are also set and\nexactly match this target's concrete, single-Region environment.",
9109
+ "stability": "experimental",
9110
+ "summary": "Compliance/access-log destination bucket for this target, after applying the deployment-wide default."
9111
+ },
9112
+ "immutable": true,
9113
+ "locationInModule": {
9114
+ "filename": "src/config/types.ts",
9115
+ "line": 546
9116
+ },
9117
+ "name": "complianceLogBucketName",
9118
+ "optional": true,
9119
+ "type": {
9120
+ "primitive": "string"
9121
+ }
9122
+ },
9123
+ {
9124
+ "abstract": true,
9125
+ "docs": {
9126
+ "stability": "experimental",
9127
+ "summary": "Region containing `complianceLogBucketName`."
9128
+ },
9129
+ "immutable": true,
9130
+ "locationInModule": {
9131
+ "filename": "src/config/types.ts",
9132
+ "line": 550
9133
+ },
9134
+ "name": "complianceLogBucketRegion",
9135
+ "optional": true,
9136
+ "type": {
9137
+ "primitive": "string"
9138
+ }
9139
+ },
8634
9140
  {
8635
9141
  "abstract": true,
8636
9142
  "docs": {
@@ -8640,7 +9146,7 @@
8640
9146
  "immutable": true,
8641
9147
  "locationInModule": {
8642
9148
  "filename": "src/config/types.ts",
8643
- "line": 461
9149
+ "line": 534
8644
9150
  },
8645
9151
  "name": "deployment",
8646
9152
  "optional": true,
@@ -8658,7 +9164,7 @@
8658
9164
  "immutable": true,
8659
9165
  "locationInModule": {
8660
9166
  "filename": "src/config/types.ts",
8661
- "line": 467
9167
+ "line": 540
8662
9168
  },
8663
9169
  "name": "image",
8664
9170
  "optional": true,
@@ -8680,7 +9186,7 @@
8680
9186
  "kind": "interface",
8681
9187
  "locationInModule": {
8682
9188
  "filename": "src/config/types.ts",
8683
- "line": 311
9189
+ "line": 368
8684
9190
  },
8685
9191
  "name": "ResolvedStage",
8686
9192
  "properties": [
@@ -8693,7 +9199,7 @@
8693
9199
  "immutable": true,
8694
9200
  "locationInModule": {
8695
9201
  "filename": "src/config/types.ts",
8696
- "line": 315
9202
+ "line": 372
8697
9203
  },
8698
9204
  "name": "env",
8699
9205
  "type": {
@@ -8709,7 +9215,7 @@
8709
9215
  "immutable": true,
8710
9216
  "locationInModule": {
8711
9217
  "filename": "src/config/types.ts",
8712
- "line": 317
9218
+ "line": 374
8713
9219
  },
8714
9220
  "name": "manualApproval",
8715
9221
  "type": {
@@ -8725,7 +9231,7 @@
8725
9231
  "immutable": true,
8726
9232
  "locationInModule": {
8727
9233
  "filename": "src/config/types.ts",
8728
- "line": 313
9234
+ "line": 370
8729
9235
  },
8730
9236
  "name": "name",
8731
9237
  "type": {
@@ -8741,7 +9247,7 @@
8741
9247
  "immutable": true,
8742
9248
  "locationInModule": {
8743
9249
  "filename": "src/config/types.ts",
8744
- "line": 319
9250
+ "line": 376
8745
9251
  },
8746
9252
  "name": "deployment",
8747
9253
  "optional": true,
@@ -8809,7 +9315,7 @@
8809
9315
  "kind": "interface",
8810
9316
  "locationInModule": {
8811
9317
  "filename": "src/config/types.ts",
8812
- "line": 252
9318
+ "line": 302
8813
9319
  },
8814
9320
  "name": "StageEnvironment",
8815
9321
  "properties": [
@@ -8822,7 +9328,7 @@
8822
9328
  "immutable": true,
8823
9329
  "locationInModule": {
8824
9330
  "filename": "src/config/types.ts",
8825
- "line": 258
9331
+ "line": 308
8826
9332
  },
8827
9333
  "name": "regionOrder",
8828
9334
  "type": {
@@ -8839,7 +9345,7 @@
8839
9345
  "immutable": true,
8840
9346
  "locationInModule": {
8841
9347
  "filename": "src/config/types.ts",
8842
- "line": 256
9348
+ "line": 306
8843
9349
  },
8844
9350
  "name": "regions",
8845
9351
  "type": {
@@ -8861,7 +9367,7 @@
8861
9367
  "immutable": true,
8862
9368
  "locationInModule": {
8863
9369
  "filename": "src/config/types.ts",
8864
- "line": 254
9370
+ "line": 304
8865
9371
  },
8866
9372
  "name": "account",
8867
9373
  "optional": true,
@@ -8887,6 +9393,24 @@
8887
9393
  },
8888
9394
  "name": "StageStackNameOptions",
8889
9395
  "properties": [
9396
+ {
9397
+ "abstract": true,
9398
+ "docs": {
9399
+ "remarks": "Use this only to match an existing stack whose stage\nid was custom-case; the backward-compatible default lowercases the segment.",
9400
+ "stability": "experimental",
9401
+ "summary": "Preserve the stage segment's original casing."
9402
+ },
9403
+ "immutable": true,
9404
+ "locationInModule": {
9405
+ "filename": "src/config/naming.ts",
9406
+ "line": 42
9407
+ },
9408
+ "name": "preserveStageCase",
9409
+ "optional": true,
9410
+ "type": {
9411
+ "primitive": "boolean"
9412
+ }
9413
+ },
8890
9414
  {
8891
9415
  "abstract": true,
8892
9416
  "docs": {
@@ -8959,7 +9483,7 @@
8959
9483
  },
8960
9484
  "locationInModule": {
8961
9485
  "filename": "src/support/SupportResources.ts",
8962
- "line": 61
9486
+ "line": 75
8963
9487
  },
8964
9488
  "parameters": [
8965
9489
  {
@@ -8986,7 +9510,7 @@
8986
9510
  "kind": "class",
8987
9511
  "locationInModule": {
8988
9512
  "filename": "src/support/SupportResources.ts",
8989
- "line": 50
9513
+ "line": 63
8990
9514
  },
8991
9515
  "name": "SupportResources",
8992
9516
  "properties": [
@@ -8999,7 +9523,7 @@
8999
9523
  "immutable": true,
9000
9524
  "locationInModule": {
9001
9525
  "filename": "src/support/SupportResources.ts",
9002
- "line": 83
9526
+ "line": 98
9003
9527
  },
9004
9528
  "name": "artifactBucket",
9005
9529
  "type": {
@@ -9008,14 +9532,14 @@
9008
9532
  },
9009
9533
  {
9010
9534
  "docs": {
9011
- "remarks": "Created on first\nread, same as every other property here. Requires `complianceLogBucketName`: unlike\n`artifactBucket`, this bucket's name must be explicit and predictable so other buckets' logging\nconfiguration (and, cross-region, Blueprint's name-substitution convention) can reference it.\n\nBlueprint provisioned this bucket via a custom-resource Lambda so a redeploy could tolerate the bucket\nalready existing (`BucketAlreadyOwnedByYou`); Autopilot provisions it as a plain, CloudFormation-managed\n`Bucket` instead -- simpler, and the \"already exists\" case Blueprint tolerated doesn't arise here since\nthis construct's stack owns the bucket for the life of the pipeline.\n\nFolds in the TLS/SSE policy fix Blueprint's Stage-1 change (`0b7ae02`) made and Autopilot must not regress:\nenforcing encryption-in-transit works with a plain `Bool` condition on `aws:SecureTransport`\n(`enforceSSL`, below) because that key is always present on every request. Enforcing encryption\n*at rest* does not: `s3:x-amz-server-side-encryption` is only present in the request context when\nthe caller actually sets the header, so a `Bool` check against `\"false\"` never matches a request\nthat omits the header entirely -- exactly the unencrypted upload this statement exists to block.\nThe `Null` operator below checks for the header's *absence*, which a `Bool` check cannot.",
9535
+ "remarks": "Created on first\nread, same as every other property here. Requires `complianceLogBucketName`: unlike\n`artifactBucket`, this bucket's name must be explicit and predictable so other buckets' logging\nconfiguration can reference it by name.\n\nBy default Autopilot provisions a plain, CloudFormation-managed `Bucket`. For an in-place Blueprint\nmigration, set `createComplianceLogBucket: false` to reference the existing bucket by name instead.\nCDK intentionally cannot mutate an imported bucket policy, so that mode leaves the bucket and policy\nentirely under their current owner's lifecycle.\n\nThe bucket uses default SSE-S3 encryption. Writers, including the S3 server-access-log delivery\nservice, do not need to send an `x-amz-server-side-encryption` header: S3 encrypts the object at\nrest after accepting it. A bucket-policy deny based on that header would block valid log delivery,\nso transport encryption is enforced here while at-rest encryption is enforced by bucket defaults.",
9012
9536
  "stability": "experimental",
9013
9537
  "summary": "The compliance/access-log destination bucket (Blueprint `ComplianceBucketProvider` + `ComplianceLogBucketStack`) -- other buckets' S3 server access logs land here."
9014
9538
  },
9015
9539
  "immutable": true,
9016
9540
  "locationInModule": {
9017
9541
  "filename": "src/support/SupportResources.ts",
9018
- "line": 132
9542
+ "line": 144
9019
9543
  },
9020
9544
  "name": "complianceLogBucket",
9021
9545
  "type": {
@@ -9031,7 +9555,7 @@
9031
9555
  "immutable": true,
9032
9556
  "locationInModule": {
9033
9557
  "filename": "src/support/SupportResources.ts",
9034
- "line": 70
9558
+ "line": 85
9035
9559
  },
9036
9560
  "name": "encryptionKey",
9037
9561
  "type": {
@@ -9047,7 +9571,7 @@
9047
9571
  "immutable": true,
9048
9572
  "locationInModule": {
9049
9573
  "filename": "src/support/SupportResources.ts",
9050
- "line": 104
9574
+ "line": 119
9051
9575
  },
9052
9576
  "name": "vpcNetworking",
9053
9577
  "optional": true,
@@ -9069,7 +9593,7 @@
9069
9593
  "kind": "interface",
9070
9594
  "locationInModule": {
9071
9595
  "filename": "src/support/SupportResources.ts",
9072
- "line": 22
9596
+ "line": 23
9073
9597
  },
9074
9598
  "name": "SupportResourcesProps",
9075
9599
  "properties": [
@@ -9077,12 +9601,12 @@
9077
9601
  "abstract": true,
9078
9602
  "docs": {
9079
9603
  "stability": "experimental",
9080
- "summary": "The name of the compliance/access-log bucket -- Blueprint's `IComplianceBucket.bucketName` (`ComplianceBucketProvider`). Required only if `complianceLogBucket` is read; an explicit, predictable name is what lets other buckets' S3 server-access-logging destination (and Blueprint's cross-region name-substitution convention for multi-region deployments) point at it."
9604
+ "summary": "The name of the compliance/access-log bucket -- Blueprint's `IComplianceBucket.bucketName` (`ComplianceBucketProvider`). Required only if `complianceLogBucket` is read; an explicit, predictable name is what lets same-account, same-Region application buckets point their S3 server-access logging at it without creating CloudFormation cross-stack references."
9081
9605
  },
9082
9606
  "immutable": true,
9083
9607
  "locationInModule": {
9084
9608
  "filename": "src/support/SupportResources.ts",
9085
- "line": 42
9609
+ "line": 43
9086
9610
  },
9087
9611
  "name": "complianceLogBucketName",
9088
9612
  "optional": true,
@@ -9090,6 +9614,25 @@
9090
9614
  "primitive": "string"
9091
9615
  }
9092
9616
  },
9617
+ {
9618
+ "abstract": true,
9619
+ "docs": {
9620
+ "default": "true",
9621
+ "remarks": "Set to `false` to reference a pre-existing, owner-managed Blueprint compliance bucket. Imported\nbuckets synthesize no `AWS::S3::Bucket` or `AWS::S3::BucketPolicy`; the owner must maintain the\nbucket's same-account/same-Region placement, SSE-S3 encryption, TLS enforcement, public-access\nblock, disabled Object Lock and Requester Pays settings, and S3 server-access-log delivery policy.\nA name-only CDK import cannot inspect or validate those live settings.",
9622
+ "stability": "experimental",
9623
+ "summary": "Whether this construct creates and manages `complianceLogBucketName`."
9624
+ },
9625
+ "immutable": true,
9626
+ "locationInModule": {
9627
+ "filename": "src/support/SupportResources.ts",
9628
+ "line": 55
9629
+ },
9630
+ "name": "createComplianceLogBucket",
9631
+ "optional": true,
9632
+ "type": {
9633
+ "primitive": "boolean"
9634
+ }
9635
+ },
9093
9636
  {
9094
9637
  "abstract": true,
9095
9638
  "docs": {
@@ -9100,7 +9643,7 @@
9100
9643
  "immutable": true,
9101
9644
  "locationInModule": {
9102
9645
  "filename": "src/support/SupportResources.ts",
9103
- "line": 28
9646
+ "line": 29
9104
9647
  },
9105
9648
  "name": "removalPolicy",
9106
9649
  "optional": true,
@@ -9117,7 +9660,7 @@
9117
9660
  "immutable": true,
9118
9661
  "locationInModule": {
9119
9662
  "filename": "src/support/SupportResources.ts",
9120
- "line": 35
9663
+ "line": 36
9121
9664
  },
9122
9665
  "name": "useProxy",
9123
9666
  "optional": true,
@@ -9135,7 +9678,7 @@
9135
9678
  "immutable": true,
9136
9679
  "locationInModule": {
9137
9680
  "filename": "src/support/SupportResources.ts",
9138
- "line": 30
9681
+ "line": 31
9139
9682
  },
9140
9683
  "name": "vpc",
9141
9684
  "optional": true,
@@ -9157,7 +9700,7 @@
9157
9700
  "kind": "interface",
9158
9701
  "locationInModule": {
9159
9702
  "filename": "src/config/types.ts",
9160
- "line": 323
9703
+ "line": 380
9161
9704
  },
9162
9705
  "name": "SynthesizerConfig",
9163
9706
  "properties": [
@@ -9170,12 +9713,30 @@
9170
9713
  "immutable": true,
9171
9714
  "locationInModule": {
9172
9715
  "filename": "src/config/types.ts",
9173
- "line": 325
9716
+ "line": 382
9174
9717
  },
9175
9718
  "name": "type",
9176
9719
  "type": {
9177
9720
  "fqn": "@cdklabs/cdk-cicd-wrapper.SynthesizerType"
9178
9721
  }
9722
+ },
9723
+ {
9724
+ "abstract": true,
9725
+ "docs": {
9726
+ "remarks": "Defaults to `application`; the alpha\nsynthesizer normalizes it to a lowercase, dash-separated value of at most 20 characters.",
9727
+ "stability": "experimental",
9728
+ "summary": "Application-unique id for `APP_STAGING` resources."
9729
+ },
9730
+ "immutable": true,
9731
+ "locationInModule": {
9732
+ "filename": "src/config/types.ts",
9733
+ "line": 387
9734
+ },
9735
+ "name": "appId",
9736
+ "optional": true,
9737
+ "type": {
9738
+ "primitive": "string"
9739
+ }
9179
9740
  }
9180
9741
  ],
9181
9742
  "symbolId": "src/config/types:SynthesizerConfig"
@@ -9202,6 +9763,7 @@
9202
9763
  },
9203
9764
  {
9204
9765
  "docs": {
9766
+ "remarks": "Supported for direct/local application\ndeployments and Repo 1 image synthesis; wrapper-generated deployment pipelines reject it.\nIts staging support stack cannot honor a configured deploy or CloudFormation execution role.",
9205
9767
  "stability": "experimental",
9206
9768
  "summary": "`AppStagingSynthesizer` -- opt-in, still alpha."
9207
9769
  },
@@ -9223,7 +9785,7 @@
9223
9785
  "kind": "interface",
9224
9786
  "locationInModule": {
9225
9787
  "filename": "src/config/types.ts",
9226
- "line": 241
9788
+ "line": 291
9227
9789
  },
9228
9790
  "name": "VpcConfig",
9229
9791
  "properties": [
@@ -9236,7 +9798,7 @@
9236
9798
  "immutable": true,
9237
9799
  "locationInModule": {
9238
9800
  "filename": "src/config/types.ts",
9239
- "line": 243
9801
+ "line": 293
9240
9802
  },
9241
9803
  "name": "managedVpc",
9242
9804
  "optional": true,
@@ -9254,7 +9816,7 @@
9254
9816
  "immutable": true,
9255
9817
  "locationInModule": {
9256
9818
  "filename": "src/config/types.ts",
9257
- "line": 248
9819
+ "line": 298
9258
9820
  },
9259
9821
  "name": "vpcId",
9260
9822
  "optional": true,
@@ -9341,6 +9903,6 @@
9341
9903
  "symbolId": "src/support/Vpc:VpcNetworking"
9342
9904
  }
9343
9905
  },
9344
- "version": "2.3.1",
9345
- "fingerprint": "0a8MwmFkhfNk/nHO5CzNyoUTbHwuZ5GBwRVP6ntxfQM="
9906
+ "version": "2.3.3",
9907
+ "fingerprint": "SCREmjbUbu0Jgfhq6HybQeeBQPQTgVQo7bMzL9aqkMs="
9346
9908
  }