- All Superinterfaces:
- All Known Implementing Classes:
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
Method SummaryModifier and TypeMethodDescription
default String(experimental) Specify a custom hash for this asset.
default AssetHashType(experimental) Determines how asset hash is calculated.(experimental) Optional build arguments to pass to the default container.(experimental) Environment variables defined when bundling runs.
getImage()(experimental) Docker image to use for bundling.
default String(experimental) Output path suffix: the suffix for the directory into which the bundled output is written.
Methods inherited from interface software.amazon.jsii.JsiiSerializable
getAssetHash@Stability(Experimental) @Nullable default String getAssetHash()(experimental) Specify a custom hash for this asset.
assetHashTypeis 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(Experimental) @Nullable default AssetHashType getAssetHashType()(experimental) Determines how asset hash is calculated. Assets will get rebuild and uploaded only if their hash has changed.
If asset hash is set to
SOURCE(default), then only changes to the source directory will cause the asset to rebuild. This means, for example, that in order to pick up a new dependency version, a change must be made to the source tree. Ideally, this can be implemented by including a dependency lockfile in your source tree or using fixed dependencies.
If the asset hash is set to
OUTPUT, 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
pipadds timestamps to dependencies it installs, which implies that in this mode Python bundles will always get rebuild and uploaded. Normally this is an anti-pattern since build
Default: AssetHashType.SOURCE By default, hash is calculated based on the contents of the source directory. This means that only updates to the source will cause the asset to rebuild.
getBuildArgs(experimental) Optional build arguments to pass to the default container.
This can be used to customize the index URLs used for installing dependencies. This is not used if a custom image is provided.
Default: - No build arguments.
getEnvironment(experimental) Environment variables defined when bundling runs.
Default: - no environment variables are defined.
getImage@Stability(Experimental) @Nullable default DockerImage getImage()(experimental) Docker image to use for bundling.
If no options are provided, the default bundling image will be used. Dependencies will be installed using the default packaging commands and copied over from into the Lambda asset.
Default: - Default bundling image.
getOutputPathSuffix@Stability(Experimental) @Nullable default String getOutputPathSuffix()(experimental) Output path suffix: the suffix for the directory into which the bundled output is written.
Default: - 'python' for a layer, empty string otherwise.
builder@Stability(Experimental) static BundlingOptions.Builder builder()