Interface IDefaultStackSynthesizerProps
Configuration properties for DefaultStackSynthesizer.
Namespace: Amazon.CDK
Assembly: Amazon.CDK.dll
Syntax (csharp)
public interface IDefaultStackSynthesizerProps
Syntax (vb)
Public Interface IDefaultStackSynthesizerProps
Remarks
ExampleMetadata: infused
Examples
new MyStack(app, "MyStack", new StackProps {
Synthesizer = new DefaultStackSynthesizer(new DefaultStackSynthesizerProps {
FileAssetsBucketName = "my-orgs-asset-bucket"
})
});
Synopsis
Properties
BootstrapStackVersionSsmParameter | Bootstrap stack version SSM parameter. |
BucketPrefix | bucketPrefix to use while storing S3 Assets. |
CloudFormationExecutionRole | The role CloudFormation will assume when deploying the Stack. |
DeployRoleArn | The role to assume to initiate a deployment in this environment. |
DeployRoleExternalId | External ID to use when assuming role for cloudformation deployments. |
DockerTagPrefix | A prefix to use while tagging and uploading Docker images to ECR. |
FileAssetKeyArnExportName | (deprecated) Name of the CloudFormation Export with the asset key name. |
FileAssetPublishingExternalId | External ID to use when assuming role for file asset publishing. |
FileAssetPublishingRoleArn | The role to use to publish file assets to the S3 bucket in this environment. |
FileAssetsBucketName | Name of the S3 bucket to hold file assets. |
GenerateBootstrapVersionRule | Whether to add a Rule to the stack template verifying the bootstrap stack version. |
ImageAssetPublishingExternalId | External ID to use when assuming role for image asset publishing. |
ImageAssetPublishingRoleArn | The role to use to publish image assets to the ECR repository in this environment. |
ImageAssetsRepositoryName | Name of the ECR repository to hold Docker Image assets. |
LookupRoleArn | The role to use to look up values from the target AWS account during synthesis. |
LookupRoleExternalId | External ID to use when assuming lookup role. |
Qualifier | Qualifier to disambiguate multiple environments in the same account. |
UseLookupRoleForStackOperations | Use the bootstrapped lookup role for (read-only) stack operations. |
Properties
BootstrapStackVersionSsmParameter
Bootstrap stack version SSM parameter.
virtual string BootstrapStackVersionSsmParameter { get; }
Property Value
System.String
Remarks
The placeholder ${Qualifier}
will be replaced with the value of qualifier.
Default: DefaultStackSynthesizer.DEFAULT_BOOTSTRAP_STACK_VERSION_SSM_PARAMETER
BucketPrefix
bucketPrefix to use while storing S3 Assets.
virtual string BucketPrefix { get; }
Property Value
System.String
Remarks
Default: - DefaultStackSynthesizer.DEFAULT_FILE_ASSET_PREFIX
CloudFormationExecutionRole
The role CloudFormation will assume when deploying the Stack.
virtual string CloudFormationExecutionRole { get; }
Property Value
System.String
Remarks
You must supply this if you have given a non-standard name to the execution role.
The placeholders ${Qualifier}
, ${AWS::AccountId}
and ${AWS::Region}
will
be replaced with the values of qualifier and the stack's account and region,
respectively.
Default: DefaultStackSynthesizer.DEFAULT_CLOUDFORMATION_ROLE_ARN
DeployRoleArn
The role to assume to initiate a deployment in this environment.
virtual string DeployRoleArn { get; }
Property Value
System.String
Remarks
You must supply this if you have given a non-standard name to the publishing role.
The placeholders ${Qualifier}
, ${AWS::AccountId}
and ${AWS::Region}
will
be replaced with the values of qualifier and the stack's account and region,
respectively.
Default: DefaultStackSynthesizer.DEFAULT_DEPLOY_ROLE_ARN
DeployRoleExternalId
External ID to use when assuming role for cloudformation deployments.
virtual string DeployRoleExternalId { get; }
Property Value
System.String
Remarks
Default: - No external ID
DockerTagPrefix
A prefix to use while tagging and uploading Docker images to ECR.
virtual string DockerTagPrefix { get; }
Property Value
System.String
Remarks
This does not add any separators - the source hash will be appended to this string directly.
Default: - DefaultStackSynthesizer.DEFAULT_DOCKER_ASSET_PREFIX
FileAssetKeyArnExportName
(deprecated) Name of the CloudFormation Export with the asset key name.
virtual string FileAssetKeyArnExportName { get; }
Property Value
System.String
Remarks
You must supply this if you have given a non-standard name to the KMS key export
The placeholders ${Qualifier}
, ${AWS::AccountId}
and ${AWS::Region}
will
be replaced with the values of qualifier and the stack's account and region,
respectively.
Default: DefaultStackSynthesizer.DEFAULT_FILE_ASSET_KEY_ARN_EXPORT_NAME
Stability: Deprecated
FileAssetPublishingExternalId
External ID to use when assuming role for file asset publishing.
virtual string FileAssetPublishingExternalId { get; }
Property Value
System.String
Remarks
Default: - No external ID
FileAssetPublishingRoleArn
The role to use to publish file assets to the S3 bucket in this environment.
virtual string FileAssetPublishingRoleArn { get; }
Property Value
System.String
Remarks
You must supply this if you have given a non-standard name to the publishing role.
The placeholders ${Qualifier}
, ${AWS::AccountId}
and ${AWS::Region}
will
be replaced with the values of qualifier and the stack's account and region,
respectively.
Default: DefaultStackSynthesizer.DEFAULT_FILE_ASSET_PUBLISHING_ROLE_ARN
FileAssetsBucketName
Name of the S3 bucket to hold file assets.
virtual string FileAssetsBucketName { get; }
Property Value
System.String
Remarks
You must supply this if you have given a non-standard name to the staging bucket.
The placeholders ${Qualifier}
, ${AWS::AccountId}
and ${AWS::Region}
will
be replaced with the values of qualifier and the stack's account and region,
respectively.
Default: DefaultStackSynthesizer.DEFAULT_FILE_ASSETS_BUCKET_NAME
GenerateBootstrapVersionRule
Whether to add a Rule to the stack template verifying the bootstrap stack version.
virtual Nullable<bool> GenerateBootstrapVersionRule { get; }
Property Value
System.Nullable<System.Boolean>
Remarks
This generally should be left set to true
, unless you explicitly
want to be able to deploy to an unbootstrapped environment.
Default: true
ImageAssetPublishingExternalId
External ID to use when assuming role for image asset publishing.
virtual string ImageAssetPublishingExternalId { get; }
Property Value
System.String
Remarks
Default: - No external ID
ImageAssetPublishingRoleArn
The role to use to publish image assets to the ECR repository in this environment.
virtual string ImageAssetPublishingRoleArn { get; }
Property Value
System.String
Remarks
You must supply this if you have given a non-standard name to the publishing role.
The placeholders ${Qualifier}
, ${AWS::AccountId}
and ${AWS::Region}
will
be replaced with the values of qualifier and the stack's account and region,
respectively.
Default: DefaultStackSynthesizer.DEFAULT_IMAGE_ASSET_PUBLISHING_ROLE_ARN
ImageAssetsRepositoryName
Name of the ECR repository to hold Docker Image assets.
virtual string ImageAssetsRepositoryName { get; }
Property Value
System.String
Remarks
You must supply this if you have given a non-standard name to the ECR repository.
The placeholders ${Qualifier}
, ${AWS::AccountId}
and ${AWS::Region}
will
be replaced with the values of qualifier and the stack's account and region,
respectively.
Default: DefaultStackSynthesizer.DEFAULT_IMAGE_ASSETS_REPOSITORY_NAME
LookupRoleArn
The role to use to look up values from the target AWS account during synthesis.
virtual string LookupRoleArn { get; }
Property Value
System.String
Remarks
Default: - None
LookupRoleExternalId
External ID to use when assuming lookup role.
virtual string LookupRoleExternalId { get; }
Property Value
System.String
Remarks
Default: - No external ID
Qualifier
Qualifier to disambiguate multiple environments in the same account.
virtual string Qualifier { get; }
Property Value
System.String
Remarks
You can use this and leave the other naming properties empty if you have deployed the bootstrap environment with standard names but only differnet qualifiers.
Default: - Value of context key '
Aws-cdk: /core:bootstrapQualifier' if set, otherwise DefaultStackSynthesizer.DEFAULT_QUALIFIER
UseLookupRoleForStackOperations
Use the bootstrapped lookup role for (read-only) stack operations.
virtual Nullable<bool> UseLookupRoleForStackOperations { get; }
Property Value
System.Nullable<System.Boolean>
Remarks
Use the lookup role when performing a cdk diff
. If set to false
, the
deploy role
credentials will be used to perform a cdk diff
.
Requires bootstrap stack version 8.
Default: true