Package software.amazon.awscdk.cloud_assembly_schema

Interface DockerImageSource

All Superinterfaces:
software.amazon.jsii.JsiiSerializable
All Known Implementing Classes:
DockerImageSource.Jsii$Proxy
@Generated(value="jsii-pacmak/1.116.0 (build 0eddcff)", date="2025-10-29T11:15:50.787Z") @Stability(Stable) public interface DockerImageSource extends software.amazon.jsii.JsiiSerializable
Properties for how to produce a Docker image from a source.

Example: 

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.cloud_assembly_schema.*;
 DockerImageSource dockerImageSource = DockerImageSource.builder()
         .cacheDisabled(false)
         .cacheFrom(List.of(DockerCacheOption.builder()
                 .type("type")
                 // the properties below are optional
                 .params(Map.of(
                         "paramsKey", "params"))
                 .build()))
         .cacheTo(DockerCacheOption.builder()
                 .type("type")
                 // the properties below are optional
                 .params(Map.of(
                         "paramsKey", "params"))
                 .build())
         .directory("directory")
         .dockerBuildArgs(Map.of(
                 "dockerBuildArgsKey", "dockerBuildArgs"))
         .dockerBuildSecrets(Map.of(
                 "dockerBuildSecretsKey", "dockerBuildSecrets"))
         .dockerBuildSsh("dockerBuildSsh")
         .dockerBuildTarget("dockerBuildTarget")
         .dockerFile("dockerFile")
         .dockerOutputs(List.of("dockerOutputs"))
         .executable(List.of("executable"))
         .networkMode("networkMode")
         .platform("platform")
         .build();

  • Method Details

    • getCacheDisabled

      @Stability(Stable) @Nullable default Boolean getCacheDisabled()
      Disable the cache and pass --no-cache to the docker build command.

      Default: - cache is used

    • getCacheFrom

      @Stability(Stable) @Nullable default List<DockerCacheOption> getCacheFrom()
      Cache from options to pass to the docker build command.

      Default: - no cache from options are passed to the build command

      See Also:

    • getCacheTo

      @Stability(Stable) @Nullable default DockerCacheOption getCacheTo()
      Cache to options to pass to the docker build command.

      Default: - no cache to options are passed to the build command

      See Also:

    • getDirectory

      @Stability(Stable) @Nullable default String getDirectory()
      The directory containing the Docker image build instructions.

      This path is relative to the asset manifest location.

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

    • getDockerBuildArgs

      @Stability(Stable) @Nullable default Map<String,String> getDockerBuildArgs()
      Additional build arguments.

      Only allowed when directory is set.

      Default: - No additional build arguments

    • getDockerBuildSecrets

      @Stability(Stable) @Nullable default Map<String,String> getDockerBuildSecrets()
      Additional build secrets.

      Only allowed when directory is set.

      Default: - No additional build secrets

    • getDockerBuildSsh

      @Stability(Stable) @Nullable default String getDockerBuildSsh()
      SSH agent socket or keys.

      Requires building with docker buildkit.

      Default: - No ssh flag is set

    • getDockerBuildTarget

      @Stability(Stable) @Nullable default String getDockerBuildTarget()
      Target build stage in a Dockerfile with multiple build stages.

      Only allowed when directory is set.

      Default: - The last stage in the Dockerfile

    • getDockerFile

      @Stability(Stable) @Nullable default String getDockerFile()
      The name of the file with build instructions.

      Only allowed when directory is set.

      Default: "Dockerfile"

    • getDockerOutputs

      @Stability(Stable) @Nullable default List<String> getDockerOutputs()
      Outputs.

      Default: - no outputs are passed to the build command (default outputs are used)

      See Also:

    • getExecutable

      @Stability(Stable) @Nullable default List<String> getExecutable()
      A command-line executable that returns the name of a local Docker image on stdout after being run.

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

    • getNetworkMode

      @Stability(Stable) @Nullable default String getNetworkMode()
      Networking mode for the RUN commands during build. Requires Docker Engine API v1.25+.

      Specify this property to build images on a specific networking mode.

      Default: - no networking mode specified

    • getPlatform

      @Stability(Stable) @Nullable default String getPlatform()
      Platform to build for. Requires Docker Buildx.

      Specify this property to build images on a specific platform/architecture.

      Default: - current machine platform

    • builder

      @Stability(Stable) static DockerImageSource.Builder builder()
      Returns:
      a DockerImageSource.Builder of DockerImageSource