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.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:37.369Z")
 @Stability(value=Stable)
public class WindowsBuildImage
extends software.amazon.jsii.JsiiObject
implements IBuildImage

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])

Example:

 Repository ecrRepository;
 Project.Builder.create(this, "Project")
         .environment(BuildEnvironment.builder()
                 .buildImage(WindowsBuildImage.fromEcrRepository(ecrRepository, "v1.0", WindowsImageType.SERVER_2019))
                 // optional certificate to include in the build image
                 .certificate(BuildEnvironmentCertificate.builder()
                         .bucket(Bucket.fromBucketName(this, "Bucket", "my-bucket"))
                         .objectKey("path/to/cert.pem")
                         .build())
                 .build())
         .build();
 

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 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 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) Uses an Docker image asset as a Windows build image.
static IBuildImage	fromAsset(software.constructs.Construct scope, String id, DockerImageAssetProps props, WindowsImageType imageType) 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 tagOrDigest)
static IBuildImage	fromEcrRepository(IRepository repository, String tagOrDigest, WindowsImageType imageType)
ComputeType	getDefaultComputeType() The default ComputeType to use with this image, if one was not specified in BuildEnvironment#computeType explicitly.
String	getImageId() The Docker image identifier that the build environment uses.
ImagePullPrincipalType	getImagePullPrincipalType() The type of principal that CodeBuild will use to pull this build Docker image.
IRepository	getRepository() An optional ECR repository that the image is hosted in.
ISecret	getSecretsManagerCredentials() The secretsManagerCredentials for access to a private registry.
String	getType() The type of build environment.
BuildSpec	runScriptBuildspec(String entrypoint) Make a buildspec to run the indicated script.
List<String>	validate(BuildEnvironment buildEnvironment) 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=Stable)
public static final IBuildImage WIN_SERVER_CORE_2019_BASE

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=Stable)
public static final IBuildImage WINDOWS_BASE_2_0

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=Stable)
 @NotNull
public static IBuildImage fromAsset(@NotNull
                                                                       software.constructs.Construct scope,
                                                                       @NotNull
                                                                       String id,
                                                                       @NotNull
                                                                       DockerImageAssetProps props,
                                                                       @Nullable
                                                                       WindowsImageType imageType)

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=Stable)
 @NotNull
public static IBuildImage fromAsset(@NotNull
                                                                       software.constructs.Construct scope,
                                                                       @NotNull
                                                                       String id,
                                                                       @NotNull
                                                                       DockerImageAssetProps props)

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=Stable)
 @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=Stable)
 @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=Stable)
 @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=Stable)
 @NotNull
public static IBuildImage fromEcrRepository(@NotNull
                                                                               IRepository repository,
                                                                               @Nullable
                                                                               String tagOrDigest,
                                                                               @Nullable
                                                                               WindowsImageType imageType)

Parameters:

repository - The ECR repository. This parameter is required.

tagOrDigest - Image tag or digest (default "latest", digests must start with `sha256:`).

imageType -

Returns:

A Windows 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=Stable)
 @NotNull
public static IBuildImage fromEcrRepository(@NotNull
                                                                               IRepository repository,
                                                                               @Nullable
                                                                               String tagOrDigest)

Parameters:

repository - The ECR repository. This parameter is required.

tagOrDigest - Image tag or digest (default "latest", digests must start with `sha256:`).

Returns:

A Windows 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=Stable)
 @NotNull
public static IBuildImage fromEcrRepository(@NotNull
                                                                               IRepository repository)

Parameters:

repository - The ECR repository. This parameter is required.

Returns:

A Windows 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=Stable)
 @NotNull
public BuildSpec runScriptBuildspec(@NotNull
                                                                       String entrypoint)

Make a buildspec to run the indicated script.

Specified by:

runScriptBuildspec in interface IBuildImage

Parameters:

entrypoint - This parameter is required.

validate

@Stability(value=Stable)
 @NotNull
public List<String> validate(@NotNull
                                                                BuildEnvironment buildEnvironment)

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=Stable)
 @NotNull
public ComputeType getDefaultComputeType()

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=Stable)
 @NotNull
public String getImageId()

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=Stable)
 @NotNull
public String getType()

The type of build environment.

Specified by:

getType in interface IBuildImage

getImagePullPrincipalType

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

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

Specified by:

getImagePullPrincipalType in interface IBuildImage

getRepository

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

An optional ECR repository that the image is hosted in.

Specified by:

getRepository in interface IBuildImage

getSecretsManagerCredentials

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

The secretsManagerCredentials for access to a private registry.

Specified by:

getSecretsManagerCredentials in interface IBuildImage