@cdklabs/cdk-cicd-wrapper 0.3.9 → 0.4.0
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.
- package/.compatignore +131 -0
- package/.jsii +2683 -9947
- package/.jsii.tabl.json +1 -1
- package/lib/app/DeploymentPipelineApp.d.ts +19 -0
- package/lib/app/DeploymentPipelineApp.js +49 -0
- package/lib/app/PipelineApp.d.ts +25 -0
- package/lib/app/PipelineApp.js +62 -0
- package/lib/appconfig/accessor.d.ts +59 -0
- package/lib/appconfig/accessor.js +79 -0
- package/lib/appconfig/defaults.d.ts +23 -0
- package/lib/appconfig/defaults.js +87 -0
- package/lib/appconfig/error.d.ts +20 -0
- package/lib/appconfig/error.js +32 -0
- package/lib/appconfig/index.d.ts +6 -0
- package/lib/appconfig/index.js +25 -0
- package/lib/appconfig/loader.d.ts +34 -0
- package/lib/appconfig/loader.js +86 -0
- package/lib/appconfig/schema.d.ts +46 -0
- package/lib/appconfig/schema.js +14 -0
- package/lib/appconfig/validation.d.ts +41 -0
- package/lib/appconfig/validation.js +72 -0
- package/lib/config/build-image.d.ts +41 -0
- package/lib/config/build-image.js +46 -0
- package/lib/config/define.d.ts +137 -0
- package/lib/config/define.js +151 -0
- package/lib/config/naming.d.ts +32 -0
- package/lib/config/naming.js +47 -0
- package/lib/config/repository.d.ts +36 -0
- package/lib/config/repository.js +53 -0
- package/lib/config/types.d.ts +375 -0
- package/lib/config/types.js +69 -0
- package/lib/engine/cdkpipelines/CdkPipelinesEngine.d.ts +46 -0
- package/lib/engine/cdkpipelines/CdkPipelinesEngine.js +260 -0
- package/lib/engine/codepipeline/CodePipelineEngine.d.ts +63 -0
- package/lib/engine/codepipeline/CodePipelineEngine.js +631 -0
- package/lib/engine/codepipeline/DeploymentPipeline.d.ts +24 -0
- package/lib/engine/codepipeline/DeploymentPipeline.js +236 -0
- package/lib/engine/codepipeline/deploy-driver/handler.d.ts +42 -0
- package/lib/engine/codepipeline/deploy-driver/handler.js +116 -0
- package/lib/engine/codepipeline/source.d.ts +5 -0
- package/lib/engine/codepipeline/source.js +56 -0
- package/lib/engine/github/GitHubActionsEngine.d.ts +29 -0
- package/lib/engine/github/GitHubActionsEngine.js +165 -0
- package/lib/engine/types.d.ts +14 -0
- package/lib/engine/types.js +11 -0
- package/lib/index.d.ts +29 -10
- package/lib/index.js +114 -32
- package/lib/runtime/attach.d.ts +24 -0
- package/lib/runtime/attach.js +41 -0
- package/lib/runtime/inject.d.ts +90 -0
- package/lib/runtime/inject.js +227 -0
- package/lib/runtime/pipeline-assembler.d.ts +25 -0
- package/lib/runtime/pipeline-assembler.js +208 -0
- package/lib/runtime/register.d.ts +1 -0
- package/lib/runtime/register.js +110 -0
- package/lib/support/AccessLogsForBucketAspect.d.ts +24 -0
- package/lib/support/AccessLogsForBucketAspect.js +67 -0
- package/lib/support/DestroyEncryptionKeysOnDeleteAspect.d.ts +10 -0
- package/lib/support/DestroyEncryptionKeysOnDeleteAspect.js +33 -0
- package/lib/support/DisablePublicIPAssignmentForEC2Aspect.d.ts +9 -0
- package/lib/support/DisablePublicIPAssignmentForEC2Aspect.js +34 -0
- package/lib/support/EncryptBucketOnTransitAspect.d.ts +10 -0
- package/lib/support/EncryptBucketOnTransitAspect.js +56 -0
- package/lib/support/EncryptCloudWatchLogGroupsAspect.d.ts +23 -0
- package/lib/support/EncryptCloudWatchLogGroupsAspect.js +45 -0
- package/lib/support/EncryptSNSTopicOnTransitAspect.d.ts +9 -0
- package/lib/support/EncryptSNSTopicOnTransitAspect.js +77 -0
- package/lib/support/LambdaDLQAspect.d.ts +17 -0
- package/lib/support/LambdaDLQAspect.js +31 -0
- package/lib/support/LogRetentionAspect.d.ts +23 -0
- package/lib/support/LogRetentionAspect.js +43 -0
- package/lib/support/RotateEncryptionKeysAspect.d.ts +9 -0
- package/lib/support/RotateEncryptionKeysAspect.js +33 -0
- package/lib/support/SupportResources.d.ts +75 -0
- package/lib/support/SupportResources.js +137 -0
- package/lib/support/Vpc.d.ts +21 -0
- package/lib/support/Vpc.js +110 -0
- package/node_modules/yaml/browser/dist/compose/composer.js +4 -2
- package/node_modules/yaml/browser/dist/compose/resolve-flow-scalar.js +5 -3
- package/node_modules/yaml/browser/dist/nodes/Alias.js +2 -0
- package/node_modules/yaml/browser/dist/parse/lexer.js +28 -24
- package/node_modules/yaml/browser/dist/parse/parser.js +12 -4
- package/node_modules/yaml/browser/dist/schema/yaml-1.1/merge.js +11 -8
- package/node_modules/yaml/browser/dist/stringify/stringifyNumber.js +2 -1
- package/node_modules/yaml/dist/compose/composer.js +4 -2
- package/node_modules/yaml/dist/compose/resolve-flow-scalar.js +5 -3
- package/node_modules/yaml/dist/nodes/Alias.js +2 -0
- package/node_modules/yaml/dist/nodes/Scalar.d.ts +5 -1
- package/node_modules/yaml/dist/parse/lexer.js +28 -24
- package/node_modules/yaml/dist/parse/parser.js +12 -4
- package/node_modules/yaml/dist/schema/yaml-1.1/merge.js +10 -7
- package/node_modules/yaml/dist/stringify/stringifyNumber.js +2 -1
- package/node_modules/yaml/package.json +1 -1
- package/package.json +6 -3
- package/rosetta/default.ts-fixture +1 -1
- package/lib/code-pipeline/AppStage.d.ts +0 -80
- package/lib/code-pipeline/AppStage.js +0 -80
- package/lib/code-pipeline/CDKPipeline.d.ts +0 -225
- package/lib/code-pipeline/CDKPipeline.js +0 -167
- package/lib/code-pipeline/CodeGuruSecurityStep.d.ts +0 -61
- package/lib/code-pipeline/CodeGuruSecurityStep.js +0 -137
- package/lib/code-pipeline/PostDeployBuildStep.d.ts +0 -16
- package/lib/code-pipeline/PostDeployBuildStep.js +0 -67
- package/lib/code-pipeline/PreDeployBuildStep.d.ts +0 -14
- package/lib/code-pipeline/PreDeployBuildStep.js +0 -35
- package/lib/code-pipeline/index.d.ts +0 -7
- package/lib/code-pipeline/index.js +0 -26
- package/lib/common/index.d.ts +0 -16
- package/lib/common/index.js +0 -35
- package/lib/common/spi/ResourceContext.d.ts +0 -128
- package/lib/common/spi/ResourceContext.js +0 -251
- package/lib/common/spi/index.d.ts +0 -6
- package/lib/common/spi/index.js +0 -25
- package/lib/common/types/BaseStackProvider.d.ts +0 -95
- package/lib/common/types/BaseStackProvider.js +0 -152
- package/lib/common/types/DefaultStackProvider.d.ts +0 -70
- package/lib/common/types/DefaultStackProvider.js +0 -141
- package/lib/common/types/Types.d.ts +0 -402
- package/lib/common/types/Types.js +0 -110
- package/lib/constructs/CodeCommitRepositoryConstruct.d.ts +0 -56
- package/lib/constructs/CodeCommitRepositoryConstruct.js +0 -100
- package/lib/constructs/CodeStarConnectionConstruct.d.ts +0 -34
- package/lib/constructs/CodeStarConnectionConstruct.js +0 -41
- package/lib/constructs/S3RepositoryConstruct.d.ts +0 -51
- package/lib/constructs/S3RepositoryConstruct.js +0 -81
- package/lib/constructs/index.d.ts +0 -8
- package/lib/constructs/index.js +0 -27
- package/lib/plugins/index.d.ts +0 -56
- package/lib/plugins/index.js +0 -81
- package/lib/plugins/optimization/DestroyEncryptionKeysOnDeletePlugin.d.ts +0 -12
- package/lib/plugins/optimization/DestroyEncryptionKeysOnDeletePlugin.js +0 -40
- package/lib/plugins/pipeline/GitHubPipelinePlugin.d.ts +0 -125
- package/lib/plugins/pipeline/GitHubPipelinePlugin.js +0 -44
- package/lib/plugins/pipeline/resources/github/GitHubPipelineProvider.d.ts +0 -16
- package/lib/plugins/pipeline/resources/github/GitHubPipelineProvider.js +0 -74
- package/lib/plugins/pipeline/resources/github/GitHubRepositoryProvider.d.ts +0 -82
- package/lib/plugins/pipeline/resources/github/GitHubRepositoryProvider.js +0 -70
- package/lib/plugins/security/AccessLogsForBucketPlugin.d.ts +0 -10
- package/lib/plugins/security/AccessLogsForBucketPlugin.js +0 -75
- package/lib/plugins/security/DisablePublicIPAssignmentForEC2Plugin.d.ts +0 -10
- package/lib/plugins/security/DisablePublicIPAssignmentForEC2Plugin.js +0 -36
- package/lib/plugins/security/EncryptBucketOnTransitPlugin.d.ts +0 -10
- package/lib/plugins/security/EncryptBucketOnTransitPlugin.js +0 -48
- package/lib/plugins/security/EncryptCloudWatchLogGroupsPlugin.d.ts +0 -12
- package/lib/plugins/security/EncryptCloudWatchLogGroupsPlugin.js +0 -45
- package/lib/plugins/security/EncryptSNSTopicOnTransitPlugin.d.ts +0 -10
- package/lib/plugins/security/EncryptSNSTopicOnTransitPlugin.js +0 -70
- package/lib/plugins/security/LambdaDLQPlugin.d.ts +0 -16
- package/lib/plugins/security/LambdaDLQPlugin.js +0 -61
- package/lib/plugins/security/RotateEncryptionKeysPlugin.d.ts +0 -10
- package/lib/plugins/security/RotateEncryptionKeysPlugin.js +0 -36
- package/lib/plugins/utils/CodeArtifactPlugin.d.ts +0 -27
- package/lib/plugins/utils/CodeArtifactPlugin.js +0 -66
- package/lib/projen/CDKCommands.d.ts +0 -56
- package/lib/projen/CDKCommands.js +0 -125
- package/lib/projen/CICommands.d.ts +0 -61
- package/lib/projen/CICommands.js +0 -70
- package/lib/projen/CdkCICDWrapper.d.ts +0 -56
- package/lib/projen/CdkCICDWrapper.js +0 -65
- package/lib/projen/DevBoxFile.d.ts +0 -12
- package/lib/projen/DevBoxFile.js +0 -40
- package/lib/projen/DotEnvFile.d.ts +0 -26
- package/lib/projen/DotEnvFile.js +0 -40
- package/lib/projen/TaskFile.d.ts +0 -18
- package/lib/projen/TaskFile.js +0 -26
- package/lib/projen/Taskfile.yaml +0 -158
- package/lib/projen/index.d.ts +0 -5
- package/lib/projen/index.js +0 -24
- package/lib/resource-providers/CIDefinitionProvider.d.ts +0 -39
- package/lib/resource-providers/CIDefinitionProvider.js +0 -68
- package/lib/resource-providers/CodeBuildFactoryProvider.d.ts +0 -136
- package/lib/resource-providers/CodeBuildFactoryProvider.js +0 -264
- package/lib/resource-providers/ComplianceBucketProvider.d.ts +0 -42
- package/lib/resource-providers/ComplianceBucketProvider.js +0 -50
- package/lib/resource-providers/DisabledProvider.d.ts +0 -6
- package/lib/resource-providers/DisabledProvider.js +0 -16
- package/lib/resource-providers/EncryptionProvider.d.ts +0 -25
- package/lib/resource-providers/EncryptionProvider.js +0 -33
- package/lib/resource-providers/HooksProvider.d.ts +0 -15
- package/lib/resource-providers/HooksProvider.js +0 -49
- package/lib/resource-providers/LoggingProvider.d.ts +0 -21
- package/lib/resource-providers/LoggingProvider.js +0 -63
- package/lib/resource-providers/ParameterProvider.d.ts +0 -32
- package/lib/resource-providers/ParameterProvider.js +0 -46
- package/lib/resource-providers/PhaseCommandProvider.d.ts +0 -136
- package/lib/resource-providers/PhaseCommandProvider.js +0 -220
- package/lib/resource-providers/PipelineProvider.d.ts +0 -13
- package/lib/resource-providers/PipelineProvider.js +0 -54
- package/lib/resource-providers/ProxyProvider.d.ts +0 -35
- package/lib/resource-providers/ProxyProvider.js +0 -53
- package/lib/resource-providers/RepositoryProvider.d.ts +0 -171
- package/lib/resource-providers/RepositoryProvider.js +0 -201
- package/lib/resource-providers/StageProvider.d.ts +0 -17
- package/lib/resource-providers/StageProvider.js +0 -36
- package/lib/resource-providers/VPCProvider.d.ts +0 -57
- package/lib/resource-providers/VPCProvider.js +0 -67
- package/lib/resource-providers/index.d.ts +0 -48
- package/lib/resource-providers/index.js +0 -67
- package/lib/stacks/CodeCommitRepositoryStack.d.ts +0 -39
- package/lib/stacks/CodeCommitRepositoryStack.js +0 -23
- package/lib/stacks/CodeStarConnectRepositoryStack.d.ts +0 -44
- package/lib/stacks/CodeStarConnectRepositoryStack.js +0 -33
- package/lib/stacks/EncryptionStack.d.ts +0 -27
- package/lib/stacks/EncryptionStack.js +0 -41
- package/lib/stacks/PipelineBlueprint.d.ts +0 -220
- package/lib/stacks/PipelineBlueprint.js +0 -467
- package/lib/stacks/PipelineBlueprintBase.d.ts +0 -40
- package/lib/stacks/PipelineBlueprintBase.js +0 -130
- package/lib/stacks/PipelineStack.d.ts +0 -16
- package/lib/stacks/PipelineStack.js +0 -36
- package/lib/stacks/PostDeployExecutorStack.d.ts +0 -76
- package/lib/stacks/PostDeployExecutorStack.js +0 -60
- package/lib/stacks/S3RepositoryStack.d.ts +0 -30
- package/lib/stacks/S3RepositoryStack.js +0 -38
- package/lib/stacks/SSMParameterStack.d.ts +0 -50
- package/lib/stacks/SSMParameterStack.js +0 -74
- package/lib/stacks/WorkbenchStack.d.ts +0 -19
- package/lib/stacks/WorkbenchStack.js +0 -29
- package/lib/stacks/compliance-bucket/ComplianceBucketStack.d.ts +0 -47
- package/lib/stacks/compliance-bucket/ComplianceBucketStack.js +0 -124
- package/lib/stacks/compliance-bucket/lambda-functions/compliance_log_bucket_policy.py +0 -34
- package/lib/stacks/compliance-bucket/lambda-functions/make-compliance-log-bucket.py +0 -111
- package/lib/stacks/index.d.ts +0 -36
- package/lib/stacks/index.js +0 -55
- package/lib/stacks/vpc/ManagedVPCStack.d.ts +0 -96
- package/lib/stacks/vpc/ManagedVPCStack.js +0 -115
- package/lib/stacks/vpc/NoVPCStack.d.ts +0 -27
- package/lib/stacks/vpc/NoVPCStack.js +0 -23
- package/lib/stacks/vpc/VPCFromLookUpStack.d.ts +0 -42
- package/lib/stacks/vpc/VPCFromLookUpStack.js +0 -49
- package/lib/utils/ParameterResolver.d.ts +0 -18
- package/lib/utils/ParameterResolver.js +0 -34
- package/lib/utils/index.d.ts +0 -1
- package/lib/utils/index.js +0 -20
|
@@ -0,0 +1,375 @@
|
|
|
1
|
+
import { aws_codebuild as codebuild, aws_ec2 as ec2 } from 'aws-cdk-lib';
|
|
2
|
+
import { WorkflowTriggers } from 'cdk-pipelines-github';
|
|
3
|
+
import { BuildImage } from './build-image';
|
|
4
|
+
import { Repository } from './repository';
|
|
5
|
+
/** Order in which a stage's regions are rolled out. */
|
|
6
|
+
export declare enum RegionOrder {
|
|
7
|
+
/** One region after another (default). */
|
|
8
|
+
SEQUENTIAL = "sequential",
|
|
9
|
+
/** All regions at once. */
|
|
10
|
+
PARALLEL = "parallel"
|
|
11
|
+
}
|
|
12
|
+
/** Which stack synthesizer the wrapper installs. */
|
|
13
|
+
export declare enum SynthesizerType {
|
|
14
|
+
/** `DefaultStackSynthesizer` -- the v3 default. */
|
|
15
|
+
DEFAULT = "default",
|
|
16
|
+
/** `AppStagingSynthesizer` -- opt-in, still alpha. */
|
|
17
|
+
APP_STAGING = "app_staging"
|
|
18
|
+
}
|
|
19
|
+
/** Which CI/CD engine renders the pipeline. */
|
|
20
|
+
export declare enum EngineType {
|
|
21
|
+
/**
|
|
22
|
+
* The lightweight flat engine on raw `aws-cdk-lib/aws-codepipeline` -- the v3 default. Its deploy
|
|
23
|
+
* stages re-invoke the app per stage, so the user's `bin` stays a plain single-stage app.
|
|
24
|
+
*/
|
|
25
|
+
CODEPIPELINE = "codepipeline",
|
|
26
|
+
/**
|
|
27
|
+
* The v2-compatible self-mutating pipeline on `aws-cdk-lib/pipelines` (Source -> Synth -> Assets ->
|
|
28
|
+
* one wave per stage). `cdk-cicd exec` assembles it by replaying the plain `bin` once per configured
|
|
29
|
+
* stage (see runtime/pipeline-assembler), so the user's `bin` still needs no wrapper code.
|
|
30
|
+
*/
|
|
31
|
+
CDK_PIPELINES = "cdk-pipelines",
|
|
32
|
+
/**
|
|
33
|
+
* Renders a GitHub Actions workflow (`cdk-pipelines-github`) instead of an AWS-hosted pipeline (v2
|
|
34
|
+
* `GitHubPipelinePlugin`, migrated). Like `CDK_PIPELINES`, it needs every stage built as a `cdk.Stage`
|
|
35
|
+
* inside one synth, so `cdk-cicd exec` assembles it the same way -- replaying the plain `bin` once per
|
|
36
|
+
* configured stage.
|
|
37
|
+
*/
|
|
38
|
+
GITHUB_ACTIONS = "github-actions"
|
|
39
|
+
}
|
|
40
|
+
/**
|
|
41
|
+
* GitHub Actions engine configuration: the OIDC role the workflow assumes plus the workflow file's own
|
|
42
|
+
* identity (v2 `GitHubPipelinePluginOptions`, migrated). Only read when `engine` is `GITHUB_ACTIONS`;
|
|
43
|
+
* `repository` must be `Repository.github(...)` in that case (the workflow runs where GitHub already
|
|
44
|
+
* checked the source out, so there is no CodeStar-connection source action to build).
|
|
45
|
+
*/
|
|
46
|
+
export interface GitHubActionsConfig {
|
|
47
|
+
/**
|
|
48
|
+
* Name of the OIDC role the workflow assumes to deploy. Must be a literal (not CDK-generated): the
|
|
49
|
+
* workflow YAML embeds its ARN as plain text, which only works for a name known before synth.
|
|
50
|
+
* @default `<application>-github-role`
|
|
51
|
+
*/
|
|
52
|
+
readonly roleName?: string;
|
|
53
|
+
/**
|
|
54
|
+
* Subject claims allowed to assume the role, e.g. `['repo:owner/repo:ref:refs/heads/main']`. Defaults
|
|
55
|
+
* to every ref/environment of `repository`'s `owner/repo` when omitted.
|
|
56
|
+
*/
|
|
57
|
+
readonly subjectClaims?: string[];
|
|
58
|
+
/** An existing GitHub OIDC provider's ARN. Omit to have one created (one per account/provider URL). */
|
|
59
|
+
readonly openIdConnectProviderArn?: string;
|
|
60
|
+
/** GitHub certificate thumbprints. @default - the built-in, currently-valid set */
|
|
61
|
+
readonly thumbprints?: string[];
|
|
62
|
+
/** File path for the generated workflow. @default ".github/workflows/deploy.yml" */
|
|
63
|
+
readonly workflowPath?: string;
|
|
64
|
+
/** Name of the generated workflow. @default "deploy" */
|
|
65
|
+
readonly workflowName?: string;
|
|
66
|
+
/** GitHub workflow triggers. @default - push to the tracked branch, plus manual dispatch */
|
|
67
|
+
readonly workflowTriggers?: WorkflowTriggers;
|
|
68
|
+
/**
|
|
69
|
+
* Region the workflow assumes the OIDC role in when publishing assets (NOT the region assets publish
|
|
70
|
+
* to). @default "us-west-2"
|
|
71
|
+
*/
|
|
72
|
+
readonly publishAssetsAuthRegion?: string;
|
|
73
|
+
}
|
|
74
|
+
/**
|
|
75
|
+
* How the deployed cloud assembly is produced. See `task.md` D-deploy: two CodePipeline
|
|
76
|
+
* implementations, efficiency first.
|
|
77
|
+
*/
|
|
78
|
+
export declare enum DeployModel {
|
|
79
|
+
/**
|
|
80
|
+
* The default, and what v2 did: the CI/build phase synthesizes every stage **once** and keeps
|
|
81
|
+
* `cdk.out`, which is promoted as the pipeline artifact. Each deploy stage consumes that assembly and
|
|
82
|
+
* performs no synth of its own -- one synth per pipeline run.
|
|
83
|
+
*/
|
|
84
|
+
ASSEMBLY_PROMOTION = "assembly-promotion",
|
|
85
|
+
/**
|
|
86
|
+
* Each stage synthesizes at deploy time from code + pinned deps, against that stage's injected config.
|
|
87
|
+
* The promoted unit is the code, not a baked assembly; CI synth is validation only. Costs one synth per
|
|
88
|
+
* stage, and is the model to pick when a stage's template must be produced with that stage's
|
|
89
|
+
* credentials (for example a synth-time lookup that only the target account can resolve).
|
|
90
|
+
*/
|
|
91
|
+
DEPLOY_TIME_SYNTH = "deploy-time-synth"
|
|
92
|
+
}
|
|
93
|
+
/** Resolved CI configuration: the checks/build steps and which stages CI synthesizes for validation. */
|
|
94
|
+
export interface CiConfig {
|
|
95
|
+
/**
|
|
96
|
+
* Named build steps as shell commands, e.g. `{ lint: 'npx cdk-cicd validate' }`. Empty means the
|
|
97
|
+
* engine applies its built-in default set.
|
|
98
|
+
*/
|
|
99
|
+
readonly steps: {
|
|
100
|
+
[key: string]: string;
|
|
101
|
+
};
|
|
102
|
+
/**
|
|
103
|
+
* Which stages CI synthesizes. Empty means the engine's default -- every stage under
|
|
104
|
+
* `ASSEMBLY_PROMOTION`, one env under `DEPLOY_TIME_SYNTH`. A non-empty list names the stages
|
|
105
|
+
* explicitly; `defineCICD`'s `'all'` shorthand resolves to the full stage list here.
|
|
106
|
+
*/
|
|
107
|
+
readonly synthStages: string[];
|
|
108
|
+
/** Optional CodeBuild image override. */
|
|
109
|
+
readonly image?: string;
|
|
110
|
+
/**
|
|
111
|
+
* Escape hatch (v2 `CDKPipelineProps.ciBuildSpec`, migrated): deep-merged into the CI build project's
|
|
112
|
+
* generated buildspec via `codebuild.mergeBuildSpecs`, augmenting rather than replacing the engine's
|
|
113
|
+
* own phases. Scoped the same way v2 scoped it -- the CI build project only, not self-update or
|
|
114
|
+
* per-stage deploy projects.
|
|
115
|
+
*/
|
|
116
|
+
readonly partialBuildSpec?: codebuild.BuildSpec;
|
|
117
|
+
}
|
|
118
|
+
/**
|
|
119
|
+
* A private CodeArtifact npm repository the pipeline's builds authenticate against. When set, every
|
|
120
|
+
* build project runs `aws codeartifact login` before `npm ci` and is granted read access to the
|
|
121
|
+
* repository -- which is how a pipeline installs private packages (including the wrapper itself before
|
|
122
|
+
* it is published to the public npm registry).
|
|
123
|
+
*/
|
|
124
|
+
export interface CodeArtifactConfig {
|
|
125
|
+
/** The CodeArtifact domain. */
|
|
126
|
+
readonly domain: string;
|
|
127
|
+
/** The repository within the domain. */
|
|
128
|
+
readonly repository: string;
|
|
129
|
+
/** Domain-owning account. Defaults to the pipeline's own account. */
|
|
130
|
+
readonly account?: string;
|
|
131
|
+
/** Region the domain lives in. Defaults to the pipeline's own region. */
|
|
132
|
+
readonly region?: string;
|
|
133
|
+
/** npm scope to bind to the repository, e.g. `cdklabs` for `@cdklabs/*`. Omit for the default scope. */
|
|
134
|
+
readonly npmScope?: string;
|
|
135
|
+
}
|
|
136
|
+
/**
|
|
137
|
+
* HTTP(S) proxy configuration for the pipeline's CodeBuild projects (v2 `IProxyConfig`, migrated).
|
|
138
|
+
* When set, every build project reads proxy credentials from Secrets Manager, exports
|
|
139
|
+
* `HTTP(S)_PROXY` before running its install commands, and curls `proxyTestUrl` to prove the tunnel
|
|
140
|
+
* works before the real install runs.
|
|
141
|
+
*/
|
|
142
|
+
export interface ProxyConfig {
|
|
143
|
+
/**
|
|
144
|
+
* ARN of the Secrets Manager secret holding the proxy credentials, as the keys `username`,
|
|
145
|
+
* `password`, `http_proxy_port`, `https_proxy_port` and `proxy_domain`.
|
|
146
|
+
*/
|
|
147
|
+
readonly proxySecretArn: string;
|
|
148
|
+
/**
|
|
149
|
+
* Hosts that bypass the proxy. Empty means the engine adds its own region's `amazonaws.com`
|
|
150
|
+
* endpoint, so calls to AWS APIs (e.g. a private-registry `codeartifact login`) skip the proxy.
|
|
151
|
+
*/
|
|
152
|
+
readonly noProxy: string[];
|
|
153
|
+
/** URL curl'd (through the proxy) to confirm it works before the install phase's real commands run. */
|
|
154
|
+
readonly proxyTestUrl: string;
|
|
155
|
+
}
|
|
156
|
+
/**
|
|
157
|
+
* A generic private npm registry the pipeline's builds authenticate against with a bearer token (v2
|
|
158
|
+
* `NPMRegistryConfig`, migrated). Unlike `CodeArtifactConfig` (an `aws codeartifact login`), this covers
|
|
159
|
+
* any npm-compatible registry: when set, every build project writes a `.npmrc` -- scoped to `scope` when
|
|
160
|
+
* given, otherwise overriding the default registry -- with an auth token read from Secrets Manager.
|
|
161
|
+
*/
|
|
162
|
+
export interface NpmRegistryConfig {
|
|
163
|
+
/** The registry URL, e.g. `https://npm.example.com/`. */
|
|
164
|
+
readonly url: string;
|
|
165
|
+
/** ARN of the Secrets Manager secret holding the bearer token (the secret's plain `SecretString`). */
|
|
166
|
+
readonly basicAuthSecretArn: string;
|
|
167
|
+
/** npm scope to bind to the registry, e.g. `cdklabs` for `@cdklabs/*`. Omit to override the default registry. */
|
|
168
|
+
readonly scope?: string;
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* VPC configuration for a wrapper-managed VPC (v2 `IManagedVpcConfig`, migrated from `VPCProvider`).
|
|
172
|
+
* Every field is optional; an unset field takes v2's original default.
|
|
173
|
+
*/
|
|
174
|
+
export interface ManagedVpcConfig {
|
|
175
|
+
/** CIDR block for the VPC. @default '172.31.0.0/20' */
|
|
176
|
+
readonly cidrBlock?: string;
|
|
177
|
+
/** Subnet CIDR mask. @default 24 */
|
|
178
|
+
readonly subnetCidrMask?: number;
|
|
179
|
+
/** Max AZs. @default 2 */
|
|
180
|
+
readonly maxAzs?: number;
|
|
181
|
+
/**
|
|
182
|
+
* The subnets the VPC's CodeBuild projects run in. Defaults to `PRIVATE_ISOLATED` when a `proxy`
|
|
183
|
+
* is configured (no NAT egress; the CodeBuild VPC endpoints below cover AWS API calls instead) and
|
|
184
|
+
* `PRIVATE_WITH_EGRESS` otherwise -- the rule v2's `VPCProvider` applied.
|
|
185
|
+
*/
|
|
186
|
+
readonly subnetType?: ec2.SubnetType;
|
|
187
|
+
/**
|
|
188
|
+
* Remove the default inbound/outbound rules from the VPC's default security group.
|
|
189
|
+
* @default true
|
|
190
|
+
*/
|
|
191
|
+
readonly restrictDefaultSecurityGroup?: boolean;
|
|
192
|
+
/** Allow all outbound traffic by default from the security group the wrapper creates. @default true */
|
|
193
|
+
readonly allowAllOutbound?: boolean;
|
|
194
|
+
/**
|
|
195
|
+
* S3 bucket to send VPC flow logs to. v2 always used the RES stage's compliance-log bucket
|
|
196
|
+
* implicitly; v3 has not migrated that bucket yet (`m9-migrate-compliance-bucket`), so this is an
|
|
197
|
+
* explicit prop instead -- omit to skip flow logs.
|
|
198
|
+
*/
|
|
199
|
+
readonly flowLogsBucketName?: string;
|
|
200
|
+
/**
|
|
201
|
+
* Extra CodeBuild VPC interface endpoints beyond the default set (SSM, STS, CloudWatch Logs,
|
|
202
|
+
* CloudFormation, Secrets Manager, KMS). Only used for the isolated-subnet case (see `subnetType`).
|
|
203
|
+
*/
|
|
204
|
+
readonly codeBuildVpcInterfaces?: ec2.InterfaceVpcEndpointAwsService[];
|
|
205
|
+
}
|
|
206
|
+
/**
|
|
207
|
+
* VPC configuration for the pipeline's own CodeBuild projects (v2 `IVpcConfig`, migrated from
|
|
208
|
+
* `VPCProvider`). Set `managedVpc` to have the wrapper create a VPC, or `vpcId` to look up an
|
|
209
|
+
* existing one; setting neither -- the default -- runs every CodeBuild project without a VPC.
|
|
210
|
+
*/
|
|
211
|
+
export interface VpcConfig {
|
|
212
|
+
/** Create a new VPC with these settings. */
|
|
213
|
+
readonly managedVpc?: ManagedVpcConfig;
|
|
214
|
+
/**
|
|
215
|
+
* Look up an existing VPC by id. A value starting with `resolve:ssm:` is resolved from the named
|
|
216
|
+
* SSM parameter at synth time instead of being used literally (v2 `VPCFromLookUpStack` parity).
|
|
217
|
+
*/
|
|
218
|
+
readonly vpcId?: string;
|
|
219
|
+
}
|
|
220
|
+
/** A resolved stage's target environment. `regions` is always a list, even for a single region. */
|
|
221
|
+
export interface StageEnvironment {
|
|
222
|
+
/** Target account. Omitted means environment-agnostic (resolved from ambient creds at deploy). */
|
|
223
|
+
readonly account?: string;
|
|
224
|
+
/** Target regions, in order. Never empty for an environment-specific stage. */
|
|
225
|
+
readonly regions: string[];
|
|
226
|
+
/** How the regions roll out. */
|
|
227
|
+
readonly regionOrder: RegionOrder;
|
|
228
|
+
}
|
|
229
|
+
/** Forced deployer / CloudFormation-execution roles for a stage. */
|
|
230
|
+
export interface DeploymentConfig {
|
|
231
|
+
/** ARN the CLI assumes to deploy (passed as `cdk deploy --role-arn`). */
|
|
232
|
+
readonly deployRole?: string;
|
|
233
|
+
/** ARN CloudFormation assumes to execute the change set. */
|
|
234
|
+
readonly cfnExecutionRole?: string;
|
|
235
|
+
}
|
|
236
|
+
/** A fully resolved deployment stage. */
|
|
237
|
+
export interface ResolvedStage {
|
|
238
|
+
/** Stage name, e.g. `dev`, `prod`. */
|
|
239
|
+
readonly name: string;
|
|
240
|
+
/** Where this stage deploys. */
|
|
241
|
+
readonly env: StageEnvironment;
|
|
242
|
+
/** Whether a manual approval gates this stage. */
|
|
243
|
+
readonly manualApproval: boolean;
|
|
244
|
+
/** Forced roles for this stage, if any. */
|
|
245
|
+
readonly deployment?: DeploymentConfig;
|
|
246
|
+
}
|
|
247
|
+
/** The resolved synthesizer choice. */
|
|
248
|
+
export interface SynthesizerConfig {
|
|
249
|
+
/** The synthesizer to install. */
|
|
250
|
+
readonly type: SynthesizerType;
|
|
251
|
+
}
|
|
252
|
+
/** The fully resolved pipeline configuration `defineCICD` produces. */
|
|
253
|
+
export interface ResolvedCicdConfig {
|
|
254
|
+
/** Application name; drives the bootstrap qualifier and asset naming. */
|
|
255
|
+
readonly application?: string;
|
|
256
|
+
/** Bootstrap qualifier (≤10 chars), derived from `application` when not given. */
|
|
257
|
+
readonly qualifier?: string;
|
|
258
|
+
/** The source repository. */
|
|
259
|
+
readonly repository: Repository;
|
|
260
|
+
/** The deployment stages, in order. */
|
|
261
|
+
readonly stages: ResolvedStage[];
|
|
262
|
+
/** The synthesizer configuration. */
|
|
263
|
+
readonly synthesizer: SynthesizerConfig;
|
|
264
|
+
/** Which engine renders the pipeline. Defaults to CodePipeline. */
|
|
265
|
+
readonly engine: EngineType;
|
|
266
|
+
/** GitHub Actions engine configuration. Only read when `engine` is `EngineType.GITHUB_ACTIONS`. */
|
|
267
|
+
readonly githubActions?: GitHubActionsConfig;
|
|
268
|
+
/** Resolved CI configuration. */
|
|
269
|
+
readonly ci: CiConfig;
|
|
270
|
+
/** Private CodeArtifact npm repository the builds authenticate against, if any. */
|
|
271
|
+
readonly codeArtifact?: CodeArtifactConfig;
|
|
272
|
+
/** Generic private npm registry the builds authenticate against with a bearer token, if any. */
|
|
273
|
+
readonly npmRegistry?: NpmRegistryConfig;
|
|
274
|
+
/** HTTP(S) proxy every build project routes through, if any. */
|
|
275
|
+
readonly proxy?: ProxyConfig;
|
|
276
|
+
/** VPC every CodeBuild project the pipeline creates runs in, if configured (v2 `VPCProvider`, migrated). */
|
|
277
|
+
readonly vpc?: VpcConfig;
|
|
278
|
+
/**
|
|
279
|
+
* The name of the compliance/access-log destination bucket, if configured (v2
|
|
280
|
+
* `ComplianceBucketProvider`/`ComplianceLogBucketStack`, migrated). Threaded into
|
|
281
|
+
* `SupportResources.complianceLogBucket`; see there for the bucket's shape.
|
|
282
|
+
*/
|
|
283
|
+
readonly complianceLogBucketName?: string;
|
|
284
|
+
/**
|
|
285
|
+
* CodeBuild environment overrides -- privileged mode, compute type, environment variables -- applied
|
|
286
|
+
* to every CodeBuild project the pipeline creates (v2 `codeBuildEnvSettings`, migrated from
|
|
287
|
+
* `CodeBuildFactoryProvider`/`PipelineBlueprint.codeBuildEnvSettings(...)`). Reuses CDK's own
|
|
288
|
+
* `BuildEnvironment` rather than a bespoke type, so it stays a drop-in for v2 callers. `buildImage`
|
|
289
|
+
* here is a full `IBuildImage` (e.g. an ARM or GPU managed image); it is distinct from the engines'
|
|
290
|
+
* own `buildImage` constructor prop, which takes a Docker-registry image string -- that prop wins
|
|
291
|
+
* when both are set.
|
|
292
|
+
*/
|
|
293
|
+
readonly codeBuildEnvSettings?: codebuild.BuildEnvironment;
|
|
294
|
+
/** How the deployed cloud assembly is produced. Defaults to `ASSEMBLY_PROMOTION`. */
|
|
295
|
+
readonly deployModel: DeployModel;
|
|
296
|
+
/**
|
|
297
|
+
* Container mode (Repo 1): when set, the pipeline runs CI then builds & pushes a config-agnostic
|
|
298
|
+
* deployer image to ECR instead of deploying stages. Undefined = the normal deploy pipeline. (Named
|
|
299
|
+
* `deployerImage`, not `build` -- jsii reserves `build` as a struct member name.)
|
|
300
|
+
*/
|
|
301
|
+
readonly deployerImage?: BuildImage;
|
|
302
|
+
/**
|
|
303
|
+
* Hand the CloudFormation wait to a Lambda instead of holding CodeBuild compute for it (D-deploy-wait).
|
|
304
|
+
*
|
|
305
|
+
* Off by default: the build-compute path is what `m4-verify` proves end to end, and this one replaces
|
|
306
|
+
* how deployment actually executes -- change sets prepared by the build, then executed and polled by a
|
|
307
|
+
* Lambda -- so it is opt-in until a real run validates it. When on, a deploy stage stops billing build
|
|
308
|
+
* minutes for the (usually dominant) stretch where CloudFormation is working.
|
|
309
|
+
*/
|
|
310
|
+
readonly asyncDeploy: boolean;
|
|
311
|
+
/**
|
|
312
|
+
* Deploy with **CloudFormation express mode** (`cdk deploy --express`). CloudFormation reports each
|
|
313
|
+
* stack operation complete as soon as it applies the resource configuration, *without* waiting for
|
|
314
|
+
* resources to stabilize -- materially faster for stacks whose resources are slow to stabilize.
|
|
315
|
+
* Express runs with **rollback disabled** (a failed deploy is left in a failed state for inspection);
|
|
316
|
+
* forcing `--rollback` conflicts with the change-set path for nested stacks, so the CLI does not add
|
|
317
|
+
* it. AWS does **not** recommend express mode for production -- it targets fast iterative
|
|
318
|
+
* deployments. Off by default.
|
|
319
|
+
*/
|
|
320
|
+
readonly express?: boolean;
|
|
321
|
+
}
|
|
322
|
+
/**
|
|
323
|
+
* A resolved deployment target for container mode (Repo 2): a stage to deploy the pinned image against,
|
|
324
|
+
* with its own environment and optional forced roles. `env` mirrors a `ResolvedStage`'s environment, but a
|
|
325
|
+
* target names the stage it maps to rather than defining it -- the stage's stacks live in the image, not
|
|
326
|
+
* here. `manualApproval` defaults the same way stages do (gated unless `dev`/`res`).
|
|
327
|
+
*/
|
|
328
|
+
export interface ResolvedDeploymentTarget {
|
|
329
|
+
/** The stage in the image's app to deploy (passed to the in-container `cdk-cicd deploy --stage`). */
|
|
330
|
+
readonly stage: string;
|
|
331
|
+
/** Where this target deploys. */
|
|
332
|
+
readonly env: StageEnvironment;
|
|
333
|
+
/** Whether a manual approval gates this target. */
|
|
334
|
+
readonly manualApproval: boolean;
|
|
335
|
+
/** Forced roles for this target, if any. */
|
|
336
|
+
readonly deployment?: DeploymentConfig;
|
|
337
|
+
/**
|
|
338
|
+
* The deployer image (tag/digest) to run for THIS target, overriding the config-level `image`. This is
|
|
339
|
+
* how a stage pins its own application version -- bump `dev`'s tag to ship a new version to dev alone,
|
|
340
|
+
* or set `int`/`prod` to the same tag to promote. When unset, the target uses the config-level `image`.
|
|
341
|
+
*/
|
|
342
|
+
readonly image?: string;
|
|
343
|
+
}
|
|
344
|
+
/**
|
|
345
|
+
* The fully resolved container-mode deployment configuration `defineDeployment` produces (Repo 2 of the
|
|
346
|
+
* two-repo split). It pins one config-agnostic deployer image and lists the targets to run it against;
|
|
347
|
+
* `cdk-cicd deploy --from-image` runs the image per target, synthesizing and deploying in-container.
|
|
348
|
+
*/
|
|
349
|
+
export interface ResolvedDeploymentConfig {
|
|
350
|
+
/**
|
|
351
|
+
* The default deployer image to run targets against (an ECR/OCI reference, tag or digest). A target's
|
|
352
|
+
* own `image` overrides this, so per-stage versions live on the targets; this is the shared fallback.
|
|
353
|
+
* Optional only because every target may pin its own `image` -- each target must resolve to one or the other.
|
|
354
|
+
*/
|
|
355
|
+
readonly image?: string;
|
|
356
|
+
/** The deployment targets, in order. */
|
|
357
|
+
readonly targets: ResolvedDeploymentTarget[];
|
|
358
|
+
/**
|
|
359
|
+
* The config-only source repository the CD pipeline watches (where `deploy.config.ts` lives -- no CDK
|
|
360
|
+
* code). Optional: when omitted, the config drives only the local `cdk-cicd deploy --from-image`
|
|
361
|
+
* executor; set it to provision a CD CodePipeline (`cdk-cicd deploy-ci`) whose CodeBuild pulls the image
|
|
362
|
+
* and deploys each target. This is the deploy-side twin of `ResolvedCicdConfig.repository`.
|
|
363
|
+
*/
|
|
364
|
+
readonly repository?: Repository;
|
|
365
|
+
/**
|
|
366
|
+
* Private CodeArtifact repo the CD build authenticates against before `npm ci` (to install the wrapper
|
|
367
|
+
* CLI when it is pre-release / not on public npm). Same shape as the pipeline-config `codeArtifact`.
|
|
368
|
+
*/
|
|
369
|
+
readonly codeArtifact?: CodeArtifactConfig;
|
|
370
|
+
/**
|
|
371
|
+
* Generic private npm registry the CD build authenticates against before `npm ci`. Same shape as the
|
|
372
|
+
* pipeline-config `npmRegistry`.
|
|
373
|
+
*/
|
|
374
|
+
readonly npmRegistry?: NpmRegistryConfig;
|
|
375
|
+
}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
|
|
3
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
4
|
+
//
|
|
5
|
+
// The RESOLVED cicd-config shape -- the union-free, defaults-applied structs `defineCICD` produces
|
|
6
|
+
// and the CLI (exec/synth/deploy) consumes. The flexible INPUT shapes a user writes (single region or
|
|
7
|
+
// many, a stage as a bare name or an object) use TS unions and live in ./define.ts; they are never
|
|
8
|
+
// part of the jsii surface. Only the resolved structs here cross the language boundary.
|
|
9
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
10
|
+
exports.DeployModel = exports.EngineType = exports.SynthesizerType = exports.RegionOrder = void 0;
|
|
11
|
+
/** Order in which a stage's regions are rolled out. */
|
|
12
|
+
var RegionOrder;
|
|
13
|
+
(function (RegionOrder) {
|
|
14
|
+
/** One region after another (default). */
|
|
15
|
+
RegionOrder["SEQUENTIAL"] = "sequential";
|
|
16
|
+
/** All regions at once. */
|
|
17
|
+
RegionOrder["PARALLEL"] = "parallel";
|
|
18
|
+
})(RegionOrder || (exports.RegionOrder = RegionOrder = {}));
|
|
19
|
+
/** Which stack synthesizer the wrapper installs. */
|
|
20
|
+
var SynthesizerType;
|
|
21
|
+
(function (SynthesizerType) {
|
|
22
|
+
/** `DefaultStackSynthesizer` -- the v3 default. */
|
|
23
|
+
SynthesizerType["DEFAULT"] = "default";
|
|
24
|
+
/** `AppStagingSynthesizer` -- opt-in, still alpha. */
|
|
25
|
+
SynthesizerType["APP_STAGING"] = "app_staging";
|
|
26
|
+
})(SynthesizerType || (exports.SynthesizerType = SynthesizerType = {}));
|
|
27
|
+
/** Which CI/CD engine renders the pipeline. */
|
|
28
|
+
var EngineType;
|
|
29
|
+
(function (EngineType) {
|
|
30
|
+
/**
|
|
31
|
+
* The lightweight flat engine on raw `aws-cdk-lib/aws-codepipeline` -- the v3 default. Its deploy
|
|
32
|
+
* stages re-invoke the app per stage, so the user's `bin` stays a plain single-stage app.
|
|
33
|
+
*/
|
|
34
|
+
EngineType["CODEPIPELINE"] = "codepipeline";
|
|
35
|
+
/**
|
|
36
|
+
* The v2-compatible self-mutating pipeline on `aws-cdk-lib/pipelines` (Source -> Synth -> Assets ->
|
|
37
|
+
* one wave per stage). `cdk-cicd exec` assembles it by replaying the plain `bin` once per configured
|
|
38
|
+
* stage (see runtime/pipeline-assembler), so the user's `bin` still needs no wrapper code.
|
|
39
|
+
*/
|
|
40
|
+
EngineType["CDK_PIPELINES"] = "cdk-pipelines";
|
|
41
|
+
/**
|
|
42
|
+
* Renders a GitHub Actions workflow (`cdk-pipelines-github`) instead of an AWS-hosted pipeline (v2
|
|
43
|
+
* `GitHubPipelinePlugin`, migrated). Like `CDK_PIPELINES`, it needs every stage built as a `cdk.Stage`
|
|
44
|
+
* inside one synth, so `cdk-cicd exec` assembles it the same way -- replaying the plain `bin` once per
|
|
45
|
+
* configured stage.
|
|
46
|
+
*/
|
|
47
|
+
EngineType["GITHUB_ACTIONS"] = "github-actions";
|
|
48
|
+
})(EngineType || (exports.EngineType = EngineType = {}));
|
|
49
|
+
/**
|
|
50
|
+
* How the deployed cloud assembly is produced. See `task.md` D-deploy: two CodePipeline
|
|
51
|
+
* implementations, efficiency first.
|
|
52
|
+
*/
|
|
53
|
+
var DeployModel;
|
|
54
|
+
(function (DeployModel) {
|
|
55
|
+
/**
|
|
56
|
+
* The default, and what v2 did: the CI/build phase synthesizes every stage **once** and keeps
|
|
57
|
+
* `cdk.out`, which is promoted as the pipeline artifact. Each deploy stage consumes that assembly and
|
|
58
|
+
* performs no synth of its own -- one synth per pipeline run.
|
|
59
|
+
*/
|
|
60
|
+
DeployModel["ASSEMBLY_PROMOTION"] = "assembly-promotion";
|
|
61
|
+
/**
|
|
62
|
+
* Each stage synthesizes at deploy time from code + pinned deps, against that stage's injected config.
|
|
63
|
+
* The promoted unit is the code, not a baked assembly; CI synth is validation only. Costs one synth per
|
|
64
|
+
* stage, and is the model to pick when a stage's template must be produced with that stage's
|
|
65
|
+
* credentials (for example a synth-time lookup that only the target account can resolve).
|
|
66
|
+
*/
|
|
67
|
+
DeployModel["DEPLOY_TIME_SYNTH"] = "deploy-time-synth";
|
|
68
|
+
})(DeployModel || (exports.DeployModel = DeployModel = {}));
|
|
69
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29uZmlnL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQSxxRUFBcUU7QUFDckUsc0NBQXNDO0FBQ3RDLEVBQUU7QUFDRixtR0FBbUc7QUFDbkcsc0dBQXNHO0FBQ3RHLG1HQUFtRztBQUNuRyx3RkFBd0Y7OztBQU94Rix1REFBdUQ7QUFDdkQsSUFBWSxXQUtYO0FBTEQsV0FBWSxXQUFXO0lBQ3JCLDBDQUEwQztJQUMxQyx3Q0FBeUIsQ0FBQTtJQUN6QiwyQkFBMkI7SUFDM0Isb0NBQXFCLENBQUE7QUFDdkIsQ0FBQyxFQUxXLFdBQVcsMkJBQVgsV0FBVyxRQUt0QjtBQUVELG9EQUFvRDtBQUNwRCxJQUFZLGVBS1g7QUFMRCxXQUFZLGVBQWU7SUFDekIsbURBQW1EO0lBQ25ELHNDQUFtQixDQUFBO0lBQ25CLHNEQUFzRDtJQUN0RCw4Q0FBMkIsQ0FBQTtBQUM3QixDQUFDLEVBTFcsZUFBZSwrQkFBZixlQUFlLFFBSzFCO0FBRUQsK0NBQStDO0FBQy9DLElBQVksVUFtQlg7QUFuQkQsV0FBWSxVQUFVO0lBQ3BCOzs7T0FHRztJQUNILDJDQUE2QixDQUFBO0lBQzdCOzs7O09BSUc7SUFDSCw2Q0FBK0IsQ0FBQTtJQUMvQjs7Ozs7T0FLRztJQUNILCtDQUFpQyxDQUFBO0FBQ25DLENBQUMsRUFuQlcsVUFBVSwwQkFBVixVQUFVLFFBbUJyQjtBQXFDRDs7O0dBR0c7QUFDSCxJQUFZLFdBY1g7QUFkRCxXQUFZLFdBQVc7SUFDckI7Ozs7T0FJRztJQUNILHdEQUF5QyxDQUFBO0lBQ3pDOzs7OztPQUtHO0lBQ0gsc0RBQXVDLENBQUE7QUFDekMsQ0FBQyxFQWRXLFdBQVcsMkJBQVgsV0FBVyxRQWN0QiIsInNvdXJjZXNDb250ZW50IjpbIi8vIENvcHlyaWdodCBBbWF6b24uY29tLCBJbmMuIG9yIGl0cyBhZmZpbGlhdGVzLiBBbGwgUmlnaHRzIFJlc2VydmVkLlxuLy8gU1BEWC1MaWNlbnNlLUlkZW50aWZpZXI6IEFwYWNoZS0yLjBcbi8vXG4vLyBUaGUgUkVTT0xWRUQgY2ljZC1jb25maWcgc2hhcGUgLS0gdGhlIHVuaW9uLWZyZWUsIGRlZmF1bHRzLWFwcGxpZWQgc3RydWN0cyBgZGVmaW5lQ0lDRGAgcHJvZHVjZXNcbi8vIGFuZCB0aGUgQ0xJIChleGVjL3N5bnRoL2RlcGxveSkgY29uc3VtZXMuIFRoZSBmbGV4aWJsZSBJTlBVVCBzaGFwZXMgYSB1c2VyIHdyaXRlcyAoc2luZ2xlIHJlZ2lvbiBvclxuLy8gbWFueSwgYSBzdGFnZSBhcyBhIGJhcmUgbmFtZSBvciBhbiBvYmplY3QpIHVzZSBUUyB1bmlvbnMgYW5kIGxpdmUgaW4gLi9kZWZpbmUudHM7IHRoZXkgYXJlIG5ldmVyXG4vLyBwYXJ0IG9mIHRoZSBqc2lpIHN1cmZhY2UuIE9ubHkgdGhlIHJlc29sdmVkIHN0cnVjdHMgaGVyZSBjcm9zcyB0aGUgbGFuZ3VhZ2UgYm91bmRhcnkuXG5cbmltcG9ydCB7IGF3c19jb2RlYnVpbGQgYXMgY29kZWJ1aWxkLCBhd3NfZWMyIGFzIGVjMiB9IGZyb20gJ2F3cy1jZGstbGliJztcbmltcG9ydCB7IFdvcmtmbG93VHJpZ2dlcnMgfSBmcm9tICdjZGstcGlwZWxpbmVzLWdpdGh1Yic7XG5pbXBvcnQgeyBCdWlsZEltYWdlIH0gZnJvbSAnLi9idWlsZC1pbWFnZSc7XG5pbXBvcnQgeyBSZXBvc2l0b3J5IH0gZnJvbSAnLi9yZXBvc2l0b3J5JztcblxuLyoqIE9yZGVyIGluIHdoaWNoIGEgc3RhZ2UncyByZWdpb25zIGFyZSByb2xsZWQgb3V0LiAqL1xuZXhwb3J0IGVudW0gUmVnaW9uT3JkZXIge1xuICAvKiogT25lIHJlZ2lvbiBhZnRlciBhbm90aGVyIChkZWZhdWx0KS4gKi9cbiAgU0VRVUVOVElBTCA9ICdzZXF1ZW50aWFsJyxcbiAgLyoqIEFsbCByZWdpb25zIGF0IG9uY2UuICovXG4gIFBBUkFMTEVMID0gJ3BhcmFsbGVsJyxcbn1cblxuLyoqIFdoaWNoIHN0YWNrIHN5bnRoZXNpemVyIHRoZSB3cmFwcGVyIGluc3RhbGxzLiAqL1xuZXhwb3J0IGVudW0gU3ludGhlc2l6ZXJUeXBlIHtcbiAgLyoqIGBEZWZhdWx0U3RhY2tTeW50aGVzaXplcmAgLS0gdGhlIHYzIGRlZmF1bHQuICovXG4gIERFRkFVTFQgPSAnZGVmYXVsdCcsXG4gIC8qKiBgQXBwU3RhZ2luZ1N5bnRoZXNpemVyYCAtLSBvcHQtaW4sIHN0aWxsIGFscGhhLiAqL1xuICBBUFBfU1RBR0lORyA9ICdhcHBfc3RhZ2luZycsXG59XG5cbi8qKiBXaGljaCBDSS9DRCBlbmdpbmUgcmVuZGVycyB0aGUgcGlwZWxpbmUuICovXG5leHBvcnQgZW51bSBFbmdpbmVUeXBlIHtcbiAgLyoqXG4gICAqIFRoZSBsaWdodHdlaWdodCBmbGF0IGVuZ2luZSBvbiByYXcgYGF3cy1jZGstbGliL2F3cy1jb2RlcGlwZWxpbmVgIC0tIHRoZSB2MyBkZWZhdWx0LiBJdHMgZGVwbG95XG4gICAqIHN0YWdlcyByZS1pbnZva2UgdGhlIGFwcCBwZXIgc3RhZ2UsIHNvIHRoZSB1c2VyJ3MgYGJpbmAgc3RheXMgYSBwbGFpbiBzaW5nbGUtc3RhZ2UgYXBwLlxuICAgKi9cbiAgQ09ERVBJUEVMSU5FID0gJ2NvZGVwaXBlbGluZScsXG4gIC8qKlxuICAgKiBUaGUgdjItY29tcGF0aWJsZSBzZWxmLW11dGF0aW5nIHBpcGVsaW5lIG9uIGBhd3MtY2RrLWxpYi9waXBlbGluZXNgIChTb3VyY2UgLT4gU3ludGggLT4gQXNzZXRzIC0+XG4gICAqIG9uZSB3YXZlIHBlciBzdGFnZSkuIGBjZGstY2ljZCBleGVjYCBhc3NlbWJsZXMgaXQgYnkgcmVwbGF5aW5nIHRoZSBwbGFpbiBgYmluYCBvbmNlIHBlciBjb25maWd1cmVkXG4gICAqIHN0YWdlIChzZWUgcnVudGltZS9waXBlbGluZS1hc3NlbWJsZXIpLCBzbyB0aGUgdXNlcidzIGBiaW5gIHN0aWxsIG5lZWRzIG5vIHdyYXBwZXIgY29kZS5cbiAgICovXG4gIENES19QSVBFTElORVMgPSAnY2RrLXBpcGVsaW5lcycsXG4gIC8qKlxuICAgKiBSZW5kZXJzIGEgR2l0SHViIEFjdGlvbnMgd29ya2Zsb3cgKGBjZGstcGlwZWxpbmVzLWdpdGh1YmApIGluc3RlYWQgb2YgYW4gQVdTLWhvc3RlZCBwaXBlbGluZSAodjJcbiAgICogYEdpdEh1YlBpcGVsaW5lUGx1Z2luYCwgbWlncmF0ZWQpLiBMaWtlIGBDREtfUElQRUxJTkVTYCwgaXQgbmVlZHMgZXZlcnkgc3RhZ2UgYnVpbHQgYXMgYSBgY2RrLlN0YWdlYFxuICAgKiBpbnNpZGUgb25lIHN5bnRoLCBzbyBgY2RrLWNpY2QgZXhlY2AgYXNzZW1ibGVzIGl0IHRoZSBzYW1lIHdheSAtLSByZXBsYXlpbmcgdGhlIHBsYWluIGBiaW5gIG9uY2UgcGVyXG4gICAqIGNvbmZpZ3VyZWQgc3RhZ2UuXG4gICAqL1xuICBHSVRIVUJfQUNUSU9OUyA9ICdnaXRodWItYWN0aW9ucycsXG59XG5cbi8qKlxuICogR2l0SHViIEFjdGlvbnMgZW5naW5lIGNvbmZpZ3VyYXRpb246IHRoZSBPSURDIHJvbGUgdGhlIHdvcmtmbG93IGFzc3VtZXMgcGx1cyB0aGUgd29ya2Zsb3cgZmlsZSdzIG93blxuICogaWRlbnRpdHkgKHYyIGBHaXRIdWJQaXBlbGluZVBsdWdpbk9wdGlvbnNgLCBtaWdyYXRlZCkuIE9ubHkgcmVhZCB3aGVuIGBlbmdpbmVgIGlzIGBHSVRIVUJfQUNUSU9OU2A7XG4gKiBgcmVwb3NpdG9yeWAgbXVzdCBiZSBgUmVwb3NpdG9yeS5naXRodWIoLi4uKWAgaW4gdGhhdCBjYXNlICh0aGUgd29ya2Zsb3cgcnVucyB3aGVyZSBHaXRIdWIgYWxyZWFkeVxuICogY2hlY2tlZCB0aGUgc291cmNlIG91dCwgc28gdGhlcmUgaXMgbm8gQ29kZVN0YXItY29ubmVjdGlvbiBzb3VyY2UgYWN0aW9uIHRvIGJ1aWxkKS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBHaXRIdWJBY3Rpb25zQ29uZmlnIHtcbiAgLyoqXG4gICAqIE5hbWUgb2YgdGhlIE9JREMgcm9sZSB0aGUgd29ya2Zsb3cgYXNzdW1lcyB0byBkZXBsb3kuIE11c3QgYmUgYSBsaXRlcmFsIChub3QgQ0RLLWdlbmVyYXRlZCk6IHRoZVxuICAgKiB3b3JrZmxvdyBZQU1MIGVtYmVkcyBpdHMgQVJOIGFzIHBsYWluIHRleHQsIHdoaWNoIG9ubHkgd29ya3MgZm9yIGEgbmFtZSBrbm93biBiZWZvcmUgc3ludGguXG4gICAqIEBkZWZhdWx0IGA8YXBwbGljYXRpb24+LWdpdGh1Yi1yb2xlYFxuICAgKi9cbiAgcmVhZG9ubHkgcm9sZU5hbWU/OiBzdHJpbmc7XG4gIC8qKlxuICAgKiBTdWJqZWN0IGNsYWltcyBhbGxvd2VkIHRvIGFzc3VtZSB0aGUgcm9sZSwgZS5nLiBgWydyZXBvOm93bmVyL3JlcG86cmVmOnJlZnMvaGVhZHMvbWFpbiddYC4gRGVmYXVsdHNcbiAgICogdG8gZXZlcnkgcmVmL2Vudmlyb25tZW50IG9mIGByZXBvc2l0b3J5YCdzIGBvd25lci9yZXBvYCB3aGVuIG9taXR0ZWQuXG4gICAqL1xuICByZWFkb25seSBzdWJqZWN0Q2xhaW1zPzogc3RyaW5nW107XG4gIC8qKiBBbiBleGlzdGluZyBHaXRIdWIgT0lEQyBwcm92aWRlcidzIEFSTi4gT21pdCB0byBoYXZlIG9uZSBjcmVhdGVkIChvbmUgcGVyIGFjY291bnQvcHJvdmlkZXIgVVJMKS4gKi9cbiAgcmVhZG9ubHkgb3BlbklkQ29ubmVjdFByb3ZpZGVyQXJuPzogc3RyaW5nO1xuICAvKiogR2l0SHViIGNlcnRpZmljYXRlIHRodW1icHJpbnRzLiBAZGVmYXVsdCAtIHRoZSBidWlsdC1pbiwgY3VycmVudGx5LXZhbGlkIHNldCAqL1xuICByZWFkb25seSB0aHVtYnByaW50cz86IHN0cmluZ1tdO1xuICAvKiogRmlsZSBwYXRoIGZvciB0aGUgZ2VuZXJhdGVkIHdvcmtmbG93LiBAZGVmYXVsdCBcIi5naXRodWIvd29ya2Zsb3dzL2RlcGxveS55bWxcIiAqL1xuICByZWFkb25seSB3b3JrZmxvd1BhdGg/OiBzdHJpbmc7XG4gIC8qKiBOYW1lIG9mIHRoZSBnZW5lcmF0ZWQgd29ya2Zsb3cuIEBkZWZhdWx0IFwiZGVwbG95XCIgKi9cbiAgcmVhZG9ubHkgd29ya2Zsb3dOYW1lPzogc3RyaW5nO1xuICAvKiogR2l0SHViIHdvcmtmbG93IHRyaWdnZXJzLiBAZGVmYXVsdCAtIHB1c2ggdG8gdGhlIHRyYWNrZWQgYnJhbmNoLCBwbHVzIG1hbnVhbCBkaXNwYXRjaCAqL1xuICByZWFkb25seSB3b3JrZmxvd1RyaWdnZXJzPzogV29ya2Zsb3dUcmlnZ2VycztcbiAgLyoqXG4gICAqIFJlZ2lvbiB0aGUgd29ya2Zsb3cgYXNzdW1lcyB0aGUgT0lEQyByb2xlIGluIHdoZW4gcHVibGlzaGluZyBhc3NldHMgKE5PVCB0aGUgcmVnaW9uIGFzc2V0cyBwdWJsaXNoXG4gICAqIHRvKS4gQGRlZmF1bHQgXCJ1cy13ZXN0LTJcIlxuICAgKi9cbiAgcmVhZG9ubHkgcHVibGlzaEFzc2V0c0F1dGhSZWdpb24/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogSG93IHRoZSBkZXBsb3llZCBjbG91ZCBhc3NlbWJseSBpcyBwcm9kdWNlZC4gU2VlIGB0YXNrLm1kYCBELWRlcGxveTogdHdvIENvZGVQaXBlbGluZVxuICogaW1wbGVtZW50YXRpb25zLCBlZmZpY2llbmN5IGZpcnN0LlxuICovXG5leHBvcnQgZW51bSBEZXBsb3lNb2RlbCB7XG4gIC8qKlxuICAgKiBUaGUgZGVmYXVsdCwgYW5kIHdoYXQgdjIgZGlkOiB0aGUgQ0kvYnVpbGQgcGhhc2Ugc3ludGhlc2l6ZXMgZXZlcnkgc3RhZ2UgKipvbmNlKiogYW5kIGtlZXBzXG4gICAqIGBjZGsub3V0YCwgd2hpY2ggaXMgcHJvbW90ZWQgYXMgdGhlIHBpcGVsaW5lIGFydGlmYWN0LiBFYWNoIGRlcGxveSBzdGFnZSBjb25zdW1lcyB0aGF0IGFzc2VtYmx5IGFuZFxuICAgKiBwZXJmb3JtcyBubyBzeW50aCBvZiBpdHMgb3duIC0tIG9uZSBzeW50aCBwZXIgcGlwZWxpbmUgcnVuLlxuICAgKi9cbiAgQVNTRU1CTFlfUFJPTU9USU9OID0gJ2Fzc2VtYmx5LXByb21vdGlvbicsXG4gIC8qKlxuICAgKiBFYWNoIHN0YWdlIHN5bnRoZXNpemVzIGF0IGRlcGxveSB0aW1lIGZyb20gY29kZSArIHBpbm5lZCBkZXBzLCBhZ2FpbnN0IHRoYXQgc3RhZ2UncyBpbmplY3RlZCBjb25maWcuXG4gICAqIFRoZSBwcm9tb3RlZCB1bml0IGlzIHRoZSBjb2RlLCBub3QgYSBiYWtlZCBhc3NlbWJseTsgQ0kgc3ludGggaXMgdmFsaWRhdGlvbiBvbmx5LiBDb3N0cyBvbmUgc3ludGggcGVyXG4gICAqIHN0YWdlLCBhbmQgaXMgdGhlIG1vZGVsIHRvIHBpY2sgd2hlbiBhIHN0YWdlJ3MgdGVtcGxhdGUgbXVzdCBiZSBwcm9kdWNlZCB3aXRoIHRoYXQgc3RhZ2Unc1xuICAgKiBjcmVkZW50aWFscyAoZm9yIGV4YW1wbGUgYSBzeW50aC10aW1lIGxvb2t1cCB0aGF0IG9ubHkgdGhlIHRhcmdldCBhY2NvdW50IGNhbiByZXNvbHZlKS5cbiAgICovXG4gIERFUExPWV9USU1FX1NZTlRIID0gJ2RlcGxveS10aW1lLXN5bnRoJyxcbn1cblxuLyoqIFJlc29sdmVkIENJIGNvbmZpZ3VyYXRpb246IHRoZSBjaGVja3MvYnVpbGQgc3RlcHMgYW5kIHdoaWNoIHN0YWdlcyBDSSBzeW50aGVzaXplcyBmb3IgdmFsaWRhdGlvbi4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ2lDb25maWcge1xuICAvKipcbiAgICogTmFtZWQgYnVpbGQgc3RlcHMgYXMgc2hlbGwgY29tbWFuZHMsIGUuZy4gYHsgbGludDogJ25weCBjZGstY2ljZCB2YWxpZGF0ZScgfWAuIEVtcHR5IG1lYW5zIHRoZVxuICAgKiBlbmdpbmUgYXBwbGllcyBpdHMgYnVpbHQtaW4gZGVmYXVsdCBzZXQuXG4gICAqL1xuICByZWFkb25seSBzdGVwczogeyBba2V5OiBzdHJpbmddOiBzdHJpbmcgfTtcbiAgLyoqXG4gICAqIFdoaWNoIHN0YWdlcyBDSSBzeW50aGVzaXplcy4gRW1wdHkgbWVhbnMgdGhlIGVuZ2luZSdzIGRlZmF1bHQgLS0gZXZlcnkgc3RhZ2UgdW5kZXJcbiAgICogYEFTU0VNQkxZX1BST01PVElPTmAsIG9uZSBlbnYgdW5kZXIgYERFUExPWV9USU1FX1NZTlRIYC4gQSBub24tZW1wdHkgbGlzdCBuYW1lcyB0aGUgc3RhZ2VzXG4gICAqIGV4cGxpY2l0bHk7IGBkZWZpbmVDSUNEYCdzIGAnYWxsJ2Agc2hvcnRoYW5kIHJlc29sdmVzIHRvIHRoZSBmdWxsIHN0YWdlIGxpc3QgaGVyZS5cbiAgICovXG4gIHJlYWRvbmx5IHN5bnRoU3RhZ2VzOiBzdHJpbmdbXTtcbiAgLyoqIE9wdGlvbmFsIENvZGVCdWlsZCBpbWFnZSBvdmVycmlkZS4gKi9cbiAgcmVhZG9ubHkgaW1hZ2U/OiBzdHJpbmc7XG4gIC8qKlxuICAgKiBFc2NhcGUgaGF0Y2ggKHYyIGBDREtQaXBlbGluZVByb3BzLmNpQnVpbGRTcGVjYCwgbWlncmF0ZWQpOiBkZWVwLW1lcmdlZCBpbnRvIHRoZSBDSSBidWlsZCBwcm9qZWN0J3NcbiAgICogZ2VuZXJhdGVkIGJ1aWxkc3BlYyB2aWEgYGNvZGVidWlsZC5tZXJnZUJ1aWxkU3BlY3NgLCBhdWdtZW50aW5nIHJhdGhlciB0aGFuIHJlcGxhY2luZyB0aGUgZW5naW5lJ3NcbiAgICogb3duIHBoYXNlcy4gU2NvcGVkIHRoZSBzYW1lIHdheSB2MiBzY29wZWQgaXQgLS0gdGhlIENJIGJ1aWxkIHByb2plY3Qgb25seSwgbm90IHNlbGYtdXBkYXRlIG9yXG4gICAqIHBlci1zdGFnZSBkZXBsb3kgcHJvamVjdHMuXG4gICAqL1xuICByZWFkb25seSBwYXJ0aWFsQnVpbGRTcGVjPzogY29kZWJ1aWxkLkJ1aWxkU3BlYztcbn1cblxuLyoqXG4gKiBBIHByaXZhdGUgQ29kZUFydGlmYWN0IG5wbSByZXBvc2l0b3J5IHRoZSBwaXBlbGluZSdzIGJ1aWxkcyBhdXRoZW50aWNhdGUgYWdhaW5zdC4gV2hlbiBzZXQsIGV2ZXJ5XG4gKiBidWlsZCBwcm9qZWN0IHJ1bnMgYGF3cyBjb2RlYXJ0aWZhY3QgbG9naW5gIGJlZm9yZSBgbnBtIGNpYCBhbmQgaXMgZ3JhbnRlZCByZWFkIGFjY2VzcyB0byB0aGVcbiAqIHJlcG9zaXRvcnkgLS0gd2hpY2ggaXMgaG93IGEgcGlwZWxpbmUgaW5zdGFsbHMgcHJpdmF0ZSBwYWNrYWdlcyAoaW5jbHVkaW5nIHRoZSB3cmFwcGVyIGl0c2VsZiBiZWZvcmVcbiAqIGl0IGlzIHB1Ymxpc2hlZCB0byB0aGUgcHVibGljIG5wbSByZWdpc3RyeSkuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQ29kZUFydGlmYWN0Q29uZmlnIHtcbiAgLyoqIFRoZSBDb2RlQXJ0aWZhY3QgZG9tYWluLiAqL1xuICByZWFkb25seSBkb21haW46IHN0cmluZztcbiAgLyoqIFRoZSByZXBvc2l0b3J5IHdpdGhpbiB0aGUgZG9tYWluLiAqL1xuICByZWFkb25seSByZXBvc2l0b3J5OiBzdHJpbmc7XG4gIC8qKiBEb21haW4tb3duaW5nIGFjY291bnQuIERlZmF1bHRzIHRvIHRoZSBwaXBlbGluZSdzIG93biBhY2NvdW50LiAqL1xuICByZWFkb25seSBhY2NvdW50Pzogc3RyaW5nO1xuICAvKiogUmVnaW9uIHRoZSBkb21haW4gbGl2ZXMgaW4uIERlZmF1bHRzIHRvIHRoZSBwaXBlbGluZSdzIG93biByZWdpb24uICovXG4gIHJlYWRvbmx5IHJlZ2lvbj86IHN0cmluZztcbiAgLyoqIG5wbSBzY29wZSB0byBiaW5kIHRvIHRoZSByZXBvc2l0b3J5LCBlLmcuIGBjZGtsYWJzYCBmb3IgYEBjZGtsYWJzLypgLiBPbWl0IGZvciB0aGUgZGVmYXVsdCBzY29wZS4gKi9cbiAgcmVhZG9ubHkgbnBtU2NvcGU/OiBzdHJpbmc7XG59XG5cbi8qKlxuICogSFRUUChTKSBwcm94eSBjb25maWd1cmF0aW9uIGZvciB0aGUgcGlwZWxpbmUncyBDb2RlQnVpbGQgcHJvamVjdHMgKHYyIGBJUHJveHlDb25maWdgLCBtaWdyYXRlZCkuXG4gKiBXaGVuIHNldCwgZXZlcnkgYnVpbGQgcHJvamVjdCByZWFkcyBwcm94eSBjcmVkZW50aWFscyBmcm9tIFNlY3JldHMgTWFuYWdlciwgZXhwb3J0c1xuICogYEhUVFAoUylfUFJPWFlgIGJlZm9yZSBydW5uaW5nIGl0cyBpbnN0YWxsIGNvbW1hbmRzLCBhbmQgY3VybHMgYHByb3h5VGVzdFVybGAgdG8gcHJvdmUgdGhlIHR1bm5lbFxuICogd29ya3MgYmVmb3JlIHRoZSByZWFsIGluc3RhbGwgcnVucy5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBQcm94eUNvbmZpZyB7XG4gIC8qKlxuICAgKiBBUk4gb2YgdGhlIFNlY3JldHMgTWFuYWdlciBzZWNyZXQgaG9sZGluZyB0aGUgcHJveHkgY3JlZGVudGlhbHMsIGFzIHRoZSBrZXlzIGB1c2VybmFtZWAsXG4gICAqIGBwYXNzd29yZGAsIGBodHRwX3Byb3h5X3BvcnRgLCBgaHR0cHNfcHJveHlfcG9ydGAgYW5kIGBwcm94eV9kb21haW5gLlxuICAgKi9cbiAgcmVhZG9ubHkgcHJveHlTZWNyZXRBcm46IHN0cmluZztcbiAgLyoqXG4gICAqIEhvc3RzIHRoYXQgYnlwYXNzIHRoZSBwcm94eS4gRW1wdHkgbWVhbnMgdGhlIGVuZ2luZSBhZGRzIGl0cyBvd24gcmVnaW9uJ3MgYGFtYXpvbmF3cy5jb21gXG4gICAqIGVuZHBvaW50LCBzbyBjYWxscyB0byBBV1MgQVBJcyAoZS5nLiBhIHByaXZhdGUtcmVnaXN0cnkgYGNvZGVhcnRpZmFjdCBsb2dpbmApIHNraXAgdGhlIHByb3h5LlxuICAgKi9cbiAgcmVhZG9ubHkgbm9Qcm94eTogc3RyaW5nW107XG4gIC8qKiBVUkwgY3VybCdkICh0aHJvdWdoIHRoZSBwcm94eSkgdG8gY29uZmlybSBpdCB3b3JrcyBiZWZvcmUgdGhlIGluc3RhbGwgcGhhc2UncyByZWFsIGNvbW1hbmRzIHJ1bi4gKi9cbiAgcmVhZG9ubHkgcHJveHlUZXN0VXJsOiBzdHJpbmc7XG59XG5cbi8qKlxuICogQSBnZW5lcmljIHByaXZhdGUgbnBtIHJlZ2lzdHJ5IHRoZSBwaXBlbGluZSdzIGJ1aWxkcyBhdXRoZW50aWNhdGUgYWdhaW5zdCB3aXRoIGEgYmVhcmVyIHRva2VuICh2MlxuICogYE5QTVJlZ2lzdHJ5Q29uZmlnYCwgbWlncmF0ZWQpLiBVbmxpa2UgYENvZGVBcnRpZmFjdENvbmZpZ2AgKGFuIGBhd3MgY29kZWFydGlmYWN0IGxvZ2luYCksIHRoaXMgY292ZXJzXG4gKiBhbnkgbnBtLWNvbXBhdGlibGUgcmVnaXN0cnk6IHdoZW4gc2V0LCBldmVyeSBidWlsZCBwcm9qZWN0IHdyaXRlcyBhIGAubnBtcmNgIC0tIHNjb3BlZCB0byBgc2NvcGVgIHdoZW5cbiAqIGdpdmVuLCBvdGhlcndpc2Ugb3ZlcnJpZGluZyB0aGUgZGVmYXVsdCByZWdpc3RyeSAtLSB3aXRoIGFuIGF1dGggdG9rZW4gcmVhZCBmcm9tIFNlY3JldHMgTWFuYWdlci5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBOcG1SZWdpc3RyeUNvbmZpZyB7XG4gIC8qKiBUaGUgcmVnaXN0cnkgVVJMLCBlLmcuIGBodHRwczovL25wbS5leGFtcGxlLmNvbS9gLiAqL1xuICByZWFkb25seSB1cmw6IHN0cmluZztcbiAgLyoqIEFSTiBvZiB0aGUgU2VjcmV0cyBNYW5hZ2VyIHNlY3JldCBob2xkaW5nIHRoZSBiZWFyZXIgdG9rZW4gKHRoZSBzZWNyZXQncyBwbGFpbiBgU2VjcmV0U3RyaW5nYCkuICovXG4gIHJlYWRvbmx5IGJhc2ljQXV0aFNlY3JldEFybjogc3RyaW5nO1xuICAvKiogbnBtIHNjb3BlIHRvIGJpbmQgdG8gdGhlIHJlZ2lzdHJ5LCBlLmcuIGBjZGtsYWJzYCBmb3IgYEBjZGtsYWJzLypgLiBPbWl0IHRvIG92ZXJyaWRlIHRoZSBkZWZhdWx0IHJlZ2lzdHJ5LiAqL1xuICByZWFkb25seSBzY29wZT86IHN0cmluZztcbn1cblxuLyoqXG4gKiBWUEMgY29uZmlndXJhdGlvbiBmb3IgYSB3cmFwcGVyLW1hbmFnZWQgVlBDICh2MiBgSU1hbmFnZWRWcGNDb25maWdgLCBtaWdyYXRlZCBmcm9tIGBWUENQcm92aWRlcmApLlxuICogRXZlcnkgZmllbGQgaXMgb3B0aW9uYWw7IGFuIHVuc2V0IGZpZWxkIHRha2VzIHYyJ3Mgb3JpZ2luYWwgZGVmYXVsdC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBNYW5hZ2VkVnBjQ29uZmlnIHtcbiAgLyoqIENJRFIgYmxvY2sgZm9yIHRoZSBWUEMuIEBkZWZhdWx0ICcxNzIuMzEuMC4wLzIwJyAqL1xuICByZWFkb25seSBjaWRyQmxvY2s/OiBzdHJpbmc7XG4gIC8qKiBTdWJuZXQgQ0lEUiBtYXNrLiBAZGVmYXVsdCAyNCAqL1xuICByZWFkb25seSBzdWJuZXRDaWRyTWFzaz86IG51bWJlcjtcbiAgLyoqIE1heCBBWnMuIEBkZWZhdWx0IDIgKi9cbiAgcmVhZG9ubHkgbWF4QXpzPzogbnVtYmVyO1xuICAvKipcbiAgICogVGhlIHN1Ym5ldHMgdGhlIFZQQydzIENvZGVCdWlsZCBwcm9qZWN0cyBydW4gaW4uIERlZmF1bHRzIHRvIGBQUklWQVRFX0lTT0xBVEVEYCB3aGVuIGEgYHByb3h5YFxuICAgKiBpcyBjb25maWd1cmVkIChubyBOQVQgZWdyZXNzOyB0aGUgQ29kZUJ1aWxkIFZQQyBlbmRwb2ludHMgYmVsb3cgY292ZXIgQVdTIEFQSSBjYWxscyBpbnN0ZWFkKSBhbmRcbiAgICogYFBSSVZBVEVfV0lUSF9FR1JFU1NgIG90aGVyd2lzZSAtLSB0aGUgcnVsZSB2MidzIGBWUENQcm92aWRlcmAgYXBwbGllZC5cbiAgICovXG4gIHJlYWRvbmx5IHN1Ym5ldFR5cGU/OiBlYzIuU3VibmV0VHlwZTtcbiAgLyoqXG4gICAqIFJlbW92ZSB0aGUgZGVmYXVsdCBpbmJvdW5kL291dGJvdW5kIHJ1bGVzIGZyb20gdGhlIFZQQydzIGRlZmF1bHQgc2VjdXJpdHkgZ3JvdXAuXG4gICAqIEBkZWZhdWx0IHRydWVcbiAgICovXG4gIHJlYWRvbmx5IHJlc3RyaWN0RGVmYXVsdFNlY3VyaXR5R3JvdXA/OiBib29sZWFuO1xuICAvKiogQWxsb3cgYWxsIG91dGJvdW5kIHRyYWZmaWMgYnkgZGVmYXVsdCBmcm9tIHRoZSBzZWN1cml0eSBncm91cCB0aGUgd3JhcHBlciBjcmVhdGVzLiBAZGVmYXVsdCB0cnVlICovXG4gIHJlYWRvbmx5IGFsbG93QWxsT3V0Ym91bmQ/OiBib29sZWFuO1xuICAvKipcbiAgICogUzMgYnVja2V0IHRvIHNlbmQgVlBDIGZsb3cgbG9ncyB0by4gdjIgYWx3YXlzIHVzZWQgdGhlIFJFUyBzdGFnZSdzIGNvbXBsaWFuY2UtbG9nIGJ1Y2tldFxuICAgKiBpbXBsaWNpdGx5OyB2MyBoYXMgbm90IG1pZ3JhdGVkIHRoYXQgYnVja2V0IHlldCAoYG05LW1pZ3JhdGUtY29tcGxpYW5jZS1idWNrZXRgKSwgc28gdGhpcyBpcyBhblxuICAgKiBleHBsaWNpdCBwcm9wIGluc3RlYWQgLS0gb21pdCB0byBza2lwIGZsb3cgbG9ncy5cbiAgICovXG4gIHJlYWRvbmx5IGZsb3dMb2dzQnVja2V0TmFtZT86IHN0cmluZztcbiAgLyoqXG4gICAqIEV4dHJhIENvZGVCdWlsZCBWUEMgaW50ZXJmYWNlIGVuZHBvaW50cyBiZXlvbmQgdGhlIGRlZmF1bHQgc2V0IChTU00sIFNUUywgQ2xvdWRXYXRjaCBMb2dzLFxuICAgKiBDbG91ZEZvcm1hdGlvbiwgU2VjcmV0cyBNYW5hZ2VyLCBLTVMpLiBPbmx5IHVzZWQgZm9yIHRoZSBpc29sYXRlZC1zdWJuZXQgY2FzZSAoc2VlIGBzdWJuZXRUeXBlYCkuXG4gICAqL1xuICByZWFkb25seSBjb2RlQnVpbGRWcGNJbnRlcmZhY2VzPzogZWMyLkludGVyZmFjZVZwY0VuZHBvaW50QXdzU2VydmljZVtdO1xufVxuXG4vKipcbiAqIFZQQyBjb25maWd1cmF0aW9uIGZvciB0aGUgcGlwZWxpbmUncyBvd24gQ29kZUJ1aWxkIHByb2plY3RzICh2MiBgSVZwY0NvbmZpZ2AsIG1pZ3JhdGVkIGZyb21cbiAqIGBWUENQcm92aWRlcmApLiBTZXQgYG1hbmFnZWRWcGNgIHRvIGhhdmUgdGhlIHdyYXBwZXIgY3JlYXRlIGEgVlBDLCBvciBgdnBjSWRgIHRvIGxvb2sgdXAgYW5cbiAqIGV4aXN0aW5nIG9uZTsgc2V0dGluZyBuZWl0aGVyIC0tIHRoZSBkZWZhdWx0IC0tIHJ1bnMgZXZlcnkgQ29kZUJ1aWxkIHByb2plY3Qgd2l0aG91dCBhIFZQQy5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBWcGNDb25maWcge1xuICAvKiogQ3JlYXRlIGEgbmV3IFZQQyB3aXRoIHRoZXNlIHNldHRpbmdzLiAqL1xuICByZWFkb25seSBtYW5hZ2VkVnBjPzogTWFuYWdlZFZwY0NvbmZpZztcbiAgLyoqXG4gICAqIExvb2sgdXAgYW4gZXhpc3RpbmcgVlBDIGJ5IGlkLiBBIHZhbHVlIHN0YXJ0aW5nIHdpdGggYHJlc29sdmU6c3NtOmAgaXMgcmVzb2x2ZWQgZnJvbSB0aGUgbmFtZWRcbiAgICogU1NNIHBhcmFtZXRlciBhdCBzeW50aCB0aW1lIGluc3RlYWQgb2YgYmVpbmcgdXNlZCBsaXRlcmFsbHkgKHYyIGBWUENGcm9tTG9va1VwU3RhY2tgIHBhcml0eSkuXG4gICAqL1xuICByZWFkb25seSB2cGNJZD86IHN0cmluZztcbn1cblxuLyoqIEEgcmVzb2x2ZWQgc3RhZ2UncyB0YXJnZXQgZW52aXJvbm1lbnQuIGByZWdpb25zYCBpcyBhbHdheXMgYSBsaXN0LCBldmVuIGZvciBhIHNpbmdsZSByZWdpb24uICovXG5leHBvcnQgaW50ZXJmYWNlIFN0YWdlRW52aXJvbm1lbnQge1xuICAvKiogVGFyZ2V0IGFjY291bnQuIE9taXR0ZWQgbWVhbnMgZW52aXJvbm1lbnQtYWdub3N0aWMgKHJlc29sdmVkIGZyb20gYW1iaWVudCBjcmVkcyBhdCBkZXBsb3kpLiAqL1xuICByZWFkb25seSBhY2NvdW50Pzogc3RyaW5nO1xuICAvKiogVGFyZ2V0IHJlZ2lvbnMsIGluIG9yZGVyLiBOZXZlciBlbXB0eSBmb3IgYW4gZW52aXJvbm1lbnQtc3BlY2lmaWMgc3RhZ2UuICovXG4gIHJlYWRvbmx5IHJlZ2lvbnM6IHN0cmluZ1tdO1xuICAvKiogSG93IHRoZSByZWdpb25zIHJvbGwgb3V0LiAqL1xuICByZWFkb25seSByZWdpb25PcmRlcjogUmVnaW9uT3JkZXI7XG59XG5cbi8qKiBGb3JjZWQgZGVwbG95ZXIgLyBDbG91ZEZvcm1hdGlvbi1leGVjdXRpb24gcm9sZXMgZm9yIGEgc3RhZ2UuICovXG5leHBvcnQgaW50ZXJmYWNlIERlcGxveW1lbnRDb25maWcge1xuICAvKiogQVJOIHRoZSBDTEkgYXNzdW1lcyB0byBkZXBsb3kgKHBhc3NlZCBhcyBgY2RrIGRlcGxveSAtLXJvbGUtYXJuYCkuICovXG4gIHJlYWRvbmx5IGRlcGxveVJvbGU/OiBzdHJpbmc7XG4gIC8qKiBBUk4gQ2xvdWRGb3JtYXRpb24gYXNzdW1lcyB0byBleGVjdXRlIHRoZSBjaGFuZ2Ugc2V0LiAqL1xuICByZWFkb25seSBjZm5FeGVjdXRpb25Sb2xlPzogc3RyaW5nO1xufVxuXG4vKiogQSBmdWxseSByZXNvbHZlZCBkZXBsb3ltZW50IHN0YWdlLiAqL1xuZXhwb3J0IGludGVyZmFjZSBSZXNvbHZlZFN0YWdlIHtcbiAgLyoqIFN0YWdlIG5hbWUsIGUuZy4gYGRldmAsIGBwcm9kYC4gKi9cbiAgcmVhZG9ubHkgbmFtZTogc3RyaW5nO1xuICAvKiogV2hlcmUgdGhpcyBzdGFnZSBkZXBsb3lzLiAqL1xuICByZWFkb25seSBlbnY6IFN0YWdlRW52aXJvbm1lbnQ7XG4gIC8qKiBXaGV0aGVyIGEgbWFudWFsIGFwcHJvdmFsIGdhdGVzIHRoaXMgc3RhZ2UuICovXG4gIHJlYWRvbmx5IG1hbnVhbEFwcHJvdmFsOiBib29sZWFuO1xuICAvKiogRm9yY2VkIHJvbGVzIGZvciB0aGlzIHN0YWdlLCBpZiBhbnkuICovXG4gIHJlYWRvbmx5IGRlcGxveW1lbnQ/OiBEZXBsb3ltZW50Q29uZmlnO1xufVxuXG4vKiogVGhlIHJlc29sdmVkIHN5bnRoZXNpemVyIGNob2ljZS4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgU3ludGhlc2l6ZXJDb25maWcge1xuICAvKiogVGhlIHN5bnRoZXNpemVyIHRvIGluc3RhbGwuICovXG4gIHJlYWRvbmx5IHR5cGU6IFN5bnRoZXNpemVyVHlwZTtcbn1cblxuLyoqIFRoZSBmdWxseSByZXNvbHZlZCBwaXBlbGluZSBjb25maWd1cmF0aW9uIGBkZWZpbmVDSUNEYCBwcm9kdWNlcy4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmVzb2x2ZWRDaWNkQ29uZmlnIHtcbiAgLyoqIEFwcGxpY2F0aW9uIG5hbWU7IGRyaXZlcyB0aGUgYm9vdHN0cmFwIHF1YWxpZmllciBhbmQgYXNzZXQgbmFtaW5nLiAqL1xuICByZWFkb25seSBhcHBsaWNhdGlvbj86IHN0cmluZztcbiAgLyoqIEJvb3RzdHJhcCBxdWFsaWZpZXIgKOKJpDEwIGNoYXJzKSwgZGVyaXZlZCBmcm9tIGBhcHBsaWNhdGlvbmAgd2hlbiBub3QgZ2l2ZW4uICovXG4gIHJlYWRvbmx5IHF1YWxpZmllcj86IHN0cmluZztcbiAgLyoqIFRoZSBzb3VyY2UgcmVwb3NpdG9yeS4gKi9cbiAgcmVhZG9ubHkgcmVwb3NpdG9yeTogUmVwb3NpdG9yeTtcbiAgLyoqIFRoZSBkZXBsb3ltZW50IHN0YWdlcywgaW4gb3JkZXIuICovXG4gIHJlYWRvbmx5IHN0YWdlczogUmVzb2x2ZWRTdGFnZVtdO1xuICAvKiogVGhlIHN5bnRoZXNpemVyIGNvbmZpZ3VyYXRpb24uICovXG4gIHJlYWRvbmx5IHN5bnRoZXNpemVyOiBTeW50aGVzaXplckNvbmZpZztcbiAgLyoqIFdoaWNoIGVuZ2luZSByZW5kZXJzIHRoZSBwaXBlbGluZS4gRGVmYXVsdHMgdG8gQ29kZVBpcGVsaW5lLiAqL1xuICByZWFkb25seSBlbmdpbmU6IEVuZ2luZVR5cGU7XG4gIC8qKiBHaXRIdWIgQWN0aW9ucyBlbmdpbmUgY29uZmlndXJhdGlvbi4gT25seSByZWFkIHdoZW4gYGVuZ2luZWAgaXMgYEVuZ2luZVR5cGUuR0lUSFVCX0FDVElPTlNgLiAqL1xuICByZWFkb25seSBnaXRodWJBY3Rpb25zPzogR2l0SHViQWN0aW9uc0NvbmZpZztcbiAgLyoqIFJlc29sdmVkIENJIGNvbmZpZ3VyYXRpb24uICovXG4gIHJlYWRvbmx5IGNpOiBDaUNvbmZpZztcbiAgLyoqIFByaXZhdGUgQ29kZUFydGlmYWN0IG5wbSByZXBvc2l0b3J5IHRoZSBidWlsZHMgYXV0aGVudGljYXRlIGFnYWluc3QsIGlmIGFueS4gKi9cbiAgcmVhZG9ubHkgY29kZUFydGlmYWN0PzogQ29kZUFydGlmYWN0Q29uZmlnO1xuICAvKiogR2VuZXJpYyBwcml2YXRlIG5wbSByZWdpc3RyeSB0aGUgYnVpbGRzIGF1dGhlbnRpY2F0ZSBhZ2FpbnN0IHdpdGggYSBiZWFyZXIgdG9rZW4sIGlmIGFueS4gKi9cbiAgcmVhZG9ubHkgbnBtUmVnaXN0cnk/OiBOcG1SZWdpc3RyeUNvbmZpZztcbiAgLyoqIEhUVFAoUykgcHJveHkgZXZlcnkgYnVpbGQgcHJvamVjdCByb3V0ZXMgdGhyb3VnaCwgaWYgYW55LiAqL1xuICByZWFkb25seSBwcm94eT86IFByb3h5Q29uZmlnO1xuICAvKiogVlBDIGV2ZXJ5IENvZGVCdWlsZCBwcm9qZWN0IHRoZSBwaXBlbGluZSBjcmVhdGVzIHJ1bnMgaW4sIGlmIGNvbmZpZ3VyZWQgKHYyIGBWUENQcm92aWRlcmAsIG1pZ3JhdGVkKS4gKi9cbiAgcmVhZG9ubHkgdnBjPzogVnBjQ29uZmlnO1xuICAvKipcbiAgICogVGhlIG5hbWUgb2YgdGhlIGNvbXBsaWFuY2UvYWNjZXNzLWxvZyBkZXN0aW5hdGlvbiBidWNrZXQsIGlmIGNvbmZpZ3VyZWQgKHYyXG4gICAqIGBDb21wbGlhbmNlQnVja2V0UHJvdmlkZXJgL2BDb21wbGlhbmNlTG9nQnVja2V0U3RhY2tgLCBtaWdyYXRlZCkuIFRocmVhZGVkIGludG9cbiAgICogYFN1cHBvcnRSZXNvdXJjZXMuY29tcGxpYW5jZUxvZ0J1Y2tldGA7IHNlZSB0aGVyZSBmb3IgdGhlIGJ1Y2tldCdzIHNoYXBlLlxuICAgKi9cbiAgcmVhZG9ubHkgY29tcGxpYW5jZUxvZ0J1Y2tldE5hbWU/OiBzdHJpbmc7XG4gIC8qKlxuICAgKiBDb2RlQnVpbGQgZW52aXJvbm1lbnQgb3ZlcnJpZGVzIC0tIHByaXZpbGVnZWQgbW9kZSwgY29tcHV0ZSB0eXBlLCBlbnZpcm9ubWVudCB2YXJpYWJsZXMgLS0gYXBwbGllZFxuICAgKiB0byBldmVyeSBDb2RlQnVpbGQgcHJvamVjdCB0aGUgcGlwZWxpbmUgY3JlYXRlcyAodjIgYGNvZGVCdWlsZEVudlNldHRpbmdzYCwgbWlncmF0ZWQgZnJvbVxuICAgKiBgQ29kZUJ1aWxkRmFjdG9yeVByb3ZpZGVyYC9gUGlwZWxpbmVCbHVlcHJpbnQuY29kZUJ1aWxkRW52U2V0dGluZ3MoLi4uKWApLiBSZXVzZXMgQ0RLJ3Mgb3duXG4gICAqIGBCdWlsZEVudmlyb25tZW50YCByYXRoZXIgdGhhbiBhIGJlc3Bva2UgdHlwZSwgc28gaXQgc3RheXMgYSBkcm9wLWluIGZvciB2MiBjYWxsZXJzLiBgYnVpbGRJbWFnZWBcbiAgICogaGVyZSBpcyBhIGZ1bGwgYElCdWlsZEltYWdlYCAoZS5nLiBhbiBBUk0gb3IgR1BVIG1hbmFnZWQgaW1hZ2UpOyBpdCBpcyBkaXN0aW5jdCBmcm9tIHRoZSBlbmdpbmVzJ1xuICAgKiBvd24gYGJ1aWxkSW1hZ2VgIGNvbnN0cnVjdG9yIHByb3AsIHdoaWNoIHRha2VzIGEgRG9ja2VyLXJlZ2lzdHJ5IGltYWdlIHN0cmluZyAtLSB0aGF0IHByb3Agd2luc1xuICAgKiB3aGVuIGJvdGggYXJlIHNldC5cbiAgICovXG4gIHJlYWRvbmx5IGNvZGVCdWlsZEVudlNldHRpbmdzPzogY29kZWJ1aWxkLkJ1aWxkRW52aXJvbm1lbnQ7XG4gIC8qKiBIb3cgdGhlIGRlcGxveWVkIGNsb3VkIGFzc2VtYmx5IGlzIHByb2R1Y2VkLiBEZWZhdWx0cyB0byBgQVNTRU1CTFlfUFJPTU9USU9OYC4gKi9cbiAgcmVhZG9ubHkgZGVwbG95TW9kZWw6IERlcGxveU1vZGVsO1xuICAvKipcbiAgICogQ29udGFpbmVyIG1vZGUgKFJlcG8gMSk6IHdoZW4gc2V0LCB0aGUgcGlwZWxpbmUgcnVucyBDSSB0aGVuIGJ1aWxkcyAmIHB1c2hlcyBhIGNvbmZpZy1hZ25vc3RpY1xuICAgKiBkZXBsb3llciBpbWFnZSB0byBFQ1IgaW5zdGVhZCBvZiBkZXBsb3lpbmcgc3RhZ2VzLiBVbmRlZmluZWQgPSB0aGUgbm9ybWFsIGRlcGxveSBwaXBlbGluZS4gKE5hbWVkXG4gICAqIGBkZXBsb3llckltYWdlYCwgbm90IGBidWlsZGAgLS0ganNpaSByZXNlcnZlcyBgYnVpbGRgIGFzIGEgc3RydWN0IG1lbWJlciBuYW1lLilcbiAgICovXG4gIHJlYWRvbmx5IGRlcGxveWVySW1hZ2U/OiBCdWlsZEltYWdlO1xuICAvKipcbiAgICogSGFuZCB0aGUgQ2xvdWRGb3JtYXRpb24gd2FpdCB0byBhIExhbWJkYSBpbnN0ZWFkIG9mIGhvbGRpbmcgQ29kZUJ1aWxkIGNvbXB1dGUgZm9yIGl0IChELWRlcGxveS13YWl0KS5cbiAgICpcbiAgICogT2ZmIGJ5IGRlZmF1bHQ6IHRoZSBidWlsZC1jb21wdXRlIHBhdGggaXMgd2hhdCBgbTQtdmVyaWZ5YCBwcm92ZXMgZW5kIHRvIGVuZCwgYW5kIHRoaXMgb25lIHJlcGxhY2VzXG4gICAqIGhvdyBkZXBsb3ltZW50IGFjdHVhbGx5IGV4ZWN1dGVzIC0tIGNoYW5nZSBzZXRzIHByZXBhcmVkIGJ5IHRoZSBidWlsZCwgdGhlbiBleGVjdXRlZCBhbmQgcG9sbGVkIGJ5IGFcbiAgICogTGFtYmRhIC0tIHNvIGl0IGlzIG9wdC1pbiB1bnRpbCBhIHJlYWwgcnVuIHZhbGlkYXRlcyBpdC4gV2hlbiBvbiwgYSBkZXBsb3kgc3RhZ2Ugc3RvcHMgYmlsbGluZyBidWlsZFxuICAgKiBtaW51dGVzIGZvciB0aGUgKHVzdWFsbHkgZG9taW5hbnQpIHN0cmV0Y2ggd2hlcmUgQ2xvdWRGb3JtYXRpb24gaXMgd29ya2luZy5cbiAgICovXG4gIHJlYWRvbmx5IGFzeW5jRGVwbG95OiBib29sZWFuO1xuICAvKipcbiAgICogRGVwbG95IHdpdGggKipDbG91ZEZvcm1hdGlvbiBleHByZXNzIG1vZGUqKiAoYGNkayBkZXBsb3kgLS1leHByZXNzYCkuIENsb3VkRm9ybWF0aW9uIHJlcG9ydHMgZWFjaFxuICAgKiBzdGFjayBvcGVyYXRpb24gY29tcGxldGUgYXMgc29vbiBhcyBpdCBhcHBsaWVzIHRoZSByZXNvdXJjZSBjb25maWd1cmF0aW9uLCAqd2l0aG91dCogd2FpdGluZyBmb3JcbiAgICogcmVzb3VyY2VzIHRvIHN0YWJpbGl6ZSAtLSBtYXRlcmlhbGx5IGZhc3RlciBmb3Igc3RhY2tzIHdob3NlIHJlc291cmNlcyBhcmUgc2xvdyB0byBzdGFiaWxpemUuXG4gICAqIEV4cHJlc3MgcnVucyB3aXRoICoqcm9sbGJhY2sgZGlzYWJsZWQqKiAoYSBmYWlsZWQgZGVwbG95IGlzIGxlZnQgaW4gYSBmYWlsZWQgc3RhdGUgZm9yIGluc3BlY3Rpb24pO1xuICAgKiBmb3JjaW5nIGAtLXJvbGxiYWNrYCBjb25mbGljdHMgd2l0aCB0aGUgY2hhbmdlLXNldCBwYXRoIGZvciBuZXN0ZWQgc3RhY2tzLCBzbyB0aGUgQ0xJIGRvZXMgbm90IGFkZFxuICAgKiBpdC4gQVdTIGRvZXMgKipub3QqKiByZWNvbW1lbmQgZXhwcmVzcyBtb2RlIGZvciBwcm9kdWN0aW9uIC0tIGl0IHRhcmdldHMgZmFzdCBpdGVyYXRpdmVcbiAgICogZGVwbG95bWVudHMuIE9mZiBieSBkZWZhdWx0LlxuICAgKi9cbiAgcmVhZG9ubHkgZXhwcmVzcz86IGJvb2xlYW47XG59XG5cbi8qKlxuICogQSByZXNvbHZlZCBkZXBsb3ltZW50IHRhcmdldCBmb3IgY29udGFpbmVyIG1vZGUgKFJlcG8gMik6IGEgc3RhZ2UgdG8gZGVwbG95IHRoZSBwaW5uZWQgaW1hZ2UgYWdhaW5zdCxcbiAqIHdpdGggaXRzIG93biBlbnZpcm9ubWVudCBhbmQgb3B0aW9uYWwgZm9yY2VkIHJvbGVzLiBgZW52YCBtaXJyb3JzIGEgYFJlc29sdmVkU3RhZ2VgJ3MgZW52aXJvbm1lbnQsIGJ1dCBhXG4gKiB0YXJnZXQgbmFtZXMgdGhlIHN0YWdlIGl0IG1hcHMgdG8gcmF0aGVyIHRoYW4gZGVmaW5pbmcgaXQgLS0gdGhlIHN0YWdlJ3Mgc3RhY2tzIGxpdmUgaW4gdGhlIGltYWdlLCBub3RcbiAqIGhlcmUuIGBtYW51YWxBcHByb3ZhbGAgZGVmYXVsdHMgdGhlIHNhbWUgd2F5IHN0YWdlcyBkbyAoZ2F0ZWQgdW5sZXNzIGBkZXZgL2ByZXNgKS5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBSZXNvbHZlZERlcGxveW1lbnRUYXJnZXQge1xuICAvKiogVGhlIHN0YWdlIGluIHRoZSBpbWFnZSdzIGFwcCB0byBkZXBsb3kgKHBhc3NlZCB0byB0aGUgaW4tY29udGFpbmVyIGBjZGstY2ljZCBkZXBsb3kgLS1zdGFnZWApLiAqL1xuICByZWFkb25seSBzdGFnZTogc3RyaW5nO1xuICAvKiogV2hlcmUgdGhpcyB0YXJnZXQgZGVwbG95cy4gKi9cbiAgcmVhZG9ubHkgZW52OiBTdGFnZUVudmlyb25tZW50O1xuICAvKiogV2hldGhlciBhIG1hbnVhbCBhcHByb3ZhbCBnYXRlcyB0aGlzIHRhcmdldC4gKi9cbiAgcmVhZG9ubHkgbWFudWFsQXBwcm92YWw6IGJvb2xlYW47XG4gIC8qKiBGb3JjZWQgcm9sZXMgZm9yIHRoaXMgdGFyZ2V0LCBpZiBhbnkuICovXG4gIHJlYWRvbmx5IGRlcGxveW1lbnQ/OiBEZXBsb3ltZW50Q29uZmlnO1xuICAvKipcbiAgICogVGhlIGRlcGxveWVyIGltYWdlICh0YWcvZGlnZXN0KSB0byBydW4gZm9yIFRISVMgdGFyZ2V0LCBvdmVycmlkaW5nIHRoZSBjb25maWctbGV2ZWwgYGltYWdlYC4gVGhpcyBpc1xuICAgKiBob3cgYSBzdGFnZSBwaW5zIGl0cyBvd24gYXBwbGljYXRpb24gdmVyc2lvbiAtLSBidW1wIGBkZXZgJ3MgdGFnIHRvIHNoaXAgYSBuZXcgdmVyc2lvbiB0byBkZXYgYWxvbmUsXG4gICAqIG9yIHNldCBgaW50YC9gcHJvZGAgdG8gdGhlIHNhbWUgdGFnIHRvIHByb21vdGUuIFdoZW4gdW5zZXQsIHRoZSB0YXJnZXQgdXNlcyB0aGUgY29uZmlnLWxldmVsIGBpbWFnZWAuXG4gICAqL1xuICByZWFkb25seSBpbWFnZT86IHN0cmluZztcbn1cblxuLyoqXG4gKiBUaGUgZnVsbHkgcmVzb2x2ZWQgY29udGFpbmVyLW1vZGUgZGVwbG95bWVudCBjb25maWd1cmF0aW9uIGBkZWZpbmVEZXBsb3ltZW50YCBwcm9kdWNlcyAoUmVwbyAyIG9mIHRoZVxuICogdHdvLXJlcG8gc3BsaXQpLiBJdCBwaW5zIG9uZSBjb25maWctYWdub3N0aWMgZGVwbG95ZXIgaW1hZ2UgYW5kIGxpc3RzIHRoZSB0YXJnZXRzIHRvIHJ1biBpdCBhZ2FpbnN0O1xuICogYGNkay1jaWNkIGRlcGxveSAtLWZyb20taW1hZ2VgIHJ1bnMgdGhlIGltYWdlIHBlciB0YXJnZXQsIHN5bnRoZXNpemluZyBhbmQgZGVwbG95aW5nIGluLWNvbnRhaW5lci5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBSZXNvbHZlZERlcGxveW1lbnRDb25maWcge1xuICAvKipcbiAgICogVGhlIGRlZmF1bHQgZGVwbG95ZXIgaW1hZ2UgdG8gcnVuIHRhcmdldHMgYWdhaW5zdCAoYW4gRUNSL09DSSByZWZlcmVuY2UsIHRhZyBvciBkaWdlc3QpLiBBIHRhcmdldCdzXG4gICAqIG93biBgaW1hZ2VgIG92ZXJyaWRlcyB0aGlzLCBzbyBwZXItc3RhZ2UgdmVyc2lvbnMgbGl2ZSBvbiB0aGUgdGFyZ2V0czsgdGhpcyBpcyB0aGUgc2hhcmVkIGZhbGxiYWNrLlxuICAgKiBPcHRpb25hbCBvbmx5IGJlY2F1c2UgZXZlcnkgdGFyZ2V0IG1heSBwaW4gaXRzIG93biBgaW1hZ2VgIC0tIGVhY2ggdGFyZ2V0IG11c3QgcmVzb2x2ZSB0byBvbmUgb3IgdGhlIG90aGVyLlxuICAgKi9cbiAgcmVhZG9ubHkgaW1hZ2U/OiBzdHJpbmc7XG4gIC8qKiBUaGUgZGVwbG95bWVudCB0YXJnZXRzLCBpbiBvcmRlci4gKi9cbiAgcmVhZG9ubHkgdGFyZ2V0czogUmVzb2x2ZWREZXBsb3ltZW50VGFyZ2V0W107XG4gIC8qKlxuICAgKiBUaGUgY29uZmlnLW9ubHkgc291cmNlIHJlcG9zaXRvcnkgdGhlIENEIHBpcGVsaW5lIHdhdGNoZXMgKHdoZXJlIGBkZXBsb3kuY29uZmlnLnRzYCBsaXZlcyAtLSBubyBDREtcbiAgICogY29kZSkuIE9wdGlvbmFsOiB3aGVuIG9taXR0ZWQsIHRoZSBjb25maWcgZHJpdmVzIG9ubHkgdGhlIGxvY2FsIGBjZGstY2ljZCBkZXBsb3kgLS1mcm9tLWltYWdlYFxuICAgKiBleGVjdXRvcjsgc2V0IGl0IHRvIHByb3Zpc2lvbiBhIENEIENvZGVQaXBlbGluZSAoYGNkay1jaWNkIGRlcGxveS1jaWApIHdob3NlIENvZGVCdWlsZCBwdWxscyB0aGUgaW1hZ2VcbiAgICogYW5kIGRlcGxveXMgZWFjaCB0YXJnZXQuIFRoaXMgaXMgdGhlIGRlcGxveS1zaWRlIHR3aW4gb2YgYFJlc29sdmVkQ2ljZENvbmZpZy5yZXBvc2l0b3J5YC5cbiAgICovXG4gIHJlYWRvbmx5IHJlcG9zaXRvcnk/OiBSZXBvc2l0b3J5O1xuICAvKipcbiAgICogUHJpdmF0ZSBDb2RlQXJ0aWZhY3QgcmVwbyB0aGUgQ0QgYnVpbGQgYXV0aGVudGljYXRlcyBhZ2FpbnN0IGJlZm9yZSBgbnBtIGNpYCAodG8gaW5zdGFsbCB0aGUgd3JhcHBlclxuICAgKiBDTEkgd2hlbiBpdCBpcyBwcmUtcmVsZWFzZSAvIG5vdCBvbiBwdWJsaWMgbnBtKS4gU2FtZSBzaGFwZSBhcyB0aGUgcGlwZWxpbmUtY29uZmlnIGBjb2RlQXJ0aWZhY3RgLlxuICAgKi9cbiAgcmVhZG9ubHkgY29kZUFydGlmYWN0PzogQ29kZUFydGlmYWN0Q29uZmlnO1xuICAvKipcbiAgICogR2VuZXJpYyBwcml2YXRlIG5wbSByZWdpc3RyeSB0aGUgQ0QgYnVpbGQgYXV0aGVudGljYXRlcyBhZ2FpbnN0IGJlZm9yZSBgbnBtIGNpYC4gU2FtZSBzaGFwZSBhcyB0aGVcbiAgICogcGlwZWxpbmUtY29uZmlnIGBucG1SZWdpc3RyeWAuXG4gICAqL1xuICByZWFkb25seSBucG1SZWdpc3RyeT86IE5wbVJlZ2lzdHJ5Q29uZmlnO1xufVxuIl19
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { Environment, Stage } from 'aws-cdk-lib';
|
|
2
|
+
import * as pipelines from 'aws-cdk-lib/pipelines';
|
|
3
|
+
import { Construct } from 'constructs';
|
|
4
|
+
import { ResolvedCicdConfig } from '../../config/types';
|
|
5
|
+
/** Context passed to the stage factory for one deployment stage. */
|
|
6
|
+
export interface CdkPipelinesStageContext {
|
|
7
|
+
/** The stage name from the config (e.g. `DEVFRA`). */
|
|
8
|
+
readonly stageName: string;
|
|
9
|
+
/** The stage's target environment (account + primary region). */
|
|
10
|
+
readonly env: Environment;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Builds the application's stacks for one deployment stage into the given `cdk.Stage`. This is the v2
|
|
14
|
+
* `IStackProvider` equivalent: CDK Pipelines deploys whatever stacks the provider adds to the stage. A
|
|
15
|
+
* behavioural interface (not a bare function) so it crosses the jsii boundary like v2's providers did.
|
|
16
|
+
*/
|
|
17
|
+
export interface IStageProvider {
|
|
18
|
+
/** Add the app's stacks for `context.stageName` into `stage`. */
|
|
19
|
+
stacks(stage: Stage, context: CdkPipelinesStageContext): void;
|
|
20
|
+
}
|
|
21
|
+
/** Props for the CDK Pipelines (v2-compatible) engine. */
|
|
22
|
+
export interface CdkPipelinesEngineProps {
|
|
23
|
+
/** The resolved pipeline configuration (`defineCICD`). */
|
|
24
|
+
readonly config: ResolvedCicdConfig;
|
|
25
|
+
/** Builds the app's stacks per stage (the v2-compat opt-in — CDK Pipelines needs the stacks in-synth). */
|
|
26
|
+
readonly stages: IStageProvider;
|
|
27
|
+
/** Pipeline name; defaults to `<application>-pipeline`. */
|
|
28
|
+
readonly pipelineName?: string;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* A CDK Pipelines pipeline rendered from a v3 config + a stage factory. Reproduces the v2 shape:
|
|
32
|
+
* Source -> Synth (self-mutating) -> Assets -> one wave per stage (with a pre-approval when the stage is
|
|
33
|
+
* gated). Cross-account keys are on (v2 default) so multi-account stages work.
|
|
34
|
+
*/
|
|
35
|
+
export declare class CdkPipelinesEngine extends Construct {
|
|
36
|
+
readonly pipeline: pipelines.CodePipeline;
|
|
37
|
+
constructor(scope: Construct, id: string, props: CdkPipelinesEngineProps);
|
|
38
|
+
/**
|
|
39
|
+
* Suppress the cdk-nag findings on the infrastructure **CDK Pipelines generates for itself** -- the
|
|
40
|
+
* pipeline/synth/self-mutation/assets roles' unavoidable wildcards and the internal artifact and
|
|
41
|
+
* cross-region replication buckets. This engine runs `AwsSolutionsChecks` (as v2's blueprint did) so the
|
|
42
|
+
* user's app stacks are still judged on their own merits; only the wrapper-owned pipeline plumbing is
|
|
43
|
+
* exempted here, with evidence, mirroring v2's `CDKPipeline` suppressions.
|
|
44
|
+
*/
|
|
45
|
+
private suppressGeneratedPipelineNag;
|
|
46
|
+
}
|