software.amazon.awscdk.core

Interface BundlingOptions

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

BundlingOptions.Jsii$Proxy

@Generated(value="jsii-pacmak/1.50.0 (build d1830a4)",
           date="2022-01-04T15:39:00.932Z")
 @Stability(value=Experimental)
public interface BundlingOptions
extends software.amazon.jsii.JsiiSerializable

(experimental) Bundling options.

Example:

 Function.Builder.create(this, "Function")
         .code(Code.fromAsset(join(__dirname, "my-python-handler"), AssetOptions.builder()
                 .bundling(BundlingOptions.builder()
                         .image(Runtime.PYTHON_3_9.getBundlingImage())
                         .command(List.of("bash", "-c", "pip install -r requirements.txt -t /asset-output && cp -au . /asset-output"))
                         .build())
                 .build()))
         .runtime(Runtime.PYTHON_3_9)
         .handler("index.handler")
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static BundlingOptions.Builder	builder()
default List<String>	getCommand() (experimental) The command to run in the Docker container.
default List<String>	getEntrypoint() (experimental) The entrypoint to run in the Docker container.
default Map<String,String>	getEnvironment() (experimental) The environment variables to pass to the Docker container.
DockerImage	getImage() (experimental) The Docker image where the command will run.
default ILocalBundling	getLocal() (experimental) Local bundling provider.
default BundlingOutput	getOutputType() (experimental) The type of output that this bundling operation is producing.
default String	getSecurityOpt() (experimental) [Security configuration](https://docs.docker.com/engine/reference/run/#security-configuration) when running the docker container.
default String	getUser() (experimental) The user to use when running the Docker container.
default List<DockerVolume>	getVolumes() (experimental) Additional Docker volumes to mount.
default String	getWorkingDirectory() (experimental) Working directory inside the Docker container.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getImage

@Stability(value=Experimental)
 @NotNull
DockerImage getImage()

(experimental) The Docker image where the command will run.

getCommand

@Stability(value=Experimental)
 @Nullable
default List<String> getCommand()

(experimental) The command to run in the Docker container.

Example value: ['npm', 'install']

Default: - run the command defined in the image

See Also:

https://docs.docker.com/engine/reference/run/

getEntrypoint

@Stability(value=Experimental)
 @Nullable
default List<String> getEntrypoint()

(experimental) The entrypoint to run in the Docker container.

Example value: ['/bin/sh', '-c']

Default: - run the entrypoint defined in the image

See Also:

https://docs.docker.com/engine/reference/builder/#entrypoint

getEnvironment

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

(experimental) The environment variables to pass to the Docker container.

Default: - no environment variables.

getLocal

@Stability(value=Experimental)
 @Nullable
default ILocalBundling getLocal()

(experimental) Local bundling provider.

The provider implements a method tryBundle() which should return true if local bundling was performed. If false is returned, docker bundling will be done.

Default: - bundling will only be performed in a Docker container

getOutputType

@Stability(value=Experimental)
 @Nullable
default BundlingOutput getOutputType()

(experimental) The type of output that this bundling operation is producing.

Default: BundlingOutput.AUTO_DISCOVER

getSecurityOpt

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

(experimental) [Security configuration](https://docs.docker.com/engine/reference/run/#security-configuration) when running the docker container.

Default: - no security options

getUser

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

(experimental) The user to use when running the Docker container.

user | user:group | uid | uid:gid | user:gid | uid:group

Default: - uid:gid of the current user or 1000:1000 on Windows

See Also:

https://docs.docker.com/engine/reference/run/#user

getVolumes

@Stability(value=Experimental)
 @Nullable
default List<DockerVolume> getVolumes()

(experimental) Additional Docker volumes to mount.

Default: - no additional volumes are mounted

getWorkingDirectory

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

(experimental) Working directory inside the Docker container.

Default: /asset-input

builder

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

Returns:

a BundlingOptions.Builder of BundlingOptions