deployable-awscdk-app-ts 0.1.683 → 0.1.684

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/API.md CHANGED
@@ -4589,6 +4589,114 @@ Whether to generate nvmrc file for the node version of the project if set to tru
4589
4589
 
4590
4590
  ---
4591
4591
 
4592
+ ### DeployableAwsCdkTypeScriptAppStepsFactoryProps <a name="DeployableAwsCdkTypeScriptAppStepsFactoryProps" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps"></a>
4593
+
4594
+ #### Initializer <a name="Initializer" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.Initializer"></a>
4595
+
4596
+ ```typescript
4597
+ import { DeployableAwsCdkTypeScriptAppStepsFactoryProps } from 'deployable-awscdk-app-ts'
4598
+
4599
+ const deployableAwsCdkTypeScriptAppStepsFactoryProps: DeployableAwsCdkTypeScriptAppStepsFactoryProps = { ... }
4600
+ ```
4601
+
4602
+ #### Properties <a name="Properties" id="Properties"></a>
4603
+
4604
+ | **Name** | **Type** | **Description** |
4605
+ | --- | --- | --- |
4606
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.checkActiveDeployment">checkActiveDeployment</a></code> | <code>boolean</code> | Whether to check for active deployments before proceeding with deployment. |
4607
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.deployOptions">deployOptions</a></code> | <code><a href="#deployable-awscdk-app-ts.DeployOptions">DeployOptions</a></code> | Deployment options. |
4608
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.jobStrategy">jobStrategy</a></code> | <code><a href="#deployable-awscdk-app-ts.DeployJobStrategy">DeployJobStrategy</a></code> | Deployment job strategy, whether to use a matrix job or multiple jobs for each environment. |
4609
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.authProvider">authProvider</a></code> | <code>projen.javascript.CodeArtifactAuthProvider</code> | The authentication provider for CodeArtifact, if any. |
4610
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.environmentDependencies">environmentDependencies</a></code> | <code>{[ key: string ]: string[]}</code> | Environment deployment dependencies, if any. |
4611
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.npmConfigEnvironment">npmConfigEnvironment</a></code> | <code>string</code> | The npm config to set with the environment that is being deployed, if any Note: This is not supported for node versions above 18. |
4612
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.preInstallTaskName">preInstallTaskName</a></code> | <code>string</code> | The name of the task to run before installing dependencies, if any. |
4613
+
4614
+ ---
4615
+
4616
+ ##### `checkActiveDeployment`<sup>Required</sup> <a name="checkActiveDeployment" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.checkActiveDeployment"></a>
4617
+
4618
+ ```typescript
4619
+ public readonly checkActiveDeployment: boolean;
4620
+ ```
4621
+
4622
+ - *Type:* boolean
4623
+
4624
+ Whether to check for active deployments before proceeding with deployment.
4625
+
4626
+ ---
4627
+
4628
+ ##### `deployOptions`<sup>Required</sup> <a name="deployOptions" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.deployOptions"></a>
4629
+
4630
+ ```typescript
4631
+ public readonly deployOptions: DeployOptions;
4632
+ ```
4633
+
4634
+ - *Type:* <a href="#deployable-awscdk-app-ts.DeployOptions">DeployOptions</a>
4635
+
4636
+ Deployment options.
4637
+
4638
+ ---
4639
+
4640
+ ##### `jobStrategy`<sup>Required</sup> <a name="jobStrategy" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.jobStrategy"></a>
4641
+
4642
+ ```typescript
4643
+ public readonly jobStrategy: DeployJobStrategy;
4644
+ ```
4645
+
4646
+ - *Type:* <a href="#deployable-awscdk-app-ts.DeployJobStrategy">DeployJobStrategy</a>
4647
+
4648
+ Deployment job strategy, whether to use a matrix job or multiple jobs for each environment.
4649
+
4650
+ ---
4651
+
4652
+ ##### `authProvider`<sup>Optional</sup> <a name="authProvider" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.authProvider"></a>
4653
+
4654
+ ```typescript
4655
+ public readonly authProvider: CodeArtifactAuthProvider;
4656
+ ```
4657
+
4658
+ - *Type:* projen.javascript.CodeArtifactAuthProvider
4659
+
4660
+ The authentication provider for CodeArtifact, if any.
4661
+
4662
+ ---
4663
+
4664
+ ##### `environmentDependencies`<sup>Optional</sup> <a name="environmentDependencies" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.environmentDependencies"></a>
4665
+
4666
+ ```typescript
4667
+ public readonly environmentDependencies: {[ key: string ]: string[]};
4668
+ ```
4669
+
4670
+ - *Type:* {[ key: string ]: string[]}
4671
+
4672
+ Environment deployment dependencies, if any.
4673
+
4674
+ ---
4675
+
4676
+ ##### `npmConfigEnvironment`<sup>Optional</sup> <a name="npmConfigEnvironment" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.npmConfigEnvironment"></a>
4677
+
4678
+ ```typescript
4679
+ public readonly npmConfigEnvironment: string;
4680
+ ```
4681
+
4682
+ - *Type:* string
4683
+
4684
+ The npm config to set with the environment that is being deployed, if any Note: This is not supported for node versions above 18.
4685
+
4686
+ ---
4687
+
4688
+ ##### `preInstallTaskName`<sup>Optional</sup> <a name="preInstallTaskName" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps.property.preInstallTaskName"></a>
4689
+
4690
+ ```typescript
4691
+ public readonly preInstallTaskName: string;
4692
+ ```
4693
+
4694
+ - *Type:* string
4695
+
4696
+ The name of the task to run before installing dependencies, if any.
4697
+
4698
+ ---
4699
+
4592
4700
  ### DeployOptions <a name="DeployOptions" id="deployable-awscdk-app-ts.DeployOptions"></a>
