software.amazon.awscdk.services.lambda.go

Interface BundlingOptions

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

BundlingOptions.Jsii$Proxy

@Generated(value="jsii-pacmak/1.29.0 (build 41df200)",
           date="2021-05-10T21:38:05.067Z")
 @Stability(value=Experimental)
public interface BundlingOptions
extends software.amazon.jsii.JsiiSerializable

(experimental) Bundling options.

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 String	getAssetHash() (experimental) Specify a custom hash for this asset.
default AssetHashType	getAssetHashType() (experimental) Determines how the asset hash is calculated.
default Map<String,String>	getBuildArgs() (experimental) Build arguments to pass when building the bundling image.
default Boolean	getCgoEnabled() (experimental) Whether or not to enable cgo during go build.
default ICommandHooks	getCommandHooks() (experimental) Command hooks.
default DockerImage	getDockerImage() (experimental) A custom bundling Docker image.
default Map<String,String>	getEnvironment() (experimental) Environment variables defined when go runs.
default Boolean	getForcedDockerBundling() (experimental) Force bundling in a Docker container even if local bundling is possible.
default List<String>	getGoBuildFlags() (experimental) List of additional flags to use while building.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getAssetHash

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

(experimental) Specify a custom hash for this asset.

If assetHashType is set it must be set to AssetHashType.CUSTOM. For consistency, this custom hash will be SHA256 hashed and encoded as hex. The resulting hash will be the asset hash.

NOTE: the hash is used in order to identify a specific revision of the asset, and used for optimizing and caching deployment activities related to this asset such as packaging, uploading to Amazon S3, etc. If you chose to customize the hash, you will need to make sure it is updated every time the asset changes, or otherwise it is possible that some deployments will not be invalidated.

Default: - based on `assetHashType`

getAssetHashType

@Stability(value=Experimental)
 @Nullable
default AssetHashType getAssetHashType()

(experimental) Determines how the asset hash is calculated. Assets will get rebuilt and uploaded only if their hash has changed.

If the asset hash is set to OUTPUT (default), the hash is calculated after bundling. This means that any change in the output will cause the asset to be invalidated and uploaded. Bear in mind that the go binary that is output can be different depending on the environment that it was compiled in. If you want to control when the output is changed it is recommended that you use immutable build images such as public.ecr.aws/bitnami/golang:1.16.3-debian-10-r16.

If the asset hash is set to SOURCE, then only changes to the source directory will cause the asset to rebuild. If your go project has multiple Lambda functions this means that an update to any one function could cause all the functions to be rebuilt and uploaded.

Default: - AssetHashType.OUTPUT. If `assetHash` is also specified, the default is `CUSTOM`.

getBuildArgs

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

(experimental) Build arguments to pass when building the bundling image.

Default: - no build arguments are passed

getCgoEnabled

@Stability(value=Experimental)
 @Nullable
default Boolean getCgoEnabled()

(experimental) Whether or not to enable cgo during go build.

This will set the CGO_ENABLED environment variable

Default: - false

getCommandHooks

@Stability(value=Experimental)
 @Nullable
default ICommandHooks getCommandHooks()

(experimental) Command hooks.

Default: - do not run additional commands

getDockerImage

@Stability(value=Experimental)
 @Nullable
default DockerImage getDockerImage()

(experimental) A custom bundling Docker image.

Default: - use the Docker image provided by

getEnvironment

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

(experimental) Environment variables defined when go runs.

Default: - no environment variables are defined.

getForcedDockerBundling

@Stability(value=Experimental)
 @Nullable
default Boolean getForcedDockerBundling()

(experimental) Force bundling in a Docker container even if local bundling is possible.

Default: - false

getGoBuildFlags

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

(experimental) List of additional flags to use while building.

For example: ['ldflags "-s -w"']

Default: - none

builder

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

Returns:

a BundlingOptions.Builder of BundlingOptions