software.amazon.awscdk.services.codebuild

Class LinuxBuildImage

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.codebuild.LinuxBuildImage

All Implemented Interfaces:

IBuildImage, software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.30.0 (build adae23f)",
           date="2021-06-30T10:00:55.964Z")
 @Stability(value=Experimental)
public class LinuxBuildImage
extends software.amazon.jsii.JsiiObject
implements IBuildImage

(experimental) A CodeBuild image running Linux.

This class has a bunch of public constants that represent the most popular images.

You can also specify a custom image using one of the static methods:

• LinuxBuildImage.fromDockerRegistry(image[, { secretsManagerCredentials }])
• LinuxBuildImage.fromEcrRepository(repo[, tag])
• LinuxBuildImage.fromAsset(parent, id, props)

See Also:

https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-available.html

Nested Class Summary

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

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.codebuild.IBuildImage

IBuildImage.Jsii$Default, IBuildImage.Jsii$Proxy

Field Summary

Fields

Modifier and Type	Field and Description
static IBuildImage	AMAZON_LINUX_2
static IBuildImage	AMAZON_LINUX_2_2
static IBuildImage	AMAZON_LINUX_2_3 (experimental) The Amazon Linux 2 x86_64 standard image, version `3.0`.
static IBuildImage	AMAZON_LINUX_2_ARM
static IBuildImage	STANDARD_1_0
static IBuildImage	STANDARD_2_0
static IBuildImage	STANDARD_3_0
static IBuildImage	STANDARD_4_0 (experimental) The `aws/codebuild/standard:4.0` build image.
static IBuildImage	STANDARD_5_0 (experimental) The `aws/codebuild/standard:5.0` build image.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LinuxBuildImage(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	LinuxBuildImage(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
static IBuildImage	fromAsset(software.constructs.Construct scope, String id, DockerImageAssetProps props) (experimental) Uses an Docker image asset as a Linux build image.
static IBuildImage	fromCodeBuildImageId(String id) (experimental) Uses a Docker image provided by CodeBuild.
static IBuildImage	fromDockerRegistry(String name)
static IBuildImage	fromDockerRegistry(String name, DockerImageOptions options)
static IBuildImage	fromEcrRepository(IRepository repository)
static IBuildImage	fromEcrRepository(IRepository repository, String tag)
ComputeType	getDefaultComputeType() (experimental) The default ComputeType to use with this image, if one was not specified in BuildEnvironment#computeType explicitly.
String	getImageId() (experimental) The Docker image identifier that the build environment uses.
ImagePullPrincipalType	getImagePullPrincipalType() (experimental) The type of principal that CodeBuild will use to pull this build Docker image.
IRepository	getRepository() (experimental) An optional ECR repository that the image is hosted in.
ISecret	getSecretsManagerCredentials() (experimental) The secretsManagerCredentials for access to a private registry.
String	getType() (experimental) The type of build environment.
BuildSpec	runScriptBuildspec(String entrypoint) (experimental) Make a buildspec to run the indicated script.
List<String>	validate(BuildEnvironment _) (experimental) Allows the image a chance to validate whether the passed configuration is correct.

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

Field Detail

AMAZON_LINUX_2

@Stability(value=Experimental)
public static final IBuildImage AMAZON_LINUX_2

AMAZON_LINUX_2_2

@Stability(value=Experimental)
public static final IBuildImage AMAZON_LINUX_2_2

AMAZON_LINUX_2_3

@Stability(value=Experimental)
public static final IBuildImage AMAZON_LINUX_2_3

(experimental) The Amazon Linux 2 x86_64 standard image, version `3.0`.

AMAZON_LINUX_2_ARM

@Stability(value=Experimental)
public static final IBuildImage AMAZON_LINUX_2_ARM

STANDARD_1_0

@Stability(value=Experimental)
public static final IBuildImage STANDARD_1_0

STANDARD_2_0

@Stability(value=Experimental)
public static final IBuildImage STANDARD_2_0

STANDARD_3_0

@Stability(value=Experimental)
public static final IBuildImage STANDARD_3_0

STANDARD_4_0

@Stability(value=Experimental)
public static final IBuildImage STANDARD_4_0

(experimental) The `aws/codebuild/standard:4.0` build image.

STANDARD_5_0

@Stability(value=Experimental)
public static final IBuildImage STANDARD_5_0

(experimental) The `aws/codebuild/standard:5.0` build image.

Constructor Detail

LinuxBuildImage

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

LinuxBuildImage

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

Method Detail

fromAsset

@Stability(value=Experimental)
 @NotNull
public static IBuildImage fromAsset(@NotNull
                                                                             software.constructs.Construct scope,
                                                                             @NotNull
                                                                             String id,
                                                                             @NotNull
                                                                             DockerImageAssetProps props)

(experimental) Uses an Docker image asset as a Linux build image.

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

fromCodeBuildImageId

@Stability(value=Experimental)
 @NotNull
public static IBuildImage fromCodeBuildImageId(@NotNull
                                                                                        String id)

(experimental) Uses a Docker image provided by CodeBuild.

Example:

 // Example automatically generated without compilation. See https://github.com/aws/jsii/issues/826
 "aws/codebuild/standard:4.0";

Parameters:

id - The image identifier. This parameter is required.

Returns:

A Docker image provided by CodeBuild.

See Also:

https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-available.html

fromDockerRegistry

@Stability(value=Experimental)
 @NotNull
public static IBuildImage fromDockerRegistry(@NotNull
                                                                                      String name,
                                                                                      @Nullable
                                                                                      DockerImageOptions options)

Parameters:

name - This parameter is required.

options -

Returns:

a Linux build image from a Docker Hub image.

fromDockerRegistry

@Stability(value=Experimental)
 @NotNull
public static IBuildImage fromDockerRegistry(@NotNull
                                                                                      String name)

Parameters:

name - This parameter is required.

Returns:

a Linux build image from a Docker Hub image.

fromEcrRepository

@Stability(value=Experimental)
 @NotNull
public static IBuildImage fromEcrRepository(@NotNull
                                                                                     IRepository repository,
                                                                                     @Nullable
                                                                                     String tag)

Parameters:

repository - The ECR repository. This parameter is required.

tag - Image tag (default "latest").

Returns:

A Linux build image from an ECR repository. NOTE: if the repository is external (i.e. imported), then we won't be able to add a resource policy statement for it so CodeBuild can pull the image.

See Also:

https://docs.aws.amazon.com/codebuild/latest/userguide/sample-ecr.html

fromEcrRepository

@Stability(value=Experimental)
 @NotNull
public static IBuildImage fromEcrRepository(@NotNull
                                                                                     IRepository repository)

Parameters:

repository - The ECR repository. This parameter is required.

Returns:

A Linux build image from an ECR repository. NOTE: if the repository is external (i.e. imported), then we won't be able to add a resource policy statement for it so CodeBuild can pull the image.

See Also:

https://docs.aws.amazon.com/codebuild/latest/userguide/sample-ecr.html

runScriptBuildspec

@Stability(value=Experimental)
 @NotNull
public BuildSpec runScriptBuildspec(@NotNull
                                                                             String entrypoint)

(experimental) Make a buildspec to run the indicated script.

Specified by:

runScriptBuildspec in interface IBuildImage

Parameters:

entrypoint - This parameter is required.

validate

@Stability(value=Experimental)
 @NotNull
public List<String> validate(@NotNull
                                                                      BuildEnvironment _)

(experimental) Allows the image a chance to validate whether the passed configuration is correct.

Specified by:

validate in interface IBuildImage

Parameters:

_ - This parameter is required.

getDefaultComputeType

@Stability(value=Experimental)
 @NotNull
public ComputeType getDefaultComputeType()

(experimental) The default ComputeType to use with this image, if one was not specified in BuildEnvironment#computeType explicitly.

Specified by:

getDefaultComputeType in interface IBuildImage

getImageId

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

(experimental) The Docker image identifier that the build environment uses.

Specified by:

getImageId in interface IBuildImage

See Also:

https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-available.html

getType

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

(experimental) The type of build environment.

Specified by:

getType in interface IBuildImage

getImagePullPrincipalType

@Stability(value=Experimental)
 @Nullable
public ImagePullPrincipalType getImagePullPrincipalType()

(experimental) The type of principal that CodeBuild will use to pull this build Docker image.

Specified by:

getImagePullPrincipalType in interface IBuildImage

getRepository

@Stability(value=Experimental)
 @Nullable
public IRepository getRepository()

(experimental) An optional ECR repository that the image is hosted in.

Specified by:

getRepository in interface IBuildImage

getSecretsManagerCredentials

@Stability(value=Experimental)
 @Nullable
public ISecret getSecretsManagerCredentials()

(experimental) The secretsManagerCredentials for access to a private registry.

Specified by:

getSecretsManagerCredentials in interface IBuildImage