Build environment reference for Amazon CodeBuild - Amazon CodeBuild
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Build environment reference for Amazon CodeBuild

When you call Amazon CodeBuild to run a build, you must provide information about the build environment. A build environment represents a combination of operating system, programming language runtime, and tools that CodeBuild uses to run a build. For information about how a build environment works, see How CodeBuild works.

A build environment contains a Docker image. For information, see the Docker glossary on the Docker Docs website.

When you provide information to CodeBuild about the build environment, you specify the identifier of a Docker image in a supported repository type. These include the CodeBuild Docker image repository, publicly available images in Docker Hub, and Amazon Elastic Container Registry (Amazon ECR) repositories that your Amazon account has permissions to access.

  • We recommend that you use Docker images stored in the CodeBuild Docker image repository, because they are optimized for use with the service. For more information, see Docker images provided by CodeBuild.

  • To get the identifier of a publicly available Docker image stored in Docker Hub, see Searching for Repositories on the Docker Docs website.

  • To learn how to work with Docker images stored in Amazon ECR repositories in your Amazon account, see Amazon ECR sample.

In addition to a Docker image identifier, you also specify a set of computing resources that the build environment uses. For more information, see Build environment compute types.