software.amazon.awscdk.core

Class DockerImage

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.core.BundlingDockerImage

software.amazon.awscdk.core.DockerImage

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.50.0 (build d1830a4)",
           date="2022-01-04T15:39:01.092Z")
 @Stability(value=Experimental)
public class DockerImage
extends BundlingDockerImage

(experimental) A Docker image.

Example:

 String entry = "/path/to/function";
 DockerImage image = DockerImage.fromBuild(entry);
 PythonFunction.Builder.create(this, "function")
         .entry(entry)
         .runtime(Runtime.PYTHON_3_8)
         .bundling(BundlingOptions.builder()
                 .buildArgs(Map.of("PIP_INDEX_URL", "https://your.index.url/simple/", "PIP_EXTRA_INDEX_URL", "https://your.extra-index.url/simple/"))
                 .build())
         .build();
 

Nested Class Summary

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DockerImage(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	DockerImage(software.amazon.jsii.JsiiObjectRef objRef)
	DockerImage(String image)
	DockerImage(String image, String _imageHash)

Method Summary

Modifier and Type	Method and Description
String	cp(String imagePath) (experimental) Copies a file or directory out of the Docker image to the local filesystem.
String	cp(String imagePath, String outputPath) (experimental) Copies a file or directory out of the Docker image to the local filesystem.
static DockerImage	fromBuild(String path) (experimental) Builds a Docker image.
static DockerImage	fromBuild(String path, DockerBuildOptions options) (experimental) Builds a Docker image.
static DockerImage	fromRegistry(String image) (experimental) Reference an image on DockerHub or another online registry.
String	getImage() (experimental) The Docker image.
void	run() (experimental) Runs a Docker image.
void	run(DockerRunOptions options) (experimental) Runs a Docker image.
String	toJSON() (experimental) Provides a stable representation of this image for JSON serialization.

Methods inherited from class software.amazon.awscdk.core.BundlingDockerImage

fromAsset, fromAsset

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

DockerImage

protected DockerImage(software.amazon.jsii.JsiiObjectRef objRef)

DockerImage

protected DockerImage(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

DockerImage

@Stability(value=Experimental)
public DockerImage(@NotNull
                                                  String image,
                                                  @Nullable
                                                  String _imageHash)

Parameters:

image - This parameter is required.

_imageHash -

DockerImage

@Stability(value=Experimental)
public DockerImage(@NotNull
                                                  String image)

Parameters:

image - This parameter is required.

Method Detail

fromBuild

@Stability(value=Experimental)
 @NotNull
public static DockerImage fromBuild(@NotNull
                                                                             String path,
                                                                             @Nullable
                                                                             DockerBuildOptions options)

(experimental) Builds a Docker image.

Parameters:

path - The path to the directory containing the Docker file. This parameter is required.

options - Docker build options.

fromBuild

@Stability(value=Experimental)
 @NotNull
public static DockerImage fromBuild(@NotNull
                                                                             String path)

(experimental) Builds a Docker image.

Parameters:

path - The path to the directory containing the Docker file. This parameter is required.

fromRegistry

@Stability(value=Experimental)
 @NotNull
public static DockerImage fromRegistry(@NotNull
                                                                                String image)

(experimental) Reference an image on DockerHub or another online registry.

Parameters:

image - the image name. This parameter is required.

cp

@Stability(value=Experimental)
 @NotNull
public String cp(@NotNull
                                                          String imagePath,
                                                          @Nullable
                                                          String outputPath)

(experimental) Copies a file or directory out of the Docker image to the local filesystem.

If outputPath is omitted the destination path is a temporary directory.

Overrides:

cp in class BundlingDockerImage

Parameters:

imagePath - the path in the Docker image. This parameter is required.

outputPath - the destination path for the copy operation.

Returns:

the destination path

cp

@Stability(value=Experimental)
 @NotNull
public String cp(@NotNull
                                                          String imagePath)

(experimental) Copies a file or directory out of the Docker image to the local filesystem.

If outputPath is omitted the destination path is a temporary directory.

Overrides:

cp in class BundlingDockerImage

Parameters:

imagePath - the path in the Docker image. This parameter is required.

Returns:

the destination path

run

@Stability(value=Experimental)
public void run(@Nullable
                                               DockerRunOptions options)

(experimental) Runs a Docker image.

Overrides:

run in class BundlingDockerImage

Parameters:

options -

run

@Stability(value=Experimental)
public void run()

(experimental) Runs a Docker image.

Overrides:

run in class BundlingDockerImage

toJSON

@Stability(value=Experimental)
 @NotNull
public String toJSON()

(experimental) Provides a stable representation of this image for JSON serialization.

Overrides:

toJSON in class BundlingDockerImage

Returns:

The overridden image name if set or image hash name in that order

getImage

@Stability(value=Experimental)
 @NotNull
public String getImage()

(experimental) The Docker image.

Overrides:

getImage in class BundlingDockerImage