Build environment compute modes and types (original) (raw)

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.

Topics

• About compute
• About reserved capacity environment types
• About on-demand environment types

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:

US East (N. Virginia)

For more information on the pricing identifier, see https://aws.amazon.com/codebuild/pricing/.

US East (Ohio)

For more information on the pricing identifier, see https://aws.amazon.com/codebuild/pricing/.

US West (Oregon)

For more information on the pricing identifier, see https://aws.amazon.com/codebuild/pricing/.

Asia Pacific (Tokyo)

For more information on the pricing identifier, see https://aws.amazon.com/codebuild/pricing/.

Asia Pacific (Mumbai)

For more information on the pricing identifier, see https://aws.amazon.com/codebuild/pricing/.

Asia Pacific (Singapore)

For more information on the pricing identifier, see https://aws.amazon.com/codebuild/pricing/.

Asia Pacific (Sydney)

For more information on the pricing identifier, see https://aws.amazon.com/codebuild/pricing/.

Europe (Frankfurt)

For more information on the pricing identifier, see https://aws.amazon.com/codebuild/pricing/.

Europe (Ireland)

For more information on the pricing identifier, see https://aws.amazon.com/codebuild/pricing/.

South America (São Paulo)

For more information on the pricing identifier, see https://aws.amazon.com/codebuild/pricing/.

To choose a compute type:

• In the CodeBuild console, in the Compute fleet configuration page, choose one of the options from vCPUs,Memory, and Disk. For more information, see Create a reserved capacity fleet.
• For the AWS CLI, run the create-fleet orupdate-fleet command, specifying the value of computeType to ATTRIBUTE_BASED_COMPUTE. For more information, see create-fleet or update-fleet.
• For the AWS SDKs, call the equivalent of the CreateFleet or UpdateFleet operation for your target programming language, specifying the value of computeType toATTRIBUTE_BASED_COMPUTE. For more information, see the AWS SDKs and tools reference.

Note

For the AWS CLI and AWS SDKs, you can still use computeType inputs such as BUILD_GENERAL1_SMALL, to choose the compute types instead of ATTRIBUTE_BASED_COMPUTE. For more information, see About on-demand environment types.

Supported instance families

AWS CodeBuild supports the following instances for reserved capacity fleets.:

• General purpose: M5 | M5a | M5ad | M5d | M5dn | M5n | M5zn | M6a | M6g | M6gd | M6i | M6id | M6idn | M6in | M7a | M7g | M7gd | M7i | M7i-flex | M8g | T3 | T3a | T4g
• Compute optimized: C5 | C5a | C5ad | C5d | C5n | C6a | C6g | C6gd | C6gn | C6i | C6id | C6in | C7a | C7g | C7gd | C7gn | C7i | C7i-flex | C8g
• Memory optimized: R5 | R5a | R5ad | R5b | R5d | R5dn | R5n | R6a | R6g | R6gd | R6i | R6idn | R6in | R6id | R7a | R7g | R7gd | R7i | R7iz | R8g | U-3tb1 | U-6tb1 | U-9tb1 | U-12tb1 | U-18tb1 | U-24tb1 | U7i-6tb | U7i-8tb | U7i-12tb | U7in-16tb | U7in-24tb | U7in-32tb | X1 | X1e | X2gd | X2idn | X2iedn | X2iezn | X8g | z1d
• Storage optimized: D3 | D3en | I3 | I3en | I4g | I4i | I7ie | I8g | Im4gn | Is4gen
• Accelerated computing: DL1 | DL2q | F1 | F2 | G4ad | G4dn | G5 | G5g | G6 | G6e | Gr6 | Inf1 | Inf2 | P3 | P3dn | P4d | P5 | P5e | P5en | Trn1 | Trn1n | Trn2 | VT1
• High-performance computing: Hpc6a | Hpc6id | Hpc7a | Hpc7g
• Previous generation: A1

To create a reserved capacity fleet with a specific instance type:

• In the CodeBuild console, in the Compute fleet configuration page, navigate to the Capacity configuration section. In Compute selection mode, select Manual input and in Compute instance type choose one of the instance types from the drop-down menu. For more information, see Create a reserved capacity fleet.
• For the AWS CLI, run the create-fleet orupdate-fleet command, specifying the value of computeType to CUSTOM_INSTANCE_TYPE and the ComputeConfiguration instanceType to the specified instance type. For more information, see create-fleet or update-fleet.
• For the AWS SDKs, call the equivalent of the CreateFleet or UpdateFleet operation for your target programming language, specifying the value of computeType toCUSTOM_INSTANCE_TYPE and the ComputeConfiguration instanceType to the specified instance type. For more information, see the AWS SDKs and tools reference.

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:

• In the CodeBuild console, in the Create build project wizard orEdit Build Project page, inEnvironment expand Additional configuration, and then choose one of the options fromCompute type. For more information, see Create a build project (console) orChange a build project's settings (console).
• For the AWS CLI, run the create-project orupdate-project command, specifying thecomputeType value of the environment object. For more information, see Create a build project (AWS CLI) or Change a build project's settings (AWS CLI).
• For the AWS SDKs, call the equivalent of the CreateProject or UpdateProject operation for your target programming language, specifying the equivalent of computeType value of theenvironment object. For more information, see the AWS SDKs and tools reference.

Some environment and compute types have Region availability limitations:

• The compute type Linux GPU Small (LINUX_GPU_CONTAINER) is only available in these Regions:
  • US East (N. Virginia)
  • US West (Oregon)
  • Asia Pacific (Tokyo)
  • Canada (Central)
  • Europe (Frankfurt)
  • Europe (Ireland)
  • Europe (London)
• The compute type Linux GPU Large (LINUX_GPU_CONTAINER) is only available in these Regions:
  • US East (Ohio)
  • US East (N. Virginia)
  • US West (Oregon)
  • Asia Pacific (Seoul)
  • Asia Pacific (Sydney)
  • Asia Pacific (Tokyo)
  • Canada (Central)
  • China (Beijing)
  • China (Ningxia)
  • Europe (Frankfurt)
  • Europe (Ireland)
  • Europe (London)
• The compute type BUILD_GENERAL1_2XLARGE is only available in these Regions:
  • US East (Ohio)
  • US East (N. Virginia)
  • US West (N. California)
  • US West (Oregon)
  • Asia Pacific (Hyderabad)
  • Asia Pacific (Hong Kong)
  • Asia Pacific (Jakarta)
  • Asia Pacific (Melbourne)
  • Asia Pacific (Mumbai)
  • Asia Pacific (Seoul)
  • Asia Pacific (Singapore)
  • Asia Pacific (Sydney)
  • Asia Pacific (Tokyo)
  • Canada (Central)
  • China (Beijing)
  • China (Ningxia)
  • Europe (Frankfurt)
  • Europe (Ireland)
  • Europe (London)
  • Europe (Paris)
  • Europe (Spain)
  • Europe (Stockholm)
  • Europe (Zurich)
  • Israel (Tel Aviv)
  • Middle East (Bahrain)
  • Middle East (UAE)
  • South America (São Paulo)
• The environment type ARM_CONTAINER is only available in these Regions:
  • US East (Ohio)
  • US East (N. Virginia)
  • US West (N. California)
  • US West (Oregon)
  • Asia Pacific (Hong Kong)
  • Asia Pacific (Jakarta)
  • Asia Pacific (Hyderabad)
  • Asia Pacific (Mumbai)
  • Asia Pacific (Osaka)
  • Asia Pacific (Seoul)
  • Asia Pacific (Singapore)
  • Asia Pacific (Sydney)
  • Asia Pacific (Tokyo)
  • Canada (Central)
  • China (Beijing)
  • China (Ningxia)
  • Europe (Frankfurt)
  • Europe (Ireland)
  • Europe (London)
  • Europe (Milan)
  • Europe (Paris)
  • Europe (Spain)
  • Europe (Stockholm)
  • Israel (Tel Aviv)
  • Middle East (Bahrain)
  • Middle East (UAE)
  • South America (São Paulo)
• The environment type WINDOWS_SERVER_2022_CONTAINER is only available in these Regions:
  • US East (Ohio)
  • US East (N. Virginia)
  • US West (Oregon)
  • Asia Pacific (Sydney)
  • Asia Pacific (Tokyo)
  • Europe (Frankfurt)
  • Europe (Ireland)
  • South America (São Paulo)
• The environment type LINUX_EC2 (BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE) is only available in these Regions:
  • US East (Ohio)
  • US East (N. Virginia)
  • US West (N. California)
  • US West (Oregon)
  • Africa (Cape Town)
  • Asia Pacific (Hong Kong)
  • Asia Pacific (Jakarta)
  • Asia Pacific (Melbourne)
  • Europe (Zurich)
  • Asia Pacific (Hyderabad)
  • Asia Pacific (Mumbai)
  • Asia Pacific (Osaka)
  • Asia Pacific (Seoul)
  • Asia Pacific (Singapore)
  • Asia Pacific (Sydney)
  • Asia Pacific (Tokyo)
  • Canada (Central)
  • China (Beijing)
  • China (Ningxia)
  • Europe (Frankfurt)
  • Europe (Ireland)
  • Europe (London)
  • Europe (Milan)
  • Europe (Paris)
  • Europe (Spain)
  • Europe (Stockholm)
  • Israel (Tel Aviv)
  • Middle East (Bahrain)
  • Middle East (UAE)
  • South America (São Paulo)
  • AWS GovCloud (US-West)
  • AWS GovCloud (US-East)
• The environment type ARM_EC2 (BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE) is only available in these Regions:
  • US East (Ohio)
  • US East (N. Virginia)
  • US West (N. California)
  • US West (Oregon)
  • Asia Pacific (Hong Kong)
  • Asia Pacific (Jakarta)
  • Europe (Zurich)
  • Asia Pacific (Hyderabad)
  • Asia Pacific (Mumbai)
  • Asia Pacific (Osaka)
  • Asia Pacific (Seoul)
  • Asia Pacific (Singapore)
  • Asia Pacific (Sydney)
  • Asia Pacific (Tokyo)
  • Canada (Central)
  • China (Beijing)
  • China (Ningxia)
  • Europe (Frankfurt)
  • Europe (Ireland)
  • Europe (London)
  • Europe (Milan)
  • Europe (Paris)
  • Europe (Spain)
  • Europe (Stockholm)
  • Israel (Tel Aviv)
  • Middle East (Bahrain)
  • South America (São Paulo)
  • AWS GovCloud (US-West)
  • AWS GovCloud (US-East)
• The environment type WINDOWS_EC2 (BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE) is only available in these Regions:
  • US East (Ohio)
  • US East (N. Virginia)
  • US West (Oregon)
  • Asia Pacific (Sydney)
  • Asia Pacific (Tokyo)
  • Europe (Frankfurt)
  • Europe (Ireland)
  • South America (São Paulo)
• The compute mode AWS Lambda (ARM_LAMBDA_CONTAINER and LINUX_LAMBDA_CONTAINER) is only available in these Regions:
  • US East (N. Virginia)
  • US East (Ohio)
  • US West (Oregon)
  • Asia Pacific (Mumbai)
  • Asia Pacific (Singapore)
  • Asia Pacific (Sydney)
  • Asia Pacific (Tokyo)
  • Europe (Frankfurt)
  • Europe (Ireland)
  • South America (São Paulo)
• The compute mode MAC_ARM is only available in these Regions:
  • US East (N. Virginia)
  • US East (Ohio)
  • US West (Oregon)
  • Asia Pacific (Sydney)
  • Europe (Frankfurt)

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

Note

For custom build environment images, CodeBuild supports Docker images up to 50 GB uncompressed in Linux and Windows, regardless of the compute type. To check your build image's size, use Docker to run the docker images`REPOSITORY`:`TAG` command.

You can use Amazon EFS to access more space in your build container. For more information, seeAmazon 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.

Note

By default, Docker daemon is enabled for non-VPC builds. If you would like to use Docker containers for VPC builds, see Runtime Privilege and Linux Capabilities on the Docker Docs website and enable privileged mode. Also, Windows does not support privileged mode.