Implements IBuildImage

A CodeBuild image running x86-64 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

const pipeline = new pipelines.CodePipeline(this, 'Pipeline', {
  synth: new pipelines.ShellStep('Synth', {
    input: pipelines.CodePipelineSource.connection('my-org/my-app', 'main', {
      connectionArn:
        'arn:aws:codestar-connections:us-east-1:222222222222:connection/7d2469ff-514a-4e4f-9003-5ca4a43cdc41', 
    }),
    commands: ['npm ci', 'npm run build', 'npx cdk synth'],
  }),

  
  dockerEnabledForSelfMutation: true,
});

pipeline.addWave('MyWave', {
  post: [
    new pipelines.CodeBuildStep('RunApproval', {
      commands: ['command-from-image'],
      buildEnvironment: {
        
        
        buildImage: codebuild.LinuxBuildImage.fromAsset(this, 'Image', {
          directory: './docker-image',
        }),
      },
    }),
  ],
});

Type: ComputeType

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

Type: string

The Docker image identifier that the build environment uses.

Type: string

The type of build environment.

Type: ImagePullPrincipalType (optional)

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

Type: IRepository (optional)

An optional ECR repository that the image is hosted in.

Type: ISecret (optional)

The secretsManagerCredentials for access to a private registry.

⚠️ Deprecated: Use {@link LinuxBuildImage.AMAZON_LINUX_2_5 } instead.

Type: IBuildImage

Type: IBuildImage

The Amazon Linux 2023 x86_64 standard image, version 4.0.

Type: IBuildImage

The Amazon Linux 2023 x86_64 standard image, version 5.0.

Type: IBuildImage

The Amazon Coretto 11 image x86_64, based on Amazon Linux 2023.

Type: IBuildImage

The Amazon Coretto 8 image x86_64, based on Amazon Linux 2023.

⚠️ Deprecated: Use {@link LinuxBuildImage.AMAZON_LINUX_2_5 } instead.

Type: IBuildImage

⚠️ Deprecated: Use {@link LinuxBuildImage.AMAZON_LINUX_2_5 } instead.

Type: IBuildImage

The Amazon Linux 2 x86_64 standard image, version 3.0.

Type: IBuildImage

The Amazon Linux 2 x86_64 standard image, version 4.0.

Type: IBuildImage

The Amazon Linux 2023 x86_64 standard image, version 5.0.

⚠️ Deprecated: Use {@link LinuxArmBuildImage.AMAZON_LINUX_2_ARM_3 } instead.

Type: IBuildImage

Image "aws/codebuild/amazonlinux2-aarch64-standard:1.0".

See also: {LinuxArmBuildImage.AMAZON_LINUX_2_STANDARD_1_0}

Type: IBuildImage

Image "aws/codebuild/amazonlinux2-aarch64-standard:2.0".

See also: {LinuxArmBuildImage.AMAZON_LINUX_2_STANDARD_2_0}

Type: IBuildImage

Image "aws/codebuild/amazonlinux2-aarch64-standard:3.0".

See also: {LinuxArmBuildImage.AMAZON_LINUX_2_STANDARD_3_0}

Type: IBuildImage

The Amazon Coretto 11 image x86_64, based on Amazon Linux 2.

Type: IBuildImage

The Amazon Coretto 8 image x86_64, based on Amazon Linux 2.

⚠️ Deprecated: Use {@link LinuxBuildImage.STANDARD_7_0 } instead.

Type: IBuildImage

⚠️ Deprecated: Use {@link LinuxBuildImage.STANDARD_7_0 } instead.

Type: IBuildImage

⚠️ Deprecated: Use {@link LinuxBuildImage.STANDARD_7_0 } instead.

Type: IBuildImage

⚠️ Deprecated: Use {@link LinuxBuildImage.STANDARD_7_0 } instead.

Type: IBuildImage

The aws/codebuild/standard:4.0 build image.

Type: IBuildImage

The aws/codebuild/standard:5.0 build image.

Type: IBuildImage

The aws/codebuild/standard:6.0 build image.

Type: IBuildImage

The aws/codebuild/standard:7.0 build image.

public runScriptBuildspec(entrypoint: string): BuildSpec

Parameters

• entrypoint string

Returns

• BuildSpec

Make a buildspec to run the indicated script.

public validate(env: BuildEnvironment): string[]

Parameters

• env BuildEnvironment

Returns

• string[]

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

public static fromAsset(scope: Construct, id: string, props: DockerImageAssetProps): IBuildImage

Parameters

• scope Construct
• id string
• props DockerImageAssetProps

Returns

• IBuildImage

Uses an Docker image asset as a x86-64 Linux build image.

public static fromCodeBuildImageId(id: string): IBuildImage

Parameters

• id string — The image identifier.

Returns

• IBuildImage

Uses a Docker image provided by CodeBuild.

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

'aws/codebuild/standard:4.0'

public static fromDockerRegistry(name: string, options?: DockerImageOptions): IBuildImage

Parameters

• name string
• options DockerImageOptions

Returns

• IBuildImage

public static fromEcrRepository(repository: IRepository, tagOrDigest?: string): IBuildImage

Parameters

• repository IRepository — The ECR repository.
• tagOrDigest string — Image tag or digest (default "latest", digests must start with sha256:).

Returns

• IBuildImage

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