software.amazon.awscdk.services.ecr.assets

Interface DockerImageAssetOptions

All Superinterfaces:

CopyOptions, FileCopyOptions, FileFingerprintOptions, FingerprintOptions, software.amazon.jsii.JsiiSerializable

All Known Subinterfaces:

AssetImageCodeProps, AssetImageProps, DockerImageAssetProps

All Known Implementing Classes:

AssetImageCodeProps.Jsii$Proxy, AssetImageProps.Jsii$Proxy, DockerImageAssetOptions.Jsii$Proxy, DockerImageAssetProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.58.0 (build f8ba112)",
           date="2022-05-11T19:24:29.091Z")
 @Stability(value=Experimental)
public interface DockerImageAssetOptions
extends software.amazon.jsii.JsiiSerializable, FingerprintOptions, FileFingerprintOptions

(experimental) Options for DockerImageAsset.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.core.*;
 import software.amazon.awscdk.assets.*;
 import software.amazon.awscdk.services.ecr.assets.*;
 NetworkMode networkMode;
 DockerImageAssetOptions dockerImageAssetOptions = DockerImageAssetOptions.builder()
         .buildArgs(Map.of(
                 "buildArgsKey", "buildArgs"))
         .exclude(List.of("exclude"))
         .extraHash("extraHash")
         .file("file")
         .follow(FollowMode.NEVER)
         .followSymlinks(SymlinkFollowMode.NEVER)
         .ignoreMode(IgnoreMode.GLOB)
         .invalidation(DockerImageAssetInvalidationOptions.builder()
                 .buildArgs(false)
                 .extraHash(false)
                 .file(false)
                 .networkMode(false)
                 .repositoryName(false)
                 .target(false)
                 .build())
         .networkMode(networkMode)
         .repositoryName("repositoryName")
         .target("target")
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static DockerImageAssetOptions.Builder	builder()
default Map<String,String>	getBuildArgs() (experimental) Build args to pass to the `docker build` command.
default List<String>	getExclude() Deprecated.
default String	getExtraHash() Deprecated.
default String	getFile() (experimental) Path to the Dockerfile (relative to the directory).
default IgnoreMode	getIgnoreMode() Deprecated.
default DockerImageAssetInvalidationOptions	getInvalidation() (experimental) Options to control which parameters are used to invalidate the asset hash.
default NetworkMode	getNetworkMode() (experimental) Networking mode for the RUN commands during build.
default String	getRepositoryName() Deprecated. to control the location of docker image assets, please override `Stack.addDockerImageAsset`. this feature will be removed in future releases.
default String	getTarget() (experimental) Docker target to build to.

Methods inherited from interface software.amazon.awscdk.assets.CopyOptions

getFollow

Methods inherited from interface software.amazon.awscdk.core.FileCopyOptions

getFollowSymlinks

Method Detail

getBuildArgs

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

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

Default: - no build args are passed

getFile

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

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

Default: 'Dockerfile'

getInvalidation

@Stability(value=Experimental)
 @Nullable
default DockerImageAssetInvalidationOptions getInvalidation()

(experimental) Options to control which parameters are used to invalidate the asset hash.

Default: - hash all parameters

getNetworkMode

@Stability(value=Experimental)
 @Nullable
default NetworkMode getNetworkMode()

(experimental) Networking mode for the RUN commands during build.

Support docker API 1.25+.

Default: - no networking mode specified (the default networking mode `NetworkMode.DEFAULT` will be used)

getRepositoryName

@Stability(value=Deprecated)
 @Deprecated
 @Nullable
default String getRepositoryName()

Deprecated. to control the location of docker image assets, please override `Stack.addDockerImageAsset`. this feature will be removed in future releases.

(deprecated) 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.

Default: - the default ECR repository for CDK assets

getTarget

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

(experimental) Docker target to build to.

Default: - no target

getExtraHash

@Stability(value=Deprecated)
 @Deprecated
 @Nullable
default String getExtraHash()

Deprecated.

(deprecated) Extra information to encode into the fingerprint (e.g. build instructions and other inputs).

Default: - hash is only based on source content

Specified by:

getExtraHash in interface FileFingerprintOptions

Specified by:

getExtraHash in interface FingerprintOptions

getExclude

@Stability(value=Deprecated)
 @Deprecated
 @Nullable
default List<String> getExclude()

Deprecated.

(deprecated) Glob patterns to exclude from the copy.

Default: nothing is excluded

Specified by:

getExclude in interface CopyOptions

Specified by:

getExclude in interface FileCopyOptions

getIgnoreMode

@Stability(value=Deprecated)
 @Deprecated
 @Nullable
default IgnoreMode getIgnoreMode()

Deprecated.

(deprecated) The ignore behavior to use for exclude patterns.

Default: - GLOB for file assets, DOCKER or GLOB for docker assets depending on whether the '

Specified by:

getIgnoreMode in interface CopyOptions

Specified by:

getIgnoreMode in interface FileCopyOptions

builder

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

Specified by:

builder in interface CopyOptions

Specified by:

builder in interface FileCopyOptions

Specified by:

builder in interface FileFingerprintOptions

Specified by:

builder in interface FingerprintOptions

Returns:

a DockerImageAssetOptions.Builder of DockerImageAssetOptions