Docker images provided by CodeBuild
A supported image is the latest major version of an image available in CodeBuild and is updated with
minor and patch version updates. CodeBuild optimizes the provisioning duration of builds with supported images by caching them in the machine's
Amazon Machine Images (AMI). If you want to benefit from caching and minimize the provisioning duration of your build,
select Always use the latest image for this runtime version in the Image version section of the CodeBuild console instead of a more granular version, such as
aws/codebuild/amazonlinux2-x86_64-standard:4.0-1.0.0
.
CodeBuild frequently updates the list of Docker images to add the latest images and deprecate old images. To get the most current list, do one of the following:
-
In the CodeBuild console, in the Create build project wizard or Edit Build Project page, for Environment image, choose Managed image. Choose from the Operating system, Runtime, and Runtime version drop-down lists. For more information, see Create a build project (console) or Change a build project's settings (console).
-
For the AWS CLI, run the
list-curated-environment-images
command:aws codebuild list-curated-environment-images
-
For the AWS SDKs, call the
ListCuratedEnvironmentImages
operation for your target programming language. For more information, see the AWS SDKs and tools reference.
The base image of the Windows Server Core 2019 platform is only available in the following regions:
-
US East (N. Virginia)
-
US East (Ohio)
-
US West (Oregon)
-
Europe (Ireland)
EC2 compute images
AWS CodeBuild supports the following Docker images that are available for EC2 compute in CodeBuild.
Platform | Image identifier | Definition |
---|---|---|
Amazon Linux 2 | aws/codebuild/amazonlinux2-x86_64-standard:4.0 |
al2/standard/4.0 |
Amazon Linux 2023 | aws/codebuild/amazonlinux2-x86_64-standard:5.0 |
al2/standard/5.0 |
Amazon Linux 2 | aws/codebuild/amazonlinux2-x86_64-standard:corretto8 |
al2/standard/corretto8 |
Amazon Linux 2 | aws/codebuild/amazonlinux2-x86_64-standard:corretto11 |
al2/standard/corretto11 |
Amazon Linux 2 | aws/codebuild/amazonlinux2-aarch64-standard:2.0 |
al2/aarch64/standard/2.0 |
Amazon Linux 2023 | aws/codebuild/amazonlinux2-aarch64-standard:3.0 |
al2/aarch64/standard/3.0 |
Ubuntu 20.04 | aws/codebuild/standard:5.0 |
ubuntu/standard/5.0 |
Ubuntu 22.04 | aws/codebuild/standard:6.0 |
ubuntu/standard/6.0 |
Ubuntu 22.04 | aws/codebuild/standard:7.0 |
ubuntu/standard/7.0 |
Windows Server Core 2019 | aws/codebuild/windows-base:2019-1.0 |
N/A |
Windows Server Core 2019 | aws/codebuild/windows-base:2019-2.0 |
N/A |
Windows Server Core 2019 | aws/codebuild/windows-base:2019-3.0 |
N/A |
Windows Server Core 2022 | aws/codebuild/windows-base:2022-1.0 |
N/A |
Lambda compute images
AWS CodeBuild supports the following Docker images that are available for AWS Lambda compute in CodeBuild.
aarch64 Architecture | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Platform | Image identifier | Definition | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:dotnet6 |
al-lambda/aarch64/dotnet6 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:go1.21 |
al-lambda/aarch64/go1.21 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:corretto11 |
al-lambda/aarch64/corretto11 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:corretto17 |
al-lambda/aarch64/corretto17 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:corretto21 |
al-lambda/aarch64/corretto21 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:nodejs18 |
al-lambda/aarch64/nodejs18 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:nodejs20 |
al-lambda/aarch64/nodejs20 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:python3.11 |
al-lambda/aarch64/python3.11 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2023 | aws/codebuild/amazonlinux-aarch64-lambda-standard:python3.12 |
al-lambda/aarch64/python3.12 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-aarch64-lambda-standard:ruby3.2 |
al-lambda/aarch64/ruby3.2 |
x86_64 Architecture | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Platform | Image identifier | Definition | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-x86_64-lambda-standard:dotnet6 |
al-lambda/x86_64/dotnet6 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-x86_64-lambda-standard:go1.21 |
al-lambda/x86_64/go1.21 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-x86_64-lambda-standard:corretto11 |
al-lambda/x86_64/corretto11 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-x86_64-lambda-standard:corretto17 |
al-lambda/x86_64/corretto17 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2023 | aws/codebuild/amazonlinux-x86_64-lambda-standard:corretto21 |
al-lambda/x86_64/corretto21 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-x86_64-lambda-standard:nodejs18 |
al-lambda/x86_64/nodejs18 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2023 | aws/codebuild/amazonlinux-x86_64-lambda-standard:nodejs20 |
al-lambda/x86_64/nodejs20 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-x86_64-lambda-standard:python3.11 |
al-lambda/x86_64/python3.11 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2023 | aws/codebuild/amazonlinux-x86_64-lambda-standard:python3.12 |
al-lambda/x86_64/python3.12 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Amazon Linux 2 | aws/codebuild/amazonlinux-x86_64-lambda-standard:ruby3.2 |
al-lambda/x86_64/ruby3.2 |
Deprecated images
A deprecated image is an image that is no longer cached or updated by CodeBuild. A deprecated image no longer receives minor version updates or patch version updates, and because they are no longer updated, using them may not be secure. If your CodeBuild project is configured to use an older image version, the provisioning process will download this docker image and use it to create the containerized runtime environment, which can increase the provisioning duration and overall build duration.
CodeBuild has deprecated the following Docker images. You can still use these images, but they won't be cached on the build host and will result in higher provisioning times.
Platform | Image identifier | Definition | Deprecation date |
---|---|---|---|
Amazon Linux 2 | aws/codebuild/amazonlinux2-x86_64-standard:3.0 |
al2/standard/3.0 | May 9, 2023 |
Ubuntu 18.04 | aws/codebuild/standard:4.0 |
ubuntu/standard/4.0 | March 31, 2023 |
Amazon Linux 2 | aws/codebuild/amazonlinux2-aarch64-standard:1.0 |
al2/aarch64/standard/1.0 | March 31, 2023 |
Ubuntu 18.04 | aws/codebuild/standard:3.0 |
ubuntu/standard/3.0 | June 30, 2022 |
Amazon Linux 2 | aws/codebuild/amazonlinux2-x86_64-standard:2.0 |
al2/standard/2.0 | June 30, 2022 |