aws-cdk-lib.NestedStackSynthesizer

class NestedStackSynthesizer

LanguageType name
.NETAmazon.CDK.NestedStackSynthesizer
Gogithub.com/aws/aws-cdk-go/awscdk/v2#NestedStackSynthesizer
Javasoftware.amazon.awscdk.NestedStackSynthesizer
Pythonaws_cdk.NestedStackSynthesizer
TypeScript (source)aws-cdk-lib » NestedStackSynthesizer

Implements IStackSynthesizer

Extends StackSynthesizer

Synthesizer for a nested stack.

Forwards all calls to the parent stack's synthesizer.

This synthesizer is automatically used for NestedStack constructs. App builder do not need to use this class directly.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as cdk from 'aws-cdk-lib';

declare const stackSynthesizer: cdk.StackSynthesizer;
const nestedStackSynthesizer = new cdk.NestedStackSynthesizer(stackSynthesizer);

Initializer

new NestedStackSynthesizer(parentDeployment: IStackSynthesizer)

Parameters

  • parentDeployment IStackSynthesizer

Properties

NameTypeDescription
bootstrapQualifier?stringThe qualifier used to bootstrap this stack.
lookupRole?stringThe role used to lookup for this stack.

bootstrapQualifier?

Type: string (optional)

The qualifier used to bootstrap this stack.


lookupRole?

Type: string (optional)

The role used to lookup for this stack.

Methods

NameDescription
addDockerImageAsset(asset)Register a Docker Image Asset.
addFileAsset(asset)Register a File Asset.
bind(stack)Bind to the stack this environment is going to be used on.
synthesize(session)Synthesize the associated stack to the session.

addDockerImageAsset(asset)

public addDockerImageAsset(asset: DockerImageAssetSource): DockerImageAssetLocation

Parameters

  • asset DockerImageAssetSource

Returns

  • DockerImageAssetLocation

Register a Docker Image Asset.

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

The synthesizer must rely on some out-of-band mechanism to make sure the given files are actually placed in the returned location before the deployment happens. This can be by writing the instructions to the asset manifest (for use by the cdk-assets tool), by relying on the CLI to upload files (legacy behavior), or some other operator controlled mechanism.


addFileAsset(asset)

public addFileAsset(asset: FileAssetSource): FileAssetLocation

Parameters

  • asset FileAssetSource

Returns

  • FileAssetLocation

Register a File Asset.

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

The synthesizer must rely on some out-of-band mechanism to make sure the given files are actually placed in the returned location before the deployment happens. This can be by writing the instructions to the asset manifest (for use by the cdk-assets tool), by relying on the CLI to upload files (legacy behavior), or some other operator controlled mechanism.


bind(stack)

public bind(stack: Stack): void

Parameters

  • 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.


synthesize(session)

public synthesize(session: ISynthesisSession): void

Parameters

  • session ISynthesisSession

Synthesize the associated stack to the session.