software.amazon.awscdk.core

Class DefaultStackSynthesizer

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.core.StackSynthesizer

software.amazon.awscdk.core.DefaultStackSynthesizer

All Implemented Interfaces:

IStackSynthesizer, software.amazon.jsii.JsiiSerializable

Direct Known Subclasses:

BootstraplessSynthesizer

@Generated(value="jsii-pacmak/1.12.0 (build 5ddc9f2)",
           date="2020-09-22T23:51:18.639Z")
 @Stability(value=Stable)
public class DefaultStackSynthesizer
extends StackSynthesizer

Uses conventionally named roles and reify asset storage locations.

This synthesizer is the only StackSynthesizer that generates an asset manifest, and is required to deploy CDK applications using the @aws-cdk/app-delivery CI/CD library.

Requires the environment to have been bootstrapped with Bootstrap Stack V2.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DefaultStackSynthesizer.Builder A fluent builder for DefaultStackSynthesizer.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_CLOUDFORMATION_ROLE_ARN Default CloudFormation role ARN.
static String	DEFAULT_DEPLOY_ROLE_ARN Default deploy role ARN.
static String	DEFAULT_FILE_ASSET_KEY_ARN_EXPORT_NAME Name of the CloudFormation Export with the asset key name.
static String	DEFAULT_FILE_ASSET_PUBLISHING_ROLE_ARN Default asset publishing role ARN for file (S3) assets.
static String	DEFAULT_FILE_ASSETS_BUCKET_NAME Default file assets bucket name.
static String	DEFAULT_IMAGE_ASSET_PUBLISHING_ROLE_ARN Default asset publishing role ARN for image (ECR) assets.
static String	DEFAULT_IMAGE_ASSETS_REPOSITORY_NAME Default image assets repository name.
static String	DEFAULT_QUALIFIER Default ARN qualifier.

Constructor Summary

Constructors

Modifier	Constructor and Description
	DefaultStackSynthesizer()
	DefaultStackSynthesizer(DefaultStackSynthesizerProps props)
protected	DefaultStackSynthesizer(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	DefaultStackSynthesizer(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
DockerImageAssetLocation	addDockerImageAsset(DockerImageAssetSource asset) Register a Docker Image Asset.
FileAssetLocation	addFileAsset(FileAssetSource asset) Register a File Asset.
void	bind(Stack stack) Bind to the stack this environment is going to be used on.
String	getCloudFormationExecutionRoleArn() Returns the ARN of the CFN execution Role.
String	getDeployRoleArn() Returns the ARN of the deploy Role.
protected Stack	getStack()
void	synthesize(ISynthesisSession session) Synthesize the associated stack to the session.

Methods inherited from class software.amazon.awscdk.core.StackSynthesizer

emitStackArtifact, emitStackArtifact, synthesizeStackTemplate

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Detail

DEFAULT_CLOUDFORMATION_ROLE_ARN

@Stability(value=Stable)
public static final String DEFAULT_CLOUDFORMATION_ROLE_ARN

Default CloudFormation role ARN.

DEFAULT_DEPLOY_ROLE_ARN

@Stability(value=Stable)
public static final String DEFAULT_DEPLOY_ROLE_ARN

Default deploy role ARN.

DEFAULT_FILE_ASSET_KEY_ARN_EXPORT_NAME

@Stability(value=Stable)
public static final String DEFAULT_FILE_ASSET_KEY_ARN_EXPORT_NAME

Name of the CloudFormation Export with the asset key name.

DEFAULT_FILE_ASSET_PUBLISHING_ROLE_ARN

@Stability(value=Stable)
public static final String DEFAULT_FILE_ASSET_PUBLISHING_ROLE_ARN

Default asset publishing role ARN for file (S3) assets.

DEFAULT_FILE_ASSETS_BUCKET_NAME

@Stability(value=Stable)
public static final String DEFAULT_FILE_ASSETS_BUCKET_NAME

Default file assets bucket name.

DEFAULT_IMAGE_ASSET_PUBLISHING_ROLE_ARN

@Stability(value=Stable)
public static final String DEFAULT_IMAGE_ASSET_PUBLISHING_ROLE_ARN

Default asset publishing role ARN for image (ECR) assets.

DEFAULT_IMAGE_ASSETS_REPOSITORY_NAME

@Stability(value=Stable)
public static final String DEFAULT_IMAGE_ASSETS_REPOSITORY_NAME

Default image assets repository name.

DEFAULT_QUALIFIER

@Stability(value=Stable)
public static final String DEFAULT_QUALIFIER

Default ARN qualifier.

Constructor Detail

DefaultStackSynthesizer

protected DefaultStackSynthesizer(software.amazon.jsii.JsiiObjectRef objRef)

DefaultStackSynthesizer

protected DefaultStackSynthesizer(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

DefaultStackSynthesizer

@Stability(value=Stable)
public DefaultStackSynthesizer(@Nullable
                                                        DefaultStackSynthesizerProps props)

Parameters:

props -

DefaultStackSynthesizer

@Stability(value=Stable)
public DefaultStackSynthesizer()

Method Detail

addDockerImageAsset

@Stability(value=Stable)
 @NotNull
public DockerImageAssetLocation addDockerImageAsset(@NotNull
                                                                                       DockerImageAssetSource asset)

Register a Docker Image Asset.

Returns the parameters that can be used to refer to the asset inside the template.

Specified by:

addDockerImageAsset in interface IStackSynthesizer

Specified by:

addDockerImageAsset in class StackSynthesizer

Parameters:

asset - This parameter is required.

addFileAsset

@Stability(value=Stable)
 @NotNull
public FileAssetLocation addFileAsset(@NotNull
                                                                         FileAssetSource asset)

Register a File Asset.

Returns the parameters that can be used to refer to the asset inside the template.

Specified by:

addFileAsset in interface IStackSynthesizer

Specified by:

addFileAsset in class StackSynthesizer

Parameters:

asset - This parameter is required.

bind

@Stability(value=Stable)
public void bind(@NotNull
                                          Stack stack)

Bind to the stack this environment is going to be used on.

Must be called before any of the other methods are called.

Specified by:

bind in interface IStackSynthesizer

Specified by:

bind in class StackSynthesizer

Parameters:

stack - This parameter is required.

synthesize

@Stability(value=Stable)
public void synthesize(@NotNull
                                                ISynthesisSession session)

Synthesize the associated stack to the session.

Specified by:

synthesize in interface IStackSynthesizer

Specified by:

synthesize in class StackSynthesizer

Parameters:

session - This parameter is required.

getCloudFormationExecutionRoleArn

@Stability(value=Stable)
 @NotNull
public String getCloudFormationExecutionRoleArn()

Returns the ARN of the CFN execution Role.

getDeployRoleArn

@Stability(value=Stable)
 @NotNull
public String getDeployRoleArn()

Returns the ARN of the deploy Role.

getStack

@Stability(value=Stable)
 @Nullable
protected Stack getStack()