software.amazon.awscdk.cloudassembly.schema

Interface ContainerImageAssetMetadataEntry

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

ContainerImageAssetMetadataEntry.Jsii$Proxy

@Generated(value="jsii-pacmak/1.70.0 (build 03c2f6f)",
           date="2022-11-01T13:16:58.198Z")
 @Stability(value=Experimental)
public interface ContainerImageAssetMetadataEntry
extends software.amazon.jsii.JsiiSerializable

(experimental) Metadata Entry spec for container images.

Example:

 // Example automatically generated from non-compiling source. May contain errors.
 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.cloudassembly.schema.*;
 ContainerImageAssetMetadataEntry containerImageAssetMetadataEntry = ContainerImageAssetMetadataEntry.builder()
         .id("id")
         .packaging("packaging")
         .path("path")
         .sourceHash("sourceHash")
         // the properties below are optional
         .buildArgs(Map.of(
                 "buildArgsKey", "buildArgs"))
         .file("file")
         .imageNameParameter("imageNameParameter")
         .imageTag("imageTag")
         .networkMode("networkMode")
         .platform("platform")
         .repositoryName("repositoryName")
         .target("target")
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static ContainerImageAssetMetadataEntry.Builder	builder()
default Map<String,String>	getBuildArgs() (experimental) Build args to pass to the `docker build` command.
default String	getFile() (experimental) Path to the Dockerfile (relative to the directory).
String	getId() (experimental) Logical identifier for the asset.
default String	getImageNameParameter() Deprecated. specify `repositoryName` and `imageTag` instead, and then you know where the image will go.
default String	getImageTag() (experimental) The docker image tag to use for tagging pushed images.
default String	getNetworkMode() (experimental) Networking mode for the RUN commands during build.
String	getPackaging() (experimental) Type of asset.
String	getPath() (experimental) Path on disk to the asset.
default String	getPlatform() (experimental) Platform to build for.
default String	getRepositoryName() (experimental) ECR repository name, if omitted a default name based on the asset's ID is used instead.
String	getSourceHash() (experimental) The hash of the asset source.
default String	getTarget() (experimental) Docker target to build to.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getId

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

(experimental) Logical identifier for the asset.

getPackaging

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

(experimental) Type of asset.

getPath

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

(experimental) Path on disk to the asset.

getSourceHash

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

(experimental) The hash of the asset source.

getBuildArgs

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

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

Default: no build args are passed

getFile

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

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

Default: - no file is passed

getImageNameParameter

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

Deprecated. specify `repositoryName` and `imageTag` instead, and then you know where the image will go.

(deprecated) ECR Repository name and repo digest (separated by "@sha256:") where this image is stored.

Default: undefined If not specified, `repositoryName` and `imageTag` are required because otherwise how will the stack know where to find the asset, ha?

getImageTag

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

(experimental) The docker image tag to use for tagging pushed images.

This field is required if imageParameterName is ommited (otherwise, the app won't be able to find the image).

Default: - this parameter is REQUIRED after 1.21.0

getNetworkMode

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

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

Default: - no networking mode specified

getPlatform

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

(experimental) Platform to build for.

Requires Docker Buildx.

Default: - current machine platform

getRepositoryName

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

(experimental) ECR repository name, if omitted a default name based on the asset's ID is used instead.

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: - this parameter is REQUIRED after 1.21.0

getTarget

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

(experimental) Docker target to build to.

Default: no build target

builder

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

Returns:

a ContainerImageAssetMetadataEntry.Builder of ContainerImageAssetMetadataEntry