software.amazon.awscdk

Interface DockerImageAssetSource

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

DockerImageAssetSource.Jsii$Proxy

@Generated(value="jsii-pacmak/1.30.0 (build adae23f)",
           date="2021-06-30T10:00:42.457Z")
 @Stability(value=Experimental)
public interface DockerImageAssetSource
extends software.amazon.jsii.JsiiSerializable

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	DockerImageAssetSource.Builder A builder for DockerImageAssetSource
static class	DockerImageAssetSource.Jsii$Proxy An implementation for DockerImageAssetSource

Method Summary

Modifier and Type	Method and Description
static DockerImageAssetSource.Builder	builder()
default String	getDirectoryName() (experimental) The directory where the Dockerfile is stored, must be relative to the cloud assembly root.
default Map<String,String>	getDockerBuildArgs() (experimental) Build args to pass to the `docker build` command.
default String	getDockerBuildTarget() (experimental) Docker target to build to.
default String	getDockerFile() (experimental) Path to the Dockerfile (relative to the directory).
default List<String>	getExecutable() (experimental) An external command that will produce the packaged asset.
String	getSourceHash() (experimental) The hash of the contents of the docker build context.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getSourceHash

@Stability(value=Experimental)
 @NotNull
String getSourceHash()

(experimental) The hash of the contents of the docker build context.

This hash is used throughout the system to identify this image and avoid duplicate work in case the source did not change.

NOTE: this means that if you wish to update your docker image, you must make a modification to the source (e.g. add some metadata to your Dockerfile).

getDirectoryName

@Stability(value=Experimental)
 @Nullable
default String getDirectoryName()

(experimental) The directory where the Dockerfile is stored, must be relative to the cloud assembly root.

Default: - Exactly one of `directoryName` and `executable` is required

getDockerBuildArgs

@Stability(value=Experimental)
 @Nullable
default Map<String,String> getDockerBuildArgs()

(experimental) Build args to pass to the `docker build` command.

Since Docker build arguments are resolved before deployment, keys and values cannot refer to unresolved tokens (such as lambda.functionArn or queue.queueUrl).

Only allowed when directoryName is specified.

Default: - no build args are passed

getDockerBuildTarget

@Stability(value=Experimental)
 @Nullable
default String getDockerBuildTarget()

(experimental) Docker target to build to.

Only allowed when directoryName is specified.

Default: - no target

getDockerFile

@Stability(value=Experimental)
 @Nullable
default String getDockerFile()

(experimental) Path to the Dockerfile (relative to the directory).

Only allowed when directoryName is specified.

Default: - no file

getExecutable

@Stability(value=Experimental)
 @Nullable
default List<String> getExecutable()

(experimental) An external command that will produce the packaged asset.

The command should produce the name of a local Docker image on stdout.

Default: - Exactly one of `directoryName` and `executable` is required

builder

@Stability(value=Experimental)
static DockerImageAssetSource.Builder builder()

Returns:

a DockerImageAssetSource.Builder of DockerImageAssetSource