# LinuxBuildImage

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)

Extends: LinuxBuildImage
Implements: IBuildImage

- Source: [`aws-codebuild/lib/project.ts`](https://github.com/aws/aws-cdk/blob/v2.274.0/packages/aws-cdk-lib/aws-codebuild/lib/project.ts#L1856)
- Type last changed: v2.274.0 · 20 Oct 2026

## Example

```ts
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', // Created using the AWS console * });',
    }),
    commands: ['npm ci', 'npm run build', 'npx cdk synth'],
  }),

  // Turn this on because the pipeline uses Docker image assets
  dockerEnabledForSelfMutation: true,
});

pipeline.addWave('MyWave', {
  post: [
    new pipelines.CodeBuildStep('RunApproval', {
      commands: ['command-from-image'],
      buildEnvironment: {
        // The user of a Docker image asset in the pipeline requires turning on
        // 'dockerEnabledForSelfMutation'.
        buildImage: codebuild.LinuxBuildImage.fromAsset(this, 'Image', {
          directory: './docker-image',
        }),
      },
    }),
  ],
});
```

## Properties

- `AMAZON_LINUX_2`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — Use {@link LinuxBuildImage.AMAZON_LINUX_2_5 } instead.

- `AMAZON_LINUX_2_2`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — Use {@link LinuxBuildImage.AMAZON_LINUX_2_5 } instead.

- `AMAZON_LINUX_2_3`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — Use {@link LinuxBuildImage.AMAZON_LINUX_2_5 } instead.

- `AMAZON_LINUX_2_4`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — The Amazon Linux 2 x86_64 standard image, version `4.0`.

- `AMAZON_LINUX_2_5`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — The Amazon Linux 2023 x86_64 standard image, version `5.0`.

- `AMAZON_LINUX_2_ARM`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — Use {@link LinuxArmBuildImage.AMAZON_LINUX_2_ARM_3 } instead.

- `AMAZON_LINUX_2_ARM_2`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — Image "aws/codebuild/amazonlinux2-aarch64-standard:2.0".

- `AMAZON_LINUX_2_ARM_3`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — Image "aws/codebuild/amazonlinux2-aarch64-standard:3.0".

- `AMAZON_LINUX_2_CORETTO_11`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — The Amazon Coretto 11 image x86_64, based on Amazon Linux 2.

- `AMAZON_LINUX_2_CORETTO_8`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — The Amazon Coretto 8 image x86_64, based on Amazon Linux 2.

- `AMAZON_LINUX_2023_4`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — The Amazon Linux 2023 x86_64 standard image, version `4.0`.

- `AMAZON_LINUX_2023_5`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — The Amazon Linux 2023 x86_64 standard image, version `5.0`.

- `AMAZON_LINUX_2023_6`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — The Amazon Linux 2023 x86_64 standard image, version `6.0`.

- `AMAZON_LINUX_2023_CORETTO_11`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — The Amazon Coretto 11 image x86_64, based on Amazon Linux 2023.

- `AMAZON_LINUX_2023_CORETTO_8`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — The Amazon Coretto 8 image x86_64, based on Amazon Linux 2023.

- `defaultComputeType`: [ComputeType](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.ComputeType.html) (required) — The default `ComputeType` to use with this image, if one was not specified in `BuildEnvironment#computeType` explicitly.

- `imageId`: string (required) — The Docker image identifier that the build environment uses.

- `imagePullPrincipalType`: [ImagePullPrincipalType](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.ImagePullPrincipalType.html) — The type of principal that CodeBuild will use to pull this build Docker image.

- `repository`: [IRepository](/cdk/api/v2/docs/aws-cdk-lib.aws_ecr.IRepository.html) — An optional ECR repository that the image is hosted in.

- `secretsManagerCredentials`: [ISecret](/cdk/api/v2/docs/aws-cdk-lib.aws_secretsmanager.ISecret.html) — The secretsManagerCredentials for access to a private registry.

- `STANDARD_1_0`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — Use {@link LinuxBuildImage.STANDARD_7_0 } instead.

- `STANDARD_2_0`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — Use {@link LinuxBuildImage.STANDARD_7_0 } instead.

- `STANDARD_3_0`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — Use {@link LinuxBuildImage.STANDARD_7_0 } instead.

- `STANDARD_4_0`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — Use {@link LinuxBuildImage.STANDARD_7_0 } instead.

- `STANDARD_5_0`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — The `aws/codebuild/standard:5.0` build image.

- `STANDARD_6_0`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — The `aws/codebuild/standard:6.0` build image.

- `STANDARD_7_0`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — The `aws/codebuild/standard:7.0` build image.

- `STANDARD_8_0`: [IBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.IBuildImage.html) (required) (static) — The `aws/codebuild/standard:8.0` build image.

- `type`: string (required) — The type of build environment.

## Methods

- `fromAsset(scope: Construct, id: string, props: DockerImageAssetProps): IBuildImage` (static) — Uses an Docker image asset as a x86-64 Linux build image.

- `fromCodeBuildImageId(id: string): IBuildImage` (static) — Uses a Docker image provided by CodeBuild.

  **Parameters**

  - `id` — The image identifier.

  **Returns:** A Docker image provided by CodeBuild.

  ```ts
  'aws/codebuild/standard:4.0'
  ```

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

  **Returns:** a x86-64 Linux build image from a Docker Hub image.

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

  **Parameters**

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

  **Returns:** A x86-64 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.

- `runScriptBuildspec(entrypoint: string): BuildSpec` — Make a buildspec to run the indicated script.

- `validate(env: BuildEnvironment): string[]` — Allows the image a chance to validate whether the passed configuration is correct.