Build environment compute modes and types

In CodeBuild, you can specify the compute and runtime environment image that CodeBuild uses to run your builds. Compute refers to the computing engine (the CPU, memory, and operating system) that is managed and maintained by CodeBuild. A runtime environment image is a container image that runs on top of your chosen compute platform, and includes extra tools that your build might need, such as the AWS CLI.

About compute

CodeBuild offers EC2 and AWS Lambda compute modes. EC2 offers optimized flexibility during your build and AWS Lambda offers optimized start-up speeds. AWS Lambda supports faster builds due to a lower start-up latency. AWS Lambda also automatically scales, so builds aren't waiting in queue to run. For more information, see Run builds on AWS Lambda compute.

With the EC2 compute mode, you can run your builds with on-demand or reserved capacity fleets. For on-demand fleets, you can select pre-defined compute types such asBUILD_GENERAL1_SMALL or BUILD_GENERAL1_LARGE. For more information, see About on-demand environment types. For reserved capacity fleets, you can select your compute configurations including vCPU, memory and disk space. After specifying the configurations, CodeBuild will choose a supported compute type that matches your requirements. For more information, see About reserved capacity environment types.

About reserved capacity environment types

AWS CodeBuild provides Linux x86, Arm, GPU, Windows and macOS environment types for reserved capacity fleets. The following table shows the available machine type, memory, vCPUs, and disk space sorted by region:

To choose a compute type:

About on-demand environment types

AWS CodeBuild provides build environments with the following available memory, vCPUs, and disk space for EC2 compute mode:

^¹ The latest version of this image type 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/amazonlinux-x86_64-standard:5.0 instead of a more granular version, such as aws/codebuild/amazonlinux-x86_64-standard:5.0-1.0.0.

AWS CodeBuild provides build environments with the following available memory and disk space for AWS Lambda compute mode:

When using other environment types, it is recommended that you use a cached image to reduce build times.

The disk space listed for each build environment is available only in the directory specified by the CODEBUILD_SRC_DIR environment variable.

To choose a compute type:

Some environment and compute types have Region availability limitations:

For the compute type BUILD_GENERAL1_2XLARGE, Docker images up to 100 GB uncompressed are supported.

You can use Amazon EFS to access more space in your build container. For more information, see Amazon Elastic File System sample for AWS CodeBuild. If you want to manipulate container disk space during a build, then the build must run in privileged mode.