@cdklabs/cdk-cicd-wrapper 2.3.2 → 2.3.4

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 (53) hide show
  1. package/.jsii +759 -197
  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/node_modules/yaml/browser/dist/compose/resolve-flow-scalar.js +19 -18
  49. package/node_modules/yaml/browser/dist/nodes/Alias.js +25 -23
  50. package/node_modules/yaml/dist/compose/resolve-flow-scalar.js +19 -18
  51. package/node_modules/yaml/dist/nodes/Alias.js +25 -23
  52. package/node_modules/yaml/package.json +1 -1
  53. package/package.json +6 -5
@@ -0,0 +1,17 @@
1
+ import type { ResolvedCicdConfig } from '../config/types';
2
+ export declare const SECRET_REF_PREFIX = "resolve:secretsmanager:";
3
+ /**
4
+ * Return a literal Secrets Manager ARN from a deploy-role ExternalId reference, if present.
5
+ *
6
+ * A `resolve:secretsmanager:` reference crosses a privilege boundary: its suffix becomes an IAM
7
+ * `secretsmanager:GetSecretValue` resource. Reject anything that cannot name exactly one secret.
8
+ */
9
+ export declare function secretArnFromDeployRoleExternalId(value: string | undefined, field: string): string | undefined;
10
+ /**
11
+ * Secrets Manager ARNs that must be readable while the application is synthesized. ExternalIds are
12
+ * resolved only for stages that actually configure a deploy role; per-stage values override the
13
+ * pipeline default, matching the CLI runtime contract.
14
+ */
15
+ export declare function deployRoleExternalIdSecretArns(config: ResolvedCicdConfig): string[];
16
+ /** Stage-scoped form used by engines that synthesize only a subset of the configured stages. */
17
+ export declare function deployRoleExternalIdSecretArnsForStages(stages: ReadonlyArray<ResolvedCicdConfig['stages'][number]>, pipelineExternalId?: string): string[];
@@ -0,0 +1,53 @@
1
+ "use strict";
2
+ // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
3
+ // SPDX-License-Identifier: Apache-2.0
4
+ Object.defineProperty(exports, "__esModule", { value: true });
5
+ exports.SECRET_REF_PREFIX = void 0;
6
+ exports.secretArnFromDeployRoleExternalId = secretArnFromDeployRoleExternalId;
7
+ exports.deployRoleExternalIdSecretArns = deployRoleExternalIdSecretArns;
8
+ exports.deployRoleExternalIdSecretArnsForStages = deployRoleExternalIdSecretArnsForStages;
9
+ exports.SECRET_REF_PREFIX = 'resolve:secretsmanager:';
10
+ // A literal Secrets Manager ARN is required because this value is emitted directly as an IAM Resource.
11
+ // The partition pattern supports standard and isolated AWS partitions without accepting wildcard characters.
12
+ const SECRET_MANAGER_ARN = /^arn:aws(?:-[a-z0-9-]+)?:secretsmanager:[a-z]{2}(?:-[a-z0-9]+)+-\d:\d{12}:secret:[A-Za-z0-9/_+=.@-]+$/;
13
+ /**
14
+ * Return a literal Secrets Manager ARN from a deploy-role ExternalId reference, if present.
15
+ *
16
+ * A `resolve:secretsmanager:` reference crosses a privilege boundary: its suffix becomes an IAM
17
+ * `secretsmanager:GetSecretValue` resource. Reject anything that cannot name exactly one secret.
18
+ */
19
+ function secretArnFromDeployRoleExternalId(value, field) {
20
+ const normalized = value?.trim();
21
+ if (normalized === undefined || !normalized.startsWith(exports.SECRET_REF_PREFIX))
22
+ return undefined;
23
+ const secretArn = normalized.slice(exports.SECRET_REF_PREFIX.length);
24
+ if (!SECRET_MANAGER_ARN.test(secretArn)) {
25
+ throw new Error(`cdk-cicd: ${field} must use resolve:secretsmanager:<complete literal Secrets Manager secret ARN>; ` +
26
+ 'wildcards, non-ARN identifiers, and other AWS services are not allowed.');
27
+ }
28
+ return secretArn;
29
+ }
30
+ /**
31
+ * Secrets Manager ARNs that must be readable while the application is synthesized. ExternalIds are
32
+ * resolved only for stages that actually configure a deploy role; per-stage values override the
33
+ * pipeline default, matching the CLI runtime contract.
34
+ */
35
+ function deployRoleExternalIdSecretArns(config) {
36
+ return deployRoleExternalIdSecretArnsForStages(config.stages, config.deployRoleExternalId);
37
+ }
38
+ /** Stage-scoped form used by engines that synthesize only a subset of the configured stages. */
39
+ function deployRoleExternalIdSecretArnsForStages(stages, pipelineExternalId) {
40
+ const arns = new Set();
41
+ for (const stage of stages) {
42
+ if (stage.deployment?.deployRole === undefined || stage.deployment.deployRole.trim().length === 0) {
43
+ continue;
44
+ }
45
+ const externalId = stage.deployment.externalId ?? pipelineExternalId;
46
+ const secretArn = secretArnFromDeployRoleExternalId(externalId, `stage '${stage.name}' deploy-role externalId`);
47
+ if (secretArn !== undefined) {
48
+ arns.add(secretArn);
49
+ }
50
+ }
51
+ return [...arns];
52
+ }
53
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXh0ZXJuYWwtaWQtc2VjcmV0cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9lbmdpbmUvZXh0ZXJuYWwtaWQtc2VjcmV0cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUEscUVBQXFFO0FBQ3JFLHNDQUFzQzs7O0FBaUJ0Qyw4RUFZQztBQU9ELHdFQUVDO0FBR0QsMEZBZ0JDO0FBckRZLFFBQUEsaUJBQWlCLEdBQUcseUJBQXlCLENBQUM7QUFFM0QsdUdBQXVHO0FBQ3ZHLDZHQUE2RztBQUM3RyxNQUFNLGtCQUFrQixHQUN0Qix1R0FBdUcsQ0FBQztBQUUxRzs7Ozs7R0FLRztBQUNILFNBQWdCLGlDQUFpQyxDQUFDLEtBQXlCLEVBQUUsS0FBYTtJQUN4RixNQUFNLFVBQVUsR0FBRyxLQUFLLEVBQUUsSUFBSSxFQUFFLENBQUM7SUFDakMsSUFBSSxVQUFVLEtBQUssU0FBUyxJQUFJLENBQUMsVUFBVSxDQUFDLFVBQVUsQ0FBQyx5QkFBaUIsQ0FBQztRQUFFLE9BQU8sU0FBUyxDQUFDO0lBRTVGLE1BQU0sU0FBUyxHQUFHLFVBQVUsQ0FBQyxLQUFLLENBQUMseUJBQWlCLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDN0QsSUFBSSxDQUFDLGtCQUFrQixDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsRUFBRSxDQUFDO1FBQ3hDLE1BQU0sSUFBSSxLQUFLLENBQ2IsYUFBYSxLQUFLLGtGQUFrRjtZQUNsRyx5RUFBeUUsQ0FDNUUsQ0FBQztJQUNKLENBQUM7SUFDRCxPQUFPLFNBQVMsQ0FBQztBQUNuQixDQUFDO0FBRUQ7Ozs7R0FJRztBQUNILFNBQWdCLDhCQUE4QixDQUFDLE1BQTBCO0lBQ3ZFLE9BQU8sdUNBQXVDLENBQUMsTUFBTSxDQUFDLE1BQU0sRUFBRSxNQUFNLENBQUMsb0JBQW9CLENBQUMsQ0FBQztBQUM3RixDQUFDO0FBRUQsZ0dBQWdHO0FBQ2hHLFNBQWdCLHVDQUF1QyxDQUNyRCxNQUEyRCxFQUMzRCxrQkFBMkI7SUFFM0IsTUFBTSxJQUFJLEdBQUcsSUFBSSxHQUFHLEVBQVUsQ0FBQztJQUMvQixLQUFLLE1BQU0sS0FBSyxJQUFJLE1BQU0sRUFBRSxDQUFDO1FBQzNCLElBQUksS0FBSyxDQUFDLFVBQVUsRUFBRSxVQUFVLEtBQUssU0FBUyxJQUFJLEtBQUssQ0FBQyxVQUFVLENBQUMsVUFBVSxDQUFDLElBQUksRUFBRSxDQUFDLE1BQU0sS0FBSyxDQUFDLEVBQUUsQ0FBQztZQUNsRyxTQUFTO1FBQ1gsQ0FBQztRQUNELE1BQU0sVUFBVSxHQUFHLEtBQUssQ0FBQyxVQUFVLENBQUMsVUFBVSxJQUFJLGtCQUFrQixDQUFDO1FBQ3JFLE1BQU0sU0FBUyxHQUFHLGlDQUFpQyxDQUFDLFVBQVUsRUFBRSxVQUFVLEtBQUssQ0FBQyxJQUFJLDBCQUEwQixDQUFDLENBQUM7UUFDaEgsSUFBSSxTQUFTLEtBQUssU0FBUyxFQUFFLENBQUM7WUFDNUIsSUFBSSxDQUFDLEdBQUcsQ0FBQyxTQUFTLENBQUMsQ0FBQztRQUN0QixDQUFDO0lBQ0gsQ0FBQztJQUNELE9BQU8sQ0FBQyxHQUFHLElBQUksQ0FBQyxDQUFDO0FBQ25CLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBDb3B5cmlnaHQgQW1hem9uLmNvbSwgSW5jLiBvciBpdHMgYWZmaWxpYXRlcy4gQWxsIFJpZ2h0cyBSZXNlcnZlZC5cbi8vIFNQRFgtTGljZW5zZS1JZGVudGlmaWVyOiBBcGFjaGUtMi4wXG5cbmltcG9ydCB0eXBlIHsgUmVzb2x2ZWRDaWNkQ29uZmlnIH0gZnJvbSAnLi4vY29uZmlnL3R5cGVzJztcblxuZXhwb3J0IGNvbnN0IFNFQ1JFVF9SRUZfUFJFRklYID0gJ3Jlc29sdmU6c2VjcmV0c21hbmFnZXI6JztcblxuLy8gQSBsaXRlcmFsIFNlY3JldHMgTWFuYWdlciBBUk4gaXMgcmVxdWlyZWQgYmVjYXVzZSB0aGlzIHZhbHVlIGlzIGVtaXR0ZWQgZGlyZWN0bHkgYXMgYW4gSUFNIFJlc291cmNlLlxuLy8gVGhlIHBhcnRpdGlvbiBwYXR0ZXJuIHN1cHBvcnRzIHN0YW5kYXJkIGFuZCBpc29sYXRlZCBBV1MgcGFydGl0aW9ucyB3aXRob3V0IGFjY2VwdGluZyB3aWxkY2FyZCBjaGFyYWN0ZXJzLlxuY29uc3QgU0VDUkVUX01BTkFHRVJfQVJOID1cbiAgL15hcm46YXdzKD86LVthLXowLTktXSspPzpzZWNyZXRzbWFuYWdlcjpbYS16XXsyfSg/Oi1bYS16MC05XSspKy1cXGQ6XFxkezEyfTpzZWNyZXQ6W0EtWmEtejAtOS9fKz0uQC1dKyQvO1xuXG4vKipcbiAqIFJldHVybiBhIGxpdGVyYWwgU2VjcmV0cyBNYW5hZ2VyIEFSTiBmcm9tIGEgZGVwbG95LXJvbGUgRXh0ZXJuYWxJZCByZWZlcmVuY2UsIGlmIHByZXNlbnQuXG4gKlxuICogQSBgcmVzb2x2ZTpzZWNyZXRzbWFuYWdlcjpgIHJlZmVyZW5jZSBjcm9zc2VzIGEgcHJpdmlsZWdlIGJvdW5kYXJ5OiBpdHMgc3VmZml4IGJlY29tZXMgYW4gSUFNXG4gKiBgc2VjcmV0c21hbmFnZXI6R2V0U2VjcmV0VmFsdWVgIHJlc291cmNlLiBSZWplY3QgYW55dGhpbmcgdGhhdCBjYW5ub3QgbmFtZSBleGFjdGx5IG9uZSBzZWNyZXQuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBzZWNyZXRBcm5Gcm9tRGVwbG95Um9sZUV4dGVybmFsSWQodmFsdWU6IHN0cmluZyB8IHVuZGVmaW5lZCwgZmllbGQ6IHN0cmluZyk6IHN0cmluZyB8IHVuZGVmaW5lZCB7XG4gIGNvbnN0IG5vcm1hbGl6ZWQgPSB2YWx1ZT8udHJpbSgpO1xuICBpZiAobm9ybWFsaXplZCA9PT0gdW5kZWZpbmVkIHx8ICFub3JtYWxpemVkLnN0YXJ0c1dpdGgoU0VDUkVUX1JFRl9QUkVGSVgpKSByZXR1cm4gdW5kZWZpbmVkO1xuXG4gIGNvbnN0IHNlY3JldEFybiA9IG5vcm1hbGl6ZWQuc2xpY2UoU0VDUkVUX1JFRl9QUkVGSVgubGVuZ3RoKTtcbiAgaWYgKCFTRUNSRVRfTUFOQUdFUl9BUk4udGVzdChzZWNyZXRBcm4pKSB7XG4gICAgdGhyb3cgbmV3IEVycm9yKFxuICAgICAgYGNkay1jaWNkOiAke2ZpZWxkfSBtdXN0IHVzZSByZXNvbHZlOnNlY3JldHNtYW5hZ2VyOjxjb21wbGV0ZSBsaXRlcmFsIFNlY3JldHMgTWFuYWdlciBzZWNyZXQgQVJOPjsgYCArXG4gICAgICAgICd3aWxkY2FyZHMsIG5vbi1BUk4gaWRlbnRpZmllcnMsIGFuZCBvdGhlciBBV1Mgc2VydmljZXMgYXJlIG5vdCBhbGxvd2VkLicsXG4gICAgKTtcbiAgfVxuICByZXR1cm4gc2VjcmV0QXJuO1xufVxuXG4vKipcbiAqIFNlY3JldHMgTWFuYWdlciBBUk5zIHRoYXQgbXVzdCBiZSByZWFkYWJsZSB3aGlsZSB0aGUgYXBwbGljYXRpb24gaXMgc3ludGhlc2l6ZWQuIEV4dGVybmFsSWRzIGFyZVxuICogcmVzb2x2ZWQgb25seSBmb3Igc3RhZ2VzIHRoYXQgYWN0dWFsbHkgY29uZmlndXJlIGEgZGVwbG95IHJvbGU7IHBlci1zdGFnZSB2YWx1ZXMgb3ZlcnJpZGUgdGhlXG4gKiBwaXBlbGluZSBkZWZhdWx0LCBtYXRjaGluZyB0aGUgQ0xJIHJ1bnRpbWUgY29udHJhY3QuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBkZXBsb3lSb2xlRXh0ZXJuYWxJZFNlY3JldEFybnMoY29uZmlnOiBSZXNvbHZlZENpY2RDb25maWcpOiBzdHJpbmdbXSB7XG4gIHJldHVybiBkZXBsb3lSb2xlRXh0ZXJuYWxJZFNlY3JldEFybnNGb3JTdGFnZXMoY29uZmlnLnN0YWdlcywgY29uZmlnLmRlcGxveVJvbGVFeHRlcm5hbElkKTtcbn1cblxuLyoqIFN0YWdlLXNjb3BlZCBmb3JtIHVzZWQgYnkgZW5naW5lcyB0aGF0IHN5bnRoZXNpemUgb25seSBhIHN1YnNldCBvZiB0aGUgY29uZmlndXJlZCBzdGFnZXMuICovXG5leHBvcnQgZnVuY3Rpb24gZGVwbG95Um9sZUV4dGVybmFsSWRTZWNyZXRBcm5zRm9yU3RhZ2VzKFxuICBzdGFnZXM6IFJlYWRvbmx5QXJyYXk8UmVzb2x2ZWRDaWNkQ29uZmlnWydzdGFnZXMnXVtudW1iZXJdPixcbiAgcGlwZWxpbmVFeHRlcm5hbElkPzogc3RyaW5nLFxuKTogc3RyaW5nW10ge1xuICBjb25zdCBhcm5zID0gbmV3IFNldDxzdHJpbmc+KCk7XG4gIGZvciAoY29uc3Qgc3RhZ2Ugb2Ygc3RhZ2VzKSB7XG4gICAgaWYgKHN0YWdlLmRlcGxveW1lbnQ/LmRlcGxveVJvbGUgPT09IHVuZGVmaW5lZCB8fCBzdGFnZS5kZXBsb3ltZW50LmRlcGxveVJvbGUudHJpbSgpLmxlbmd0aCA9PT0gMCkge1xuICAgICAgY29udGludWU7XG4gICAgfVxuICAgIGNvbnN0IGV4dGVybmFsSWQgPSBzdGFnZS5kZXBsb3ltZW50LmV4dGVybmFsSWQgPz8gcGlwZWxpbmVFeHRlcm5hbElkO1xuICAgIGNvbnN0IHNlY3JldEFybiA9IHNlY3JldEFybkZyb21EZXBsb3lSb2xlRXh0ZXJuYWxJZChleHRlcm5hbElkLCBgc3RhZ2UgJyR7c3RhZ2UubmFtZX0nIGRlcGxveS1yb2xlIGV4dGVybmFsSWRgKTtcbiAgICBpZiAoc2VjcmV0QXJuICE9PSB1bmRlZmluZWQpIHtcbiAgICAgIGFybnMuYWRkKHNlY3JldEFybik7XG4gICAgfVxuICB9XG4gIHJldHVybiBbLi4uYXJuc107XG59XG4iXX0=
@@ -17,10 +17,9 @@ export interface GitHubActionsEngineProps {
17
17
  }
18
18
  /**
19
19
  * A GitHub Actions workflow rendered from an Autopilot config + a stage factory. Reproduces the Blueprint shape: a
20
- * `GitHubActionRole` the workflow assumes over OIDC, a Synth job, and one job (with a GitHub Environment,
21
- * so an environment protection rule set up on GitHub's side gates it) per deployment stage. Manual-approval
22
- * config is NOT translated into a CDK step here -- as in Blueprint, GitHub Environments are the gate; every stage
23
- * gets its own environment regardless of `manualApproval`, and gating is configured in the GitHub UI.
20
+ * `GitHubActionRole` the workflow assumes over OIDC, a Synth job, and one job (with a GitHub Environment)
21
+ * per deployment stage. GitHub owns the environment protection rules, so approval-gated stages are accepted
22
+ * only when config explicitly acknowledges that required reviewers are configured on those environments.
24
23
  */
25
24
  export declare class GitHubActionsEngine extends Construct {
26
25
  readonly pipeline: GitHubWorkflow;