AWS CodeBuild
User Guide (API Version 2016-10-06)

The procedures in this guide support the new console design. If you choose to use the older version of the console, you will find many of the concepts and basic procedures in this guide still apply. To access help in the new console, choose the information icon.

AWS CodeBuild Concepts

The following concepts are important for understanding how AWS CodeBuild works.

How AWS CodeBuild Works

The following diagram shows what happens when you run a build with AWS CodeBuild:

  1. As input, you must provide AWS CodeBuild with a build project. A build project defines how AWS CodeBuild runs a build. It includes information such as where to get the source code, the build environment to use, the build commands to run, and where to store the build output. A build environment represents a combination of operating system, programming language runtime, and tools that AWS CodeBuild uses to run a build. For more information, see:

  2. AWS CodeBuild uses the build project to create the build environment.

  3. AWS CodeBuild downloads the source code into the build environment and then uses the build specification (build spec), as defined in the build project or included directly in the source code. A build spec is a collection of build commands and related settings, in YAML format, that AWS CodeBuild uses to run a build. For more information, see the Build Spec Reference.

  4. If there is any build output, the build environment uploads its output to an Amazon S3 bucket. The build environment can also perform tasks that you specify in the build spec (for example, sending build notifications to an Amazon SNS topic). For an example, see Build Notifications Sample.

  5. While the build is running, the build environment sends information to AWS CodeBuild and Amazon CloudWatch Logs.

  6. While the build is running, you can use the AWS CodeBuild console, AWS CLI, or AWS SDKs, to get summarized build information from AWS CodeBuild and detailed build information from Amazon CloudWatch Logs. If you use AWS CodePipeline to run builds, you can get limited build information from AWS CodePipeline.

Next Steps

Now that you know more about AWS CodeBuild, we recommend that you complete the following steps:

  1. Experiment with AWS CodeBuild in an example scenario by following the instructions in Getting Started.

  2. Use AWS CodeBuild in your own scenarios by following the instructions in Plan a Build.