Docker images provided by CodeBuild - AWS CodeBuild

Docker images provided by CodeBuild

AWS CodeBuild manages the following Docker images that are available in the CodeBuild and AWS CodePipeline consoles.

Platform Image identifier Definition
Amazon Linux 2 aws/codebuild/amazonlinux2-x86_64-standard:2.0 al2/standard/2.0
Amazon Linux 2 aws/codebuild/amazonlinux2-x86_64-standard:3.0 al2/standard/3.0
Amazon Linux 2 aws/codebuild/amazonlinux2-aarch64-standard:1.0 al2/aarch64/standard/1.0
Amazon Linux 2 aws/codebuild/amazonlinux2-aarch64-standard:2.0 al2/aarch64/standard/2.0
Ubuntu 18.04 aws/codebuild/standard:3.0 ¹ ubuntu/standard/3.0
Ubuntu 18.04 aws/codebuild/standard:4.0 ubuntu/standard/4.0
Ubuntu 20.04 aws/codebuild/standard:5.0 ubuntu/standard/5.0
Windows Server Core 2019 aws/codebuild/windows-base:2019-1.0 N/A

¹ No longer maintained after May 2021.

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)

The latest version of each image is cached. If you specify a more specific version, then CodeBuild provisions that version instead of the cached version. This can result in longer build times. For example, to benefit from caching, specify aws/codebuild/amazonlinux2-x86_64-standard:3.0 instead of a more granular version, such as aws/codebuild/amazonlinux2-x86_64-standard:3.0-1.0.0.

CodeBuild frequently updates the list of Docker 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.