AssetManifestBuilder

class aws_cdk.AssetManifestBuilder

Bases: object

Build an asset manifest from assets added to a stack.

This class does not need to be used by app builders; it is only necessary for building Stack Synthesizers.

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk as cdk

asset_manifest_builder = cdk.AssetManifestBuilder()

Methods

add_docker_image_asset(stack, source_hash, source, dest, *, display_name=None)

Add a docker asset source and destination to the manifest.

sourceHash should be unique for every source.

Parameters:

  • stack (Stack)

  • source_hash (str)

  • source (Union[DockerImageSource, Dict[str, Any]])

  • dest (Union[DockerImageDestination, Dict[str, Any]])

  • display_name (Optional[str]) – A display name to associate with the asset. Default: - No display name

Return type:

DockerImageDestination

add_file_asset(stack, source_hash, source, dest, *, display_name=None)

Add a file asset source and destination to the manifest.

sourceHash should be unique for every source.

Parameters:

  • stack (Stack)

  • source_hash (str)

  • source (Union[FileSource, Dict[str, Any]])

  • dest (Union[FileDestination, Dict[str, Any]])

  • display_name (Optional[str]) – A display name to associate with the asset. Default: - No display name

Return type:

FileDestination

default_add_docker_image_asset(stack, asset, target, *, display_name=None)

Add a docker image asset to the manifest with default settings.

Derive the region from the stack, use the asset hash as the key, and set the prefix.

Parameters:
Return type:

DockerImageDestination

default_add_file_asset(stack, asset, target, *, display_name=None)

Add a file asset to the manifest with default settings.

Derive the region from the stack, use the asset hash as the key, copy the file extension over, and set the prefix.

Parameters:
Return type:

FileDestination

emit_manifest(stack, session, options=None, dependencies=None)

Write the manifest to disk, and add it to the synthesis session.

Return the artifact id, which should be added to the additionalDependencies field of the stack artifact.

Parameters:
Return type:

str

Attributes

has_assets

Whether there are any assets registered in the manifest.