software.amazon.awscdk.core

Class DockerImageAssetSource.Builder

java.lang.Object

software.amazon.awscdk.core.DockerImageAssetSource.Builder

Enclosing interface:

DockerImageAssetSource

@Stability(value=Stable)
public static final class DockerImageAssetSource.Builder
extends Object

A builder for DockerImageAssetSource

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
DockerImageAssetSource	build() Builds the configured instance.
DockerImageAssetSource.Builder	directoryName(String directoryName) Sets the value of DockerImageAssetSource.getDirectoryName()
DockerImageAssetSource.Builder	dockerBuildArgs(Map<String,String> dockerBuildArgs) Sets the value of DockerImageAssetSource.getDockerBuildArgs()
DockerImageAssetSource.Builder	dockerBuildTarget(String dockerBuildTarget) Sets the value of DockerImageAssetSource.getDockerBuildTarget()
DockerImageAssetSource.Builder	dockerFile(String dockerFile) Sets the value of DockerImageAssetSource.getDockerFile()
DockerImageAssetSource.Builder	repositoryName(String repositoryName) Deprecated. repository name should be specified at the environment-level and not at the image level
DockerImageAssetSource.Builder	sourceHash(String sourceHash) Sets the value of DockerImageAssetSource.getSourceHash()

Methods inherited from class java.lang.Object

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

Constructor Detail

Builder

public Builder()

Method Detail

directoryName

@Stability(value=Stable)
public DockerImageAssetSource.Builder directoryName(String directoryName)

Sets the value of DockerImageAssetSource.getDirectoryName()

Parameters:

directoryName - The directory where the Dockerfile is stored, must be relative to the cloud assembly root. This parameter is required.

Returns:

this

sourceHash

@Stability(value=Stable)
public DockerImageAssetSource.Builder sourceHash(String sourceHash)

Sets the value of DockerImageAssetSource.getSourceHash()

Parameters:

sourceHash - The hash of the contents of the docker build context. This parameter is required. 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).

Returns:

this

dockerBuildArgs

@Stability(value=Stable)
public DockerImageAssetSource.Builder dockerBuildArgs(Map<String,String> dockerBuildArgs)

Sets the value of DockerImageAssetSource.getDockerBuildArgs()

Parameters:

dockerBuildArgs - 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).

Returns:

this

dockerBuildTarget

@Stability(value=Stable)
public DockerImageAssetSource.Builder dockerBuildTarget(String dockerBuildTarget)

Sets the value of DockerImageAssetSource.getDockerBuildTarget()

Parameters:

dockerBuildTarget - Docker target to build to.

Returns:

this

dockerFile

@Stability(value=Stable)
public DockerImageAssetSource.Builder dockerFile(String dockerFile)

Sets the value of DockerImageAssetSource.getDockerFile()

Parameters:

dockerFile - Path to the Dockerfile (relative to the directory).

Returns:

this

repositoryName

@Stability(value=Deprecated)
 @Deprecated
public DockerImageAssetSource.Builder repositoryName(String repositoryName)

Deprecated. repository name should be specified at the environment-level and not at the image level

Sets the value of DockerImageAssetSource.getRepositoryName()

Parameters:

repositoryName - ECR repository name. Specify this property if you need to statically address the image, e.g. from a Kubernetes Pod. Note, this is only the repository name, without the registry and the tag parts.

Returns:

this

build

@Stability(value=Stable)
public DockerImageAssetSource build()

Builds the configured instance.

Returns:

a new instance of DockerImageAssetSource

Throws:

NullPointerException - if any required attribute was not provided