Class DefaultStackSynthesizer
Uses conventionally named roles and asset storage locations.
Implements
Inherited Members
Namespace: Amazon.CDK
Assembly: Amazon.CDK.dll
Syntax (csharp)
public class DefaultStackSynthesizer : StackSynthesizer, IStackSynthesizer
Syntax (vb)
Public Class DefaultStackSynthesizer
Inherits StackSynthesizer
Implements IStackSynthesizer
Remarks
This synthesizer:
Requires the environment to have been bootstrapped with Bootstrap Stack V2 (also known as "modern bootstrap stack"). The synthesizer adds a version check to the template, to make sure the bootstrap stack is recent enough to support all features expected by this synthesizer.
ExampleMetadata: infused
Examples
new MyStack(app, "MyStack", new StackProps {
Synthesizer = new DefaultStackSynthesizer(new DefaultStackSynthesizerProps {
FileAssetsBucketName = "my-orgs-asset-bucket"
})
});
Synopsis
Constructors
DefaultStackSynthesizer(IDefaultStackSynthesizerProps) | |
DefaultStackSynthesizer(ByRefValue) | Used by jsii to construct an instance of this class from a Javascript-owned object reference |
DefaultStackSynthesizer(DeputyBase.DeputyProps) | Used by jsii to construct an instance of this class from DeputyProps |
Properties
CloudFormationExecutionRoleArn | Returns the ARN of the CFN execution Role. |
DEFAULT_BOOTSTRAP_STACK_VERSION_SSM_PARAMETER | Default bootstrap stack version SSM parameter. |
DEFAULT_CLOUDFORMATION_ROLE_ARN | Default CloudFormation role ARN. |
DEFAULT_DEPLOY_ROLE_ARN | Default deploy role ARN. |
DEFAULT_DOCKER_ASSET_PREFIX | Default Docker asset prefix. |
DEFAULT_FILE_ASSET_KEY_ARN_EXPORT_NAME | Name of the CloudFormation Export with the asset key name. |
DEFAULT_FILE_ASSET_PREFIX | Default file asset prefix. |
DEFAULT_FILE_ASSET_PUBLISHING_ROLE_ARN | Default asset publishing role ARN for file (S3) assets. |
DEFAULT_FILE_ASSETS_BUCKET_NAME | Default file assets bucket name. |
DEFAULT_IMAGE_ASSET_PUBLISHING_ROLE_ARN | Default asset publishing role ARN for image (ECR) assets. |
DEFAULT_IMAGE_ASSETS_REPOSITORY_NAME | Default image assets repository name. |
DEFAULT_LOOKUP_ROLE_ARN | Default lookup role ARN for missing values. |
DEFAULT_QUALIFIER | Default ARN qualifier. |
DeployRoleArn | Returns the ARN of the deploy Role. |
Stack |
Methods
AddDockerImageAsset(IDockerImageAssetSource) | Register a Docker Image Asset. |
AddFileAsset(IFileAssetSource) | Register a File Asset. |
Bind(Stack) | Bind to the stack this environment is going to be used on. |
Synthesize(ISynthesisSession) | Synthesize the associated stack to the session. |
SynthesizeStackTemplate(Stack, ISynthesisSession) | Have the stack write out its template. |
Constructors
DefaultStackSynthesizer(IDefaultStackSynthesizerProps)
public DefaultStackSynthesizer(IDefaultStackSynthesizerProps props = null)
Parameters
DefaultStackSynthesizer(ByRefValue)
Used by jsii to construct an instance of this class from a Javascript-owned object reference
protected DefaultStackSynthesizer(ByRefValue reference)
Parameters
- reference Amazon.JSII.Runtime.Deputy.ByRefValue
The Javascript-owned object reference
DefaultStackSynthesizer(DeputyBase.DeputyProps)
Used by jsii to construct an instance of this class from DeputyProps
protected DefaultStackSynthesizer(DeputyBase.DeputyProps props)
Parameters
- props Amazon.JSII.Runtime.Deputy.DeputyBase.DeputyProps
The deputy props
Properties
CloudFormationExecutionRoleArn
Returns the ARN of the CFN execution Role.
public virtual string CloudFormationExecutionRoleArn { get; }
Property Value
System.String
DEFAULT_BOOTSTRAP_STACK_VERSION_SSM_PARAMETER
Default bootstrap stack version SSM parameter.
public static string DEFAULT_BOOTSTRAP_STACK_VERSION_SSM_PARAMETER { get; }
Property Value
System.String
DEFAULT_CLOUDFORMATION_ROLE_ARN
Default CloudFormation role ARN.
public static string DEFAULT_CLOUDFORMATION_ROLE_ARN { get; }
Property Value
System.String
DEFAULT_DEPLOY_ROLE_ARN
Default deploy role ARN.
public static string DEFAULT_DEPLOY_ROLE_ARN { get; }
Property Value
System.String
DEFAULT_DOCKER_ASSET_PREFIX
Default Docker asset prefix.
public static string DEFAULT_DOCKER_ASSET_PREFIX { get; }
Property Value
System.String
DEFAULT_FILE_ASSET_KEY_ARN_EXPORT_NAME
Name of the CloudFormation Export with the asset key name.
public static string DEFAULT_FILE_ASSET_KEY_ARN_EXPORT_NAME { get; }
Property Value
System.String
DEFAULT_FILE_ASSET_PREFIX
Default file asset prefix.
public static string DEFAULT_FILE_ASSET_PREFIX { get; }
Property Value
System.String
DEFAULT_FILE_ASSET_PUBLISHING_ROLE_ARN
Default asset publishing role ARN for file (S3) assets.
public static string DEFAULT_FILE_ASSET_PUBLISHING_ROLE_ARN { get; }
Property Value
System.String
DEFAULT_FILE_ASSETS_BUCKET_NAME
Default file assets bucket name.
public static string DEFAULT_FILE_ASSETS_BUCKET_NAME { get; }
Property Value
System.String
DEFAULT_IMAGE_ASSET_PUBLISHING_ROLE_ARN
Default asset publishing role ARN for image (ECR) assets.
public static string DEFAULT_IMAGE_ASSET_PUBLISHING_ROLE_ARN { get; }
Property Value
System.String
DEFAULT_IMAGE_ASSETS_REPOSITORY_NAME
Default image assets repository name.
public static string DEFAULT_IMAGE_ASSETS_REPOSITORY_NAME { get; }
Property Value
System.String
DEFAULT_LOOKUP_ROLE_ARN
Default lookup role ARN for missing values.
public static string DEFAULT_LOOKUP_ROLE_ARN { get; }
Property Value
System.String
DEFAULT_QUALIFIER
Default ARN qualifier.
public static string DEFAULT_QUALIFIER { get; }
Property Value
System.String
DeployRoleArn
Returns the ARN of the deploy Role.
public virtual string DeployRoleArn { get; }
Property Value
System.String
Stack
Methods
AddDockerImageAsset(IDockerImageAssetSource)
Register a Docker Image Asset.
public override IDockerImageAssetLocation AddDockerImageAsset(IDockerImageAssetSource asset)
Parameters
- asset IDockerImageAssetSource
Returns
Overrides
Remarks
Returns the parameters that can be used to refer to the asset inside the template.
AddFileAsset(IFileAssetSource)
Register a File Asset.
public override IFileAssetLocation AddFileAsset(IFileAssetSource asset)
Parameters
- asset IFileAssetSource
Returns
Overrides
Remarks
Returns the parameters that can be used to refer to the asset inside the template.
Bind(Stack)
Bind to the stack this environment is going to be used on.
public override void Bind(Stack stack)
Parameters
- stack Stack
Overrides
Remarks
Must be called before any of the other methods are called.
Synthesize(ISynthesisSession)
Synthesize the associated stack to the session.
public override void Synthesize(ISynthesisSession session)
Parameters
- session ISynthesisSession
Overrides
SynthesizeStackTemplate(Stack, ISynthesisSession)
Have the stack write out its template.
protected override void SynthesizeStackTemplate(Stack stack, ISynthesisSession session)
Parameters
- stack Stack
- session ISynthesisSession