4593
4701
 
4594
4702
  #### Initializer <a name="Initializer" id="deployable-awscdk-app-ts.DeployOptions.Initializer"></a>
@@ -4794,6 +4902,541 @@ The script/task to run before deployment of the environment in the workflow If n
4794
4902
  ```
4795
4903
 
4796
4904
 
4905
+ ## Classes <a name="Classes" id="Classes"></a>
4906
+
4907
+ ### DeployableAwsCdkTypeScriptAppStepsFactory <a name="DeployableAwsCdkTypeScriptAppStepsFactory" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory"></a>
4908
+
4909
+ Factory to create reusable steps for the deployment workflow.
4910
+
4911
+ #### Initializers <a name="Initializers" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.Initializer"></a>
4912
+
4913
+ ```typescript
4914
+ import { DeployableAwsCdkTypeScriptAppStepsFactory } from 'deployable-awscdk-app-ts'
4915
+
4916
+ new DeployableAwsCdkTypeScriptAppStepsFactory(project: NodeProject, props: DeployableAwsCdkTypeScriptAppStepsFactoryProps)
4917
+ ```
4918
+
4919
+ | **Name** | **Type** | **Description** |
4920
+ | --- | --- | --- |
4921
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.Initializer.parameter.project">project</a></code> | <code>projen.javascript.NodeProject</code> | The project. |
4922
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.Initializer.parameter.props">props</a></code> | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps">DeployableAwsCdkTypeScriptAppStepsFactoryProps</a></code> | The factory properties. |
4923
+
4924
+ ---
4925
+
4926
+ ##### `project`<sup>Required</sup> <a name="project" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.Initializer.parameter.project"></a>
4927
+
4928
+ - *Type:* projen.javascript.NodeProject
4929
+
4930
+ The project.
4931
+
4932
+ ---
4933
+
4934
+ ##### `props`<sup>Required</sup> <a name="props" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.Initializer.parameter.props"></a>
4935
+
4936
+ - *Type:* <a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactoryProps">DeployableAwsCdkTypeScriptAppStepsFactoryProps</a>
4937
+
4938
+ The factory properties.
4939
+
4940
+ ---
4941
+
4942
+ #### Methods <a name="Methods" id="Methods"></a>
4943
+
4944
+ | **Name** | **Description** |
4945
+ | --- | --- |
4946
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getAssumeAwsRoleStepForEnvironment">getAssumeAwsRoleStepForEnvironment</a></code> | Step to assume an AWS role for a specific environment. |
4947
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getCheckActiveDeploymentStepForEnvironment">getCheckActiveDeploymentStepForEnvironment</a></code> | Step to check if there is an active deployment for a specific environment. |
4948
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getDeploymentJobPrerequisiteJobIds">getDeploymentJobPrerequisiteJobIds</a></code> | Get the IDs of the jobs that must be completed before the specified environment's deployment job. |
4949
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getJobForEnvironment">getJobForEnvironment</a></code> | Get the job definition for a specific environment. |
4950
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getPostDeploymentStepForEnvironment">getPostDeploymentStepForEnvironment</a></code> | Get the post-deployment step for a specific environment. |
4951
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getPreDeploymentStepForEnvironment">getPreDeploymentStepForEnvironment</a></code> | Get the pre-deployment step for a specific environment. |
4952
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getRunScriptStep">getRunScriptStep</a></code> | Get the step to run a specific script. |
4953
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getSetupAwsCredentialsInEnvironmentForEnvironment">getSetupAwsCredentialsInEnvironmentForEnvironment</a></code> | Step to setup AWS credentials in the environment for a specific environment. |
4954
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getSetupAwsCredentialsStepsForEnvironment">getSetupAwsCredentialsStepsForEnvironment</a></code> | Get the steps to setup AWS credentials for a specific environment. |
4955
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getSetupNpmConfigForEnvironment">getSetupNpmConfigForEnvironment</a></code> | *No description.* |
4956
+
4957
+ ---
4958
+
4959
+ ##### `getAssumeAwsRoleStepForEnvironment` <a name="getAssumeAwsRoleStepForEnvironment" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getAssumeAwsRoleStepForEnvironment"></a>
4960
+
4961
+ ```typescript
4962
+ public getAssumeAwsRoleStepForEnvironment(assumeRoleFlag: string | boolean, accessKeyIdSecretName: string, secretAccessKeySecretName: string, region: string, roleToAssume: string, assumeRoleDurationSeconds?: string | number): JobStep
4963
+ ```
4964
+
4965
+ Step to assume an AWS role for a specific environment.
4966
+
4967
+ ###### `assumeRoleFlag`<sup>Required</sup> <a name="assumeRoleFlag" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getAssumeAwsRoleStepForEnvironment.parameter.assumeRoleFlag"></a>
4968
+
4969
+ - *Type:* string | boolean
4970
+
4971
+ Whether to assume a role, can be a boolean or a string for matrix strategy.
4972
+
4973
+ ---
4974
+
4975
+ ###### `accessKeyIdSecretName`<sup>Required</sup> <a name="accessKeyIdSecretName" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getAssumeAwsRoleStepForEnvironment.parameter.accessKeyIdSecretName"></a>
4976
+
4977
+ - *Type:* string
4978
+
4979
+ The GitHub secret name for the access key ID.
4980
+
4981
+ ---
4982
+
4983
+ ###### `secretAccessKeySecretName`<sup>Required</sup> <a name="secretAccessKeySecretName" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getAssumeAwsRoleStepForEnvironment.parameter.secretAccessKeySecretName"></a>
4984
+
4985
+ - *Type:* string
4986
+
4987
+ The GitHub secret name for the secret access key.
4988
+
4989
+ ---
4990
+
4991
+ ###### `region`<sup>Required</sup> <a name="region" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getAssumeAwsRoleStepForEnvironment.parameter.region"></a>
4992
+
4993
+ - *Type:* string
4994
+
4995
+ The region.
4996
+
4997
+ ---
4998
+
4999
+ ###### `roleToAssume`<sup>Required</sup> <a name="roleToAssume" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getAssumeAwsRoleStepForEnvironment.parameter.roleToAssume"></a>
5000
+
5001
+ - *Type:* string
5002
+
5003
+ The role to assume.
5004
+
5005
+ ---
5006
+
5007
+ ###### `assumeRoleDurationSeconds`<sup>Optional</sup> <a name="assumeRoleDurationSeconds" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getAssumeAwsRoleStepForEnvironment.parameter.assumeRoleDurationSeconds"></a>
5008
+
5009
+ - *Type:* string | number
5010
+
5011
+ The duration for assuming the role.
5012
+
5013
+ ---
5014
+
5015
+ ##### `getCheckActiveDeploymentStepForEnvironment` <a name="getCheckActiveDeploymentStepForEnvironment" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getCheckActiveDeploymentStepForEnvironment"></a>
5016
+
5017
+ ```typescript
5018
+ public getCheckActiveDeploymentStepForEnvironment(environment: string): JobStep
5019
+ ```
5020
+
5021
+ Step to check if there is an active deployment for a specific environment.
5022
+
5023
+ ###### `environment`<sup>Required</sup> <a name="environment" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getCheckActiveDeploymentStepForEnvironment.parameter.environment"></a>
5024
+
5025
+ - *Type:* string
5026
+
5027
+ The environment to check.
5028
+
5029
+ ---
5030
+
5031
+ ##### `getDeploymentJobPrerequisiteJobIds` <a name="getDeploymentJobPrerequisiteJobIds" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getDeploymentJobPrerequisiteJobIds"></a>
5032
+
5033
+ ```typescript
5034
+ public getDeploymentJobPrerequisiteJobIds(environmentName: string): string[]
5035
+ ```
5036
+
5037
+ Get the IDs of the jobs that must be completed before the specified environment's deployment job.
5038
+
5039
+ ###### `environmentName`<sup>Required</sup> <a name="environmentName" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getDeploymentJobPrerequisiteJobIds.parameter.environmentName"></a>
5040
+
5041
+ - *Type:* string
5042
+
5043
+ The name of the environment.
5044
+
5045
+ ---
5046
+
5047
+ ##### `getJobForEnvironment` <a name="getJobForEnvironment" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getJobForEnvironment"></a>
5048
+
5049
+ ```typescript
5050
+ public getJobForEnvironment(environmentOptions: EnvironmentOptions, environmentVariableName?: string): Job
5051
+ ```
5052
+
5053
+ Get the job definition for a specific environment.
5054
+
5055
+ ###### `environmentOptions`<sup>Required</sup> <a name="environmentOptions" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getJobForEnvironment.parameter.environmentOptions"></a>
5056
+
5057
+ - *Type:* <a href="#deployable-awscdk-app-ts.EnvironmentOptions">EnvironmentOptions</a>
5058
+
5059
+ The environment options.
5060
+
5061
+ ---
5062
+
5063
+ ###### `environmentVariableName`<sup>Optional</sup> <a name="environmentVariableName" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getJobForEnvironment.parameter.environmentVariableName"></a>
5064
+
5065
+ - *Type:* string
5066
+
5067
+ The name of the environment variable to set with the environment name, if any.
5068
+
5069
+ ---
5070
+
5071
+ ##### `getPostDeploymentStepForEnvironment` <a name="getPostDeploymentStepForEnvironment" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getPostDeploymentStepForEnvironment"></a>
5072
+
5073
+ ```typescript
5074
+ public getPostDeploymentStepForEnvironment(hasPostDeployTaskFlag: string | boolean, postDeploymentScript: string): JobStep
5075
+ ```
5076
+
5077
+ Get the post-deployment step for a specific environment.
5078
+
5079
+ ###### `hasPostDeployTaskFlag`<sup>Required</sup> <a name="hasPostDeployTaskFlag" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getPostDeploymentStepForEnvironment.parameter.hasPostDeployTaskFlag"></a>
5080
+
5081
+ - *Type:* string | boolean
5082
+
5083
+ Whether the post-deployment task should be run.
5084
+
5085
+ ---
5086
+
5087
+ ###### `postDeploymentScript`<sup>Required</sup> <a name="postDeploymentScript" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getPostDeploymentStepForEnvironment.parameter.postDeploymentScript"></a>
5088
+
5089
+ - *Type:* string
5090
+
5091
+ The script to run.
5092
+
5093
+ ---
5094
+
5095
+ ##### `getPreDeploymentStepForEnvironment` <a name="getPreDeploymentStepForEnvironment" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getPreDeploymentStepForEnvironment"></a>
5096
+
5097
+ ```typescript
5098
+ public getPreDeploymentStepForEnvironment(hasPreDeployTaskFlag: string | boolean, preDeploymentScript: string): JobStep
5099
+ ```
5100
+
5101
+ Get the pre-deployment step for a specific environment.
5102
+
5103
+ ###### `hasPreDeployTaskFlag`<sup>Required</sup> <a name="hasPreDeployTaskFlag" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getPreDeploymentStepForEnvironment.parameter.hasPreDeployTaskFlag"></a>
5104
+
5105
+ - *Type:* string | boolean
5106
+
5107
+ Whether the pre-deployment task should be run.
5108
+
5109
+ ---
5110
+
5111
+ ###### `preDeploymentScript`<sup>Required</sup> <a name="preDeploymentScript" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getPreDeploymentStepForEnvironment.parameter.preDeploymentScript"></a>
5112
+
5113
+ - *Type:* string
5114
+
5115
+ The script to run.
5116
+
5117
+ ---
5118
+
5119
+ ##### `getRunScriptStep` <a name="getRunScriptStep" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getRunScriptStep"></a>
5120
+
5121
+ ```typescript
5122
+ public getRunScriptStep(scriptName: string, stepName: string, hasScriptFlag: string | boolean): JobStep
5123
+ ```
5124
+
5125
+ Get the step to run a specific script.
5126
+
5127
+ ###### `scriptName`<sup>Required</sup> <a name="scriptName" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getRunScriptStep.parameter.scriptName"></a>
5128
+
5129
+ - *Type:* string
5130
+
5131
+ The name of the script to run.
5132
+
5133
+ ---
5134
+
5135
+ ###### `stepName`<sup>Required</sup> <a name="stepName" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getRunScriptStep.parameter.stepName"></a>
5136
+
5137
+ - *Type:* string
5138
+
5139
+ The name of the step in the workflow.
5140
+
5141
+ ---
5142
+
5143
+ ###### `hasScriptFlag`<sup>Required</sup> <a name="hasScriptFlag" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getRunScriptStep.parameter.hasScriptFlag"></a>
5144
+
5145
+ - *Type:* string | boolean
5146
+
5147
+ Whether the script should be run.
5148
+
5149
+ ---
5150
+
5151
+ ##### `getSetupAwsCredentialsInEnvironmentForEnvironment` <a name="getSetupAwsCredentialsInEnvironmentForEnvironment" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getSetupAwsCredentialsInEnvironmentForEnvironment"></a>
5152
+
5153
+ ```typescript
5154
+ public getSetupAwsCredentialsInEnvironmentForEnvironment(assumeRoleFlag: string | boolean, accessKeyIdSecretName: string, secretAccessKeySecretName: string, region: string): JobStep
5155
+ ```
5156
+
5157
+ Step to setup AWS credentials in the environment for a specific environment.
5158
+
5159
+ ###### `assumeRoleFlag`<sup>Required</sup> <a name="assumeRoleFlag" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getSetupAwsCredentialsInEnvironmentForEnvironment.parameter.assumeRoleFlag"></a>
5160
+
5161
+ - *Type:* string | boolean
5162
+
5163
+ Whether to assume a role, can be a boolean or a string for matrix strategy.
5164
+
5165
+ ---
5166
+
5167
+ ###### `accessKeyIdSecretName`<sup>Required</sup> <a name="accessKeyIdSecretName" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getSetupAwsCredentialsInEnvironmentForEnvironment.parameter.accessKeyIdSecretName"></a>
5168
+
5169
+ - *Type:* string
5170
+
5171
+ The GitHub secret name for the access key ID.
5172
+
5173
+ ---
5174
+
5175
+ ###### `secretAccessKeySecretName`<sup>Required</sup> <a name="secretAccessKeySecretName" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getSetupAwsCredentialsInEnvironmentForEnvironment.parameter.secretAccessKeySecretName"></a>
5176
+
5177
+ - *Type:* string
5178
+
5179
+ The GitHub secret name for the secret access key.
5180
+
5181
+ ---
5182
+
5183
+ ###### `region`<sup>Required</sup> <a name="region" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getSetupAwsCredentialsInEnvironmentForEnvironment.parameter.region"></a>
5184
+
5185
+ - *Type:* string
5186
+
5187
+ The region.
5188
+
5189
+ ---
5190
+
5191
+ ##### `getSetupAwsCredentialsStepsForEnvironment` <a name="getSetupAwsCredentialsStepsForEnvironment" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getSetupAwsCredentialsStepsForEnvironment"></a>
5192
+
5193
+ ```typescript
5194
+ public getSetupAwsCredentialsStepsForEnvironment(environmentOptions: EnvironmentOptions): JobStep[]
5195
+ ```
5196
+
5197
+ Get the steps to setup AWS credentials for a specific environment.
5198
+
5199
+ ###### `environmentOptions`<sup>Required</sup> <a name="environmentOptions" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getSetupAwsCredentialsStepsForEnvironment.parameter.environmentOptions"></a>
5200
+
5201
+ - *Type:* <a href="#deployable-awscdk-app-ts.EnvironmentOptions">EnvironmentOptions</a>
5202
+
5203
+ The environment options.
5204
+
5205
+ ---
5206
+
5207
+ ##### `getSetupNpmConfigForEnvironment` <a name="getSetupNpmConfigForEnvironment" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getSetupNpmConfigForEnvironment"></a>
5208
+
5209
+ ```typescript
5210
+ public getSetupNpmConfigForEnvironment(environment: string): JobStep
5211
+ ```
5212
+
5213
+ ###### `environment`<sup>Required</sup> <a name="environment" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.getSetupNpmConfigForEnvironment.parameter.environment"></a>
5214
+
5215
+ - *Type:* string
5216
+
5217
+ ---
5218
+
5219
+ #### Static Functions <a name="Static Functions" id="Static Functions"></a>
5220
+
5221
+ | **Name** | **Description** |
5222
+ | --- | --- |
5223
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.validateEnvironmentDeploymentDependencies">validateEnvironmentDeploymentDependencies</a></code> | Validate that the provided environment deployment dependencies are valid. |
5224
+
5225
+ ---
5226
+
5227
+ ##### `validateEnvironmentDeploymentDependencies` <a name="validateEnvironmentDeploymentDependencies" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.validateEnvironmentDeploymentDependencies"></a>
5228
+
5229
+ ```typescript
5230
+ import { DeployableAwsCdkTypeScriptAppStepsFactory } from 'deployable-awscdk-app-ts'
5231
+
5232
+ DeployableAwsCdkTypeScriptAppStepsFactory.validateEnvironmentDeploymentDependencies(deployOptions: DeployOptions, environmentDependencies: {[ key: string ]: string[]})
5233
+ ```
5234
+
5235
+ Validate that the provided environment deployment dependencies are valid.
5236
+
5237
+ ###### `deployOptions`<sup>Required</sup> <a name="deployOptions" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.validateEnvironmentDeploymentDependencies.parameter.deployOptions"></a>
5238
+
5239
+ - *Type:* <a href="#deployable-awscdk-app-ts.DeployOptions">DeployOptions</a>
5240
+
5241
+ The deployment options.
5242
+
5243
+ ---
5244
+
5245
+ ###### `environmentDependencies`<sup>Required</sup> <a name="environmentDependencies" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.validateEnvironmentDeploymentDependencies.parameter.environmentDependencies"></a>
5246
+
5247
+ - *Type:* {[ key: string ]: string[]}
5248
+
5249
+ The environment deployment dependencies to validate.
5250
+
5251
+ ---
5252
+
5253
+ #### Properties <a name="Properties" id="Properties"></a>
5254
+
5255
+ | **Name** | **Type** | **Description** |
5256
+ | --- | --- | --- |
5257
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.assumeAwsRoleStepForMatrix">assumeAwsRoleStepForMatrix</a></code> | <code>projen.github.workflows.JobStep</code> | Step to assume an AWS role for the matrix strategy. |
5258
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.checkoutStep">checkoutStep</a></code> | <code>projen.github.workflows.JobStep</code> | *No description.* |
5259
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.deploymentJobs">deploymentJobs</a></code> | <code>{[ key: string ]: projen.github.workflows.Job}</code> | Get all deployment jobs whether for matrix strategy or not. |
5260
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.deploymentJobsForMatrix">deploymentJobsForMatrix</a></code> | <code>{[ key: string ]: projen.github.workflows.Job}</code> | Get deployment jobs for matrix strategy. |
5261
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.deploymentJobsForMultiJob">deploymentJobsForMultiJob</a></code> | <code>{[ key: string ]: projen.github.workflows.Job}</code> | Get deployment jobs for multi-job strategy. |
5262
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.deploymentStep">deploymentStep</a></code> | <code>projen.github.workflows.JobStep</code> | Step to deploy the workflow. |
5263
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.postDeploymentStepForMatrix">postDeploymentStepForMatrix</a></code> | <code>projen.github.workflows.JobStep</code> | Step to run post deployment script in matrix strategy. |
5264
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.preDeploymentStepForMatrix">preDeploymentStepForMatrix</a></code> | <code>projen.github.workflows.JobStep</code> | Step to run post deployment script in matrix strategy. |
5265
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.setupAwsCredentialsInEnvironmentForMatrix">setupAwsCredentialsInEnvironmentForMatrix</a></code> | <code>projen.github.workflows.JobStep</code> | Step to setup AWS credentials in the environment for the matrix strategy. |
5266
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.setupAwsCredentialsStepsForMatrix">setupAwsCredentialsStepsForMatrix</a></code> | <code>projen.github.workflows.JobStep[]</code> | Step to setup AWS credentials in the environment for the matrix strategy. |
5267
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.checkActiveDeploymentStepForMatrix">checkActiveDeploymentStepForMatrix</a></code> | <code>projen.github.workflows.JobStep</code> | Step to check if there is an active deployment for the environment in the matrix strategy. |
5268
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.preInstallDependenciesStep">preInstallDependenciesStep</a></code> | <code>projen.github.workflows.JobStep</code> | Step to run before installing dependencies if exists. |
5269
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.setupNpmConfigForMatrix">setupNpmConfigForMatrix</a></code> | <code>projen.github.workflows.JobStep</code> | Step to setup NPM config if provided. |
5270
+ | <code><a href="#deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.skipIfAlreadyActiveDeploymentCondition">skipIfAlreadyActiveDeploymentCondition</a></code> | <code>projen.github.workflows.JobStep</code> | Condition to skip a step if an active deployment is already present. |
5271
+
5272
+ ---
5273
+
5274
+ ##### `assumeAwsRoleStepForMatrix`<sup>Required</sup> <a name="assumeAwsRoleStepForMatrix" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.assumeAwsRoleStepForMatrix"></a>
5275
+
5276
+ ```typescript
5277
+ public readonly assumeAwsRoleStepForMatrix: JobStep;
5278
+ ```
5279
+
5280
+ - *Type:* projen.github.workflows.JobStep
5281
+
5282
+ Step to assume an AWS role for the matrix strategy.
5283
+
5284
+ ---
5285
+
5286
+ ##### `checkoutStep`<sup>Required</sup> <a name="checkoutStep" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.checkoutStep"></a>
5287
+
5288
+ ```typescript
5289
+ public readonly checkoutStep: JobStep;
5290
+ ```
5291
+
5292
+ - *Type:* projen.github.workflows.JobStep
5293
+
5294
+ ---
5295
+
5296
+ ##### `deploymentJobs`<sup>Required</sup> <a name="deploymentJobs" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.deploymentJobs"></a>
5297
+
5298
+ ```typescript
5299
+ public readonly deploymentJobs: {[ key: string ]: Job};
5300
+ ```
5301
+
5302
+ - *Type:* {[ key: string ]: projen.github.workflows.Job}
5303
+
5304
+ Get all deployment jobs whether for matrix strategy or not.
5305
+
5306
+ ---
5307
+
5308
+ ##### `deploymentJobsForMatrix`<sup>Required</sup> <a name="deploymentJobsForMatrix" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.deploymentJobsForMatrix"></a>
5309
+
5310
+ ```typescript
5311
+ public readonly deploymentJobsForMatrix: {[ key: string ]: Job};
5312
+ ```
5313
+
5314
+ - *Type:* {[ key: string ]: projen.github.workflows.Job}
5315
+
5316
+ Get deployment jobs for matrix strategy.
5317
+
5318
+ ---
5319
+
5320
+ ##### `deploymentJobsForMultiJob`<sup>Required</sup> <a name="deploymentJobsForMultiJob" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.deploymentJobsForMultiJob"></a>
5321
+
5322
+ ```typescript
5323
+ public readonly deploymentJobsForMultiJob: {[ key: string ]: Job};
5324
+ ```
5325
+
5326
+ - *Type:* {[ key: string ]: projen.github.workflows.Job}
5327
+
5328
+ Get deployment jobs for multi-job strategy.
5329
+
5330
+ ---
5331
+
5332
+ ##### `deploymentStep`<sup>Required</sup> <a name="deploymentStep" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.deploymentStep"></a>
5333
+
5334
+ ```typescript
5335
+ public readonly deploymentStep: JobStep;
5336
+ ```
5337
+
5338
+ - *Type:* projen.github.workflows.JobStep
5339
+
5340
+ Step to deploy the workflow.
5341
+
5342
+ ---
5343
+
5344
+ ##### `postDeploymentStepForMatrix`<sup>Required</sup> <a name="postDeploymentStepForMatrix" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.postDeploymentStepForMatrix"></a>
5345
+
5346
+ ```typescript
5347
+ public readonly postDeploymentStepForMatrix: JobStep;
5348
+ ```
5349
+
5350
+ - *Type:* projen.github.workflows.JobStep
5351
+
5352
+ Step to run post deployment script in matrix strategy.
5353
+
5354
+ ---
5355
+
5356
+ ##### `preDeploymentStepForMatrix`<sup>Required</sup> <a name="preDeploymentStepForMatrix" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.preDeploymentStepForMatrix"></a>
5357
+
5358
+ ```typescript
5359
+ public readonly preDeploymentStepForMatrix: JobStep;
5360
+ ```
5361
+
5362
+ - *Type:* projen.github.workflows.JobStep
5363
+
5364
+ Step to run post deployment script in matrix strategy.
5365
+
5366
+ ---
5367
+
5368
+ ##### `setupAwsCredentialsInEnvironmentForMatrix`<sup>Required</sup> <a name="setupAwsCredentialsInEnvironmentForMatrix" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.setupAwsCredentialsInEnvironmentForMatrix"></a>
5369
+
5370
+ ```typescript
5371
+ public readonly setupAwsCredentialsInEnvironmentForMatrix: JobStep;
5372
+ ```
5373
+
5374
+ - *Type:* projen.github.workflows.JobStep
5375
+
5376
+ Step to setup AWS credentials in the environment for the matrix strategy.
5377
+
5378
+ ---
5379
+
5380
+ ##### `setupAwsCredentialsStepsForMatrix`<sup>Required</sup> <a name="setupAwsCredentialsStepsForMatrix" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.setupAwsCredentialsStepsForMatrix"></a>
5381
+
5382
+ ```typescript
5383
+ public readonly setupAwsCredentialsStepsForMatrix: JobStep[];
5384
+ ```
5385
+
5386
+ - *Type:* projen.github.workflows.JobStep[]
5387
+
5388
+ Step to setup AWS credentials in the environment for the matrix strategy.
5389
+
5390
+ ---
5391
+
5392
+ ##### `checkActiveDeploymentStepForMatrix`<sup>Optional</sup> <a name="checkActiveDeploymentStepForMatrix" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.checkActiveDeploymentStepForMatrix"></a>
5393
+
5394
+ ```typescript
5395
+ public readonly checkActiveDeploymentStepForMatrix: JobStep;
5396
+ ```
5397
+
5398
+ - *Type:* projen.github.workflows.JobStep
5399
+
5400
+ Step to check if there is an active deployment for the environment in the matrix strategy.
5401
+
5402
+ ---
5403
+
5404
+ ##### `preInstallDependenciesStep`<sup>Optional</sup> <a name="preInstallDependenciesStep" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.preInstallDependenciesStep"></a>
5405
+
5406
+ ```typescript
5407
+ public readonly preInstallDependenciesStep: JobStep;
5408
+ ```
5409
+
5410
+ - *Type:* projen.github.workflows.JobStep
5411
+
5412
+ Step to run before installing dependencies if exists.
5413
+
5414
+ ---
5415
+
5416
+ ##### `setupNpmConfigForMatrix`<sup>Optional</sup> <a name="setupNpmConfigForMatrix" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.setupNpmConfigForMatrix"></a>
5417
+
5418
+ ```typescript
5419
+ public readonly setupNpmConfigForMatrix: JobStep;
5420
+ ```
5421
+
5422
+ - *Type:* projen.github.workflows.JobStep
5423
+
5424
+ Step to setup NPM config if provided.
5425
+
5426
+ ---
5427
+
5428
+ ##### `skipIfAlreadyActiveDeploymentCondition`<sup>Optional</sup> <a name="skipIfAlreadyActiveDeploymentCondition" id="deployable-awscdk-app-ts.DeployableAwsCdkTypeScriptAppStepsFactory.property.skipIfAlreadyActiveDeploymentCondition"></a>
5429
+
5430
+ ```typescript
5431
+ public readonly skipIfAlreadyActiveDeploymentCondition: JobStep;
5432
+ ```
5433
+
5434
+ - *Type:* projen.github.workflows.JobStep
5435
+
5436
+ Condition to skip a step if an active deployment is already present.
5437
+
5438
+ ---
5439
+
4797
5440
 
4798
5441
 
4799
5442
  ## Enums <a name="Enums" id="Enums"></a>
package/lib/index.d.ts CHANGED
@@ -2,6 +2,7 @@ import { awscdk, Task } from 'projen';
2
2
  import { DeployableAwsCdkTypeScriptAppOptions, DeployOptions, EnvironmentDeploymentDependencies, EnvironmentOptions } from './types';
3
3
  export * from './types';
4
4
  export * as utils from './utils';
5
+ export * from './steps';
5
6
  export declare class DeployableAwsCdkTypeScriptApp extends awscdk.AwsCdkTypeScriptApp {
6
7
  /**
7
8
  * Task to deploy your app.