# IBuildImage

Represents a Docker image used for the CodeBuild Project builds.

Use the concrete subclasses, either:
`LinuxBuildImage` or `WindowsBuildImage`.

Implemented by: [LinuxArmBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmBuildImage.html), [LinuxArmLambdaBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html), [LinuxBuildImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html), LinuxGpuBuildImage, LinuxLambdaBuildImage, MacBuildImage, WindowsBuildImage
Obtainable from: [LinuxArmBuildImage.AMAZON_LINUX_2023_STANDARD_2_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmBuildImage.html#amazon-linux-2023-standard-2-0), [LinuxArmBuildImage.AMAZON_LINUX_2023_STANDARD_3_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmBuildImage.html#amazon-linux-2023-standard-3-0), [LinuxArmBuildImage.AMAZON_LINUX_2023_STANDARD_4_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmBuildImage.html#amazon-linux-2023-standard-4-0), [LinuxArmBuildImage.AMAZON_LINUX_2_STANDARD_1_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmBuildImage.html#amazon-linux-2-standard-1-0), [LinuxArmBuildImage.AMAZON_LINUX_2_STANDARD_2_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmBuildImage.html#amazon-linux-2-standard-2-0), [LinuxArmBuildImage.AMAZON_LINUX_2_STANDARD_3_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmBuildImage.html#amazon-linux-2-standard-3-0), [LinuxArmBuildImage.fromCodeBuildImageId](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmBuildImage.html#fromcodebuildimageid), [LinuxArmBuildImage.fromDockerRegistry](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmBuildImage.html#fromdockerregistry), [LinuxArmBuildImage.fromEcrRepository](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmBuildImage.html#fromecrrepository), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2023_CORRETTO_21](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2023-corretto-21), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2023_DOTNET_8](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2023-dotnet-8), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2023_GO_1_24](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2023-go-1-24), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2023_NODE_20](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2023-node-20), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2023_NODE_22](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2023-node-22), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2023_NODE_24](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2023-node-24), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2023_PYTHON_3_12](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2023-python-3-12), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2023_PYTHON_3_13](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2023-python-3-13), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2023_RUBY_3_4](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2023-ruby-3-4), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2_CORRETTO_11](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2-corretto-11), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2_CORRETTO_17](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2-corretto-17), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2_DOTNET_6](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2-dotnet-6), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2_GO_1_21](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2-go-1-21), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2_NODE_18](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2-node-18), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2_PYTHON_3_11](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2-python-3-11), [LinuxArmLambdaBuildImage.AMAZON_LINUX_2_RUBY_3_2](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxArmLambdaBuildImage.html#amazon-linux-2-ruby-3-2), [LinuxBuildImage.AMAZON_LINUX_2](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2), [LinuxBuildImage.AMAZON_LINUX_2023_4](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2023-4), [LinuxBuildImage.AMAZON_LINUX_2023_5](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2023-5), [LinuxBuildImage.AMAZON_LINUX_2023_6](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2023-6), [LinuxBuildImage.AMAZON_LINUX_2023_CORETTO_11](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2023-coretto-11), [LinuxBuildImage.AMAZON_LINUX_2023_CORETTO_8](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2023-coretto-8), [LinuxBuildImage.AMAZON_LINUX_2_2](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2-2), [LinuxBuildImage.AMAZON_LINUX_2_3](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2-3), [LinuxBuildImage.AMAZON_LINUX_2_4](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2-4), [LinuxBuildImage.AMAZON_LINUX_2_5](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2-5), [LinuxBuildImage.AMAZON_LINUX_2_ARM](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2-arm), [LinuxBuildImage.AMAZON_LINUX_2_ARM_2](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2-arm-2), [LinuxBuildImage.AMAZON_LINUX_2_ARM_3](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2-arm-3), [LinuxBuildImage.AMAZON_LINUX_2_CORETTO_11](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2-coretto-11), [LinuxBuildImage.AMAZON_LINUX_2_CORETTO_8](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#amazon-linux-2-coretto-8), [LinuxBuildImage.STANDARD_1_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#standard-1-0), [LinuxBuildImage.STANDARD_2_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#standard-2-0), [LinuxBuildImage.STANDARD_3_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#standard-3-0), [LinuxBuildImage.STANDARD_4_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#standard-4-0), [LinuxBuildImage.STANDARD_5_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#standard-5-0), [LinuxBuildImage.STANDARD_6_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#standard-6-0), [LinuxBuildImage.STANDARD_7_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#standard-7-0), [LinuxBuildImage.STANDARD_8_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#standard-8-0), [LinuxBuildImage.fromAsset](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#fromasset), [LinuxBuildImage.fromCodeBuildImageId](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#fromcodebuildimageid), [LinuxBuildImage.fromDockerRegistry](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#fromdockerregistry), [LinuxBuildImage.fromEcrRepository](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxBuildImage.html#fromecrrepository), [LinuxGpuBuildImage.DLC_MXNET_1_4_1](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-mxnet-1-4-1), [LinuxGpuBuildImage.DLC_MXNET_1_6_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-mxnet-1-6-0), [LinuxGpuBuildImage.DLC_PYTORCH_1_2_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-pytorch-1-2-0), [LinuxGpuBuildImage.DLC_PYTORCH_1_3_1](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-pytorch-1-3-1), [LinuxGpuBuildImage.DLC_PYTORCH_1_4_0_INFERENCE](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-pytorch-1-4-0-inference), [LinuxGpuBuildImage.DLC_PYTORCH_1_4_0_TRAINING](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-pytorch-1-4-0-training), [LinuxGpuBuildImage.DLC_PYTORCH_1_5_0_INFERENCE](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-pytorch-1-5-0-inference), [LinuxGpuBuildImage.DLC_PYTORCH_1_5_0_TRAINING](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-pytorch-1-5-0-training), [LinuxGpuBuildImage.DLC_TENSORFLOW_1_14_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-tensorflow-1-14-0), [LinuxGpuBuildImage.DLC_TENSORFLOW_1_15_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-tensorflow-1-15-0), [LinuxGpuBuildImage.DLC_TENSORFLOW_1_15_2_INFERENCE](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-tensorflow-1-15-2-inference), [LinuxGpuBuildImage.DLC_TENSORFLOW_1_15_2_TRAINING](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-tensorflow-1-15-2-training), [LinuxGpuBuildImage.DLC_TENSORFLOW_2_0_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-tensorflow-2-0-0), [LinuxGpuBuildImage.DLC_TENSORFLOW_2_0_1](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-tensorflow-2-0-1), [LinuxGpuBuildImage.DLC_TENSORFLOW_2_1_0_INFERENCE](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-tensorflow-2-1-0-inference), [LinuxGpuBuildImage.DLC_TENSORFLOW_2_1_0_TRAINING](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-tensorflow-2-1-0-training), [LinuxGpuBuildImage.DLC_TENSORFLOW_2_2_0_TRAINING](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#dlc-tensorflow-2-2-0-training), [LinuxGpuBuildImage.awsDeepLearningContainersImage](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#awsdeeplearningcontainersimage), [LinuxGpuBuildImage.fromEcrRepository](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxGpuBuildImage.html#fromecrrepository), [LinuxLambdaBuildImage.AMAZON_LINUX_2023_CORRETTO_21](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2023-corretto-21), [LinuxLambdaBuildImage.AMAZON_LINUX_2023_DOTNET_8](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2023-dotnet-8), [LinuxLambdaBuildImage.AMAZON_LINUX_2023_GO_1_24](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2023-go-1-24), [LinuxLambdaBuildImage.AMAZON_LINUX_2023_NODE_20](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2023-node-20), [LinuxLambdaBuildImage.AMAZON_LINUX_2023_NODE_22](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2023-node-22), [LinuxLambdaBuildImage.AMAZON_LINUX_2023_NODE_24](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2023-node-24), [LinuxLambdaBuildImage.AMAZON_LINUX_2023_PYTHON_3_12](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2023-python-3-12), [LinuxLambdaBuildImage.AMAZON_LINUX_2023_PYTHON_3_13](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2023-python-3-13), [LinuxLambdaBuildImage.AMAZON_LINUX_2023_RUBY_3_4](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2023-ruby-3-4), [LinuxLambdaBuildImage.AMAZON_LINUX_2_CORRETTO_11](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2-corretto-11), [LinuxLambdaBuildImage.AMAZON_LINUX_2_CORRETTO_17](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2-corretto-17), [LinuxLambdaBuildImage.AMAZON_LINUX_2_DOTNET_6](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2-dotnet-6), [LinuxLambdaBuildImage.AMAZON_LINUX_2_GO_1_21](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2-go-1-21), [LinuxLambdaBuildImage.AMAZON_LINUX_2_NODE_18](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2-node-18), [LinuxLambdaBuildImage.AMAZON_LINUX_2_PYTHON_3_11](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2-python-3-11), [LinuxLambdaBuildImage.AMAZON_LINUX_2_RUBY_3_2](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.LinuxLambdaBuildImage.html#amazon-linux-2-ruby-3-2), [MacBuildImage.BASE_14](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.MacBuildImage.html#base-14), [MacBuildImage.BASE_15](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.MacBuildImage.html#base-15), [MacBuildImage.BASE_26](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.MacBuildImage.html#base-26), [MacBuildImage.fromAsset](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.MacBuildImage.html#fromasset), [MacBuildImage.fromDockerRegistry](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.MacBuildImage.html#fromdockerregistry), [MacBuildImage.fromEcrRepository](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.MacBuildImage.html#fromecrrepository), [WindowsBuildImage.WINDOWS_BASE_2_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.WindowsBuildImage.html#windows-base-2-0), [WindowsBuildImage.WIN_SERVER_CORE_2019_BASE](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.WindowsBuildImage.html#win-server-core-2019-base), [WindowsBuildImage.WIN_SERVER_CORE_2019_BASE_2_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.WindowsBuildImage.html#win-server-core-2019-base-2-0), [WindowsBuildImage.WIN_SERVER_CORE_2019_BASE_3_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.WindowsBuildImage.html#win-server-core-2019-base-3-0), [WindowsBuildImage.WIN_SERVER_CORE_2022_BASE_3_0](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.WindowsBuildImage.html#win-server-core-2022-base-3-0), [WindowsBuildImage.fromAsset](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.WindowsBuildImage.html#fromasset), [WindowsBuildImage.fromDockerRegistry](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.WindowsBuildImage.html#fromdockerregistry), [WindowsBuildImage.fromEcrRepository](/cdk/api/v2/docs/aws-cdk-lib.aws_codebuild.WindowsBuildImage.html#fromecrrepository)

- Source: [`aws-codebuild/lib/project.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/aws-cdk-lib/aws-codebuild/lib/project.ts#L1742)

## Properties

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

- `imageId`: string — 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.

  **Default:** ImagePullPrincipalType.SERVICE_ROLE

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

  **Default:** no repository

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

  **Default:** no credentials will be used

- `type`: string — The type of build environment.

## Methods

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

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

  **Parameters**

  - `buildEnvironment` — the current build environment.
