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

AWS CodeBuild User Guide Document History

Here is a list of important changes to the AWS CodeBuild User Guide.

  • Latest API version: 2016-10-06

  • Latest documentation update: October 3, 2017

Change Description Date Changed
Automatically rebuild updated source code in GitHub repositories If your source code is stored in a GitHub repository, you can enable AWS CodeBuild to rebuild your source code whenever a code change is pushed to the repository. For more information, see GitHub Pull Request Sample. September 21, 2017
New ways for storing and retrieving sensitive or large environment variables in Amazon EC2 Systems Manager Parameter Store You can now use the AWS CodeBuild console or the AWS CLI to retrieve sensitive or large environment variables stored in Amazon EC2 Systems Manager Parameter Store. You can also now use the AWS CodeBuild console to store these types of environment variables in Amazon EC2 Systems Manager Parameter Store. Previously, you could only retrieve these types of environment variables by including them in a build spec or by running build commands to automate the AWS CLI. You could only store these types of environment variables by using the Amazon EC2 Systems Manager Parameter Store console. For more information, see Create a Build Project, Change a Build Project's Settings, and Run a Build. September 14, 2017
Build deletion support You can now delete builds in AWS CodeBuild. For more information, see Delete Builds. August 31, 2017
Updated way to retrieve sensitive or large environment variables stored in Amazon EC2 Systems Manager Parameter Store by using a build spec AWS CodeBuild now makes it easier to use a build spec to retrieve sensitive or large environment variables stored in Amazon EC2 Systems Manager Parameter Store. Previously, you could only retrieve these types of environment variables by running build commands to automate the AWS CLI. For more information, see the parameter-store mapping in Build Spec Syntax. August 10, 2017
AWS CodeBuild supports Bitbucket AWS CodeBuild can now build from source code stored in a Bitbucket repository. For more information, see Create a Build Project and Run a Build. August 10, 2017
AWS CodeBuild available in US West (N. California), EU (London), and Canada (Central) AWS CodeBuild is now available in the US West (N. California), EU (London), and Canada (Central) regions. For more information, see the AWS CodeBuild section of the "AWS Regions and Endpoints" topic in the Amazon Web Services General Reference. June 29, 2017
.NET Core in Linux sample A sample showing how to use AWS CodeBuild and .NET Core to build an executable file out of code written in C# has been added. For more information, see the .NET Core in Linux Sample. June 29, 2017
Alternate build spec file names and locations supported You can now specify an alternate file name or location of a build spec file to use for a build project, instead of a default build spec file named buildspec.yml at the root of the source code. For more information, see Build Spec File Name and Storage Location. June 27, 2017
Updated build notifications sample AWS CodeBuild now provides built-in support for build notifications through Amazon CloudWatch Events and Amazon Simple Notification Service (Amazon SNS). The previous Build Notifications Sample has been updated to demonstrate this new behavior. June 22, 2017
Docker in custom image sample added A sample showing how to use AWS CodeBuild and a custom Docker build image to build and run a Docker image has been added. For more information, see the Docker in Custom Image Sample. June 7, 2017
Fetch source code for GitHub pull requests

When you run a build with AWS CodeBuild that relies on source code stored in a GitHub repository, you can now specify a GitHub pull request ID to build. You can also specify a commit ID, a branch name, or a tag name instead. For more information, see the Source version value in Run a Build (Console) or the sourceVersion value in Run a Build (AWS CLI).

June 6, 2017
Build specification version updated A new version of the build spec format has been released. Version 0.2 addresses the issue of AWS CodeBuild running each build command in a separate instance of the default shell. Also in version 0.2, environment_variables is renamed to env, and plaintext is renamed to variables. For more information, see Build Specification Reference for AWS CodeBuild. May 9, 2017
Dockerfiles for build images available in GitHub Definitions for many of the build images provided by AWS CodeBuild are available as Dockerfiles in GitHub. For more information, see the "Definition" column of the table in Docker Images Provided by AWS CodeBuild. May 2, 2017
AWS CodeBuild available in EU (Frankfurt), Asia Pacific (Singapore), Asia Pacific (Sydney), and Asia Pacific (Tokyo) AWS CodeBuild is now available in the EU (Frankfurt), Asia Pacific (Singapore), Asia Pacific (Sydney), and Asia Pacific (Tokyo) regions. For more information, see the AWS CodeBuild section of the "AWS Regions and Endpoints" topic in the Amazon Web Services General Reference. March 21, 2017
AWS CodePipeline test action support for AWS CodeBuild You can now add to a pipeline in AWS CodePipeline a test action that uses AWS CodeBuild. For more information, see Add an AWS CodeBuild Test Action to a Pipeline (AWS CodePipeline Console). March 8, 2017
Build specs support fetching build output from within selected top-level directories Build specs now enable you to specify individual top-level directories whose contents you can instruct AWS CodeBuild to include in build output artifacts. You do this by using the base-directory mapping. For more information, see Build Spec Syntax. February 8, 2017
Built-in environment variables AWS CodeBuild provides additional built-in environment variables for your builds to use. These include environment variables describing the entity that started the build, the URL to the source code repository, the source code's version ID, and more. For more information, see Environment Variables in Build Environments. January 30, 2017
AWS CodeBuild available in US East (Ohio) AWS CodeBuild is now available in the US East (Ohio) region. For more information, see the AWS CodeBuild section of the "AWS Regions and Endpoints" topic in the Amazon Web Services General Reference. January 19, 2017
AWS Lambda sample A reference was added to a sample showing how to use AWS CodeBuild along with Lambda, AWS CloudFormation, and AWS CodePipeline to build and deploy a serverless application that follows the AWS Serverless Application Model (AWS SAM) standard. For more information, see the AWS Lambda Sample. December 20, 2016
C++ and Go samples Samples showing how to use AWS CodeBuild to build C++ and Go output artifacts have been added. For more information, see the C++ Sample and the Go Sample. December 9, 2016
Shell and command behaviors information AWS CodeBuild runs each command you specify in a separate instance of a build environment's default shell. This default behavior can produce some unexpected side effects for your commands. We recommend some approaches to work around this default behavior if needed. For more information, see Shells and Commands in Build Environments. December 9, 2016
Environment variables information AWS CodeBuild provides several environment variables that you can use in your build commands. You can also define your own environment variables. For more information, see Environment Variables in Build Environments. December 7, 2016
Troubleshooting topic Troubleshooting information is now available. For more information, see Troubleshooting AWS CodeBuild. December 5, 2016
Jenkins plugin initial release This is the initial release of the AWS CodeBuild Jenkins Plugin. For more information, see Use AWS CodeBuild with Jenkins. December 5, 2016
User Guide initial release This is the initial release of the AWS CodeBuild User Guide. December 1, 2016