software.amazon.awscdk.services.codebuild

Class WindowsBuildImage

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.codebuild.WindowsBuildImage

All Implemented Interfaces:

IBuildImage, software.amazon.jsii.JsiiSerializable

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

(experimental) A CodeBuild image running Windows.

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:

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

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	WIN_SERVER_CORE_2019_BASE (experimental) The standard CodeBuild image `aws/codebuild/windows-base:2019-1.0`, which is based off Windows Server Core 2019.
static IBuildImage	WINDOWS_BASE_2_0 (experimental) The standard CodeBuild image `aws/codebuild/windows-base:2.0`, which is based off Windows Server Core 2016.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	WindowsBuildImage(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	WindowsBuildImage(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 Windows build image.
static IBuildImage	fromAsset(software.constructs.Construct scope, String id, DockerImageAssetProps props, WindowsImageType imageType) (experimental) Uses an Docker image asset as a Windows build image.
static IBuildImage	fromDockerRegistry(String name)
static IBuildImage	fromDockerRegistry(String name, DockerImageOptions options)
static IBuildImage	fromDockerRegistry(String name, DockerImageOptions options, WindowsImageType imageType)
static IBuildImage	fromEcrRepository(IRepository repository)
static IBuildImage	fromEcrRepository(IRepository repository, String tag)
static IBuildImage	fromEcrRepository(IRepository repository, String tag, WindowsImageType imageType)
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 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

WIN_SERVER_CORE_2019_BASE

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

(experimental) The standard CodeBuild image `aws/codebuild/windows-base:2019-1.0`, which is based off Windows Server Core 2019.

WINDOWS_BASE_2_0

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

(experimental) The standard CodeBuild image `aws/codebuild/windows-base:2.0`, which is based off Windows Server Core 2016.

Constructor Detail

WindowsBuildImage

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

WindowsBuildImage

protected WindowsBuildImage(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,
                                                                             @Nullable
                                                                             WindowsImageType imageType)

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

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

imageType -

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 Windows build image.

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

fromDockerRegistry

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

Parameters:

name - This parameter is required.

options -

imageType -

Returns:

a Windows build image from a Docker Hub image.

fromDockerRegistry

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

Parameters:

name - This parameter is required.

options -

Returns:

a Windows 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 Windows build image from a Docker Hub image.

fromEcrRepository

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

Parameters:

repository - The ECR repository. This parameter is required.

tag - Image tag (default "latest").

imageType -

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,
                                                                                     @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 buildEnvironment)

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

Specified by:

validate in interface IBuildImage

Parameters:

buildEnvironment - 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