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

AWS CodeBuild User Guide Document History

The following table describes the important changes to the documentation since the last release of AWS CodeBuild. For notification about updates to this documentation, you can subscribe to an RSS feed.

  • Latest API version: 2016-10-06

  • Latest documentation update: September 17, 2018

Change Description Date

S3 logs

AWS CodeBuild now supports build logs in an S3 bucket. Previously, you could only build logs using CloudWatch Logs. For more information, see Create Project.

September 17, 2018

Multiple inpout sources and mulitple output artifacts

AWS CodeBuild now supports projects that use more than one input source and publish more than one set of artifacts. For more information, see Multiple Input Sources and Output Artifacts Sample and AWS CodePipeline Integration with AWS CodeBuild and Multiple Input Sources and Output Artifacts Sample.

August 30, 2018

Semantic versioning sample

The AWS CodeBuild User Guide now has a use case-based sample that demonstrates how to use semantic versioning to create artifact names at build time. For more information, see Semantic Versioning Your Build Artifacts Sample.

August 14, 2018

New static website sample

The AWS CodeBuild User Guide now has a use case-based sample that demonstrates how to host build output in an Amazon S3 bucket. The sample takes advantage of the recent support of unencrypted build artifiacts. For more information, see Create a Static Website with Build Output Hosted in an Amazon S3 Bucket.

August 14, 2018

Support for overriding an artifact name with semantic versioning

You can now use semantic versioning to specify a format that AWS CodeBuild uses to name build artifacts. This is useful because a build artifact with a hard-coded name overwrites previous build artifacts that use the same hard-coded name. For example, if a build is triggered multiple times a day, you can now add a timestamp to its artifact name. Each build artifact name is unique and does not overwrite the artifacts of previous builds.

August 7, 2018

Support of unencrypted build artifacts

AWS CodeBuild now supports builds with unencrypted build artifacts. For more information, see Create a Build Project (Console).

July 26, 2018

Support for Amazon CloudWatch metrics and alarms

AWS CodeBuild now provides integration with CloudWatch metrics and alarms. You can use the AWS CodeBuild or CloudWatch console to monitor builds at the project and account level. For more information, see Monitoring Builds.

July 19, 2018

Support for reporting a build's status

AWS CodeBuild can now report the status of a build's start and completion to your source provider. For more information, see Create a Build Project in AWS CodeBuild.

July 10, 2018

Environment variables added to AWS CodeBuild documentation

The Environment Variables in Build Environments page was updated with the CODEBUILD_BUILD_ID, CODEBUILD_LOG_PATH, and CODEBUILD_START_TIME environment variables.

July 9, 2018

Support for a finally block in the build spec file

The AWS CodeBuild documentation was updated with details about the optional finally block in a build spec file. Commands in the finally block always execute after the commands in its corresponding commands block. For more information, see Build Spec Syntax.

June 20, 2018

AWS CodeBuild agent update notifications

The AWS CodeBuild documentation was updated with details about how you can use Amazon SNS to be notified when new versions of the AWS CodeBuild agent are released. For more information, see Receive Notifications for New AWS CodeBuild Agent Versions.

June 15, 2018

Earlier Updates

The following table describes important changes in each release of the AWS CodeBuild User Guide before June 2018.

Change Description Date
Support for Windows builds AWS CodeBuild now supports builds for the Microsoft Windows Server platform, including a prepackaged build environment for the .NET Core 2.0 on Windows. For more information, see Microsoft Windows Samples for AWS CodeBuild. May 25, 2018
Support for build idempotency When you run the start-build command with the AWS Command Line Interface (AWS CLI), you can specify that the build is idempotent. For more information, see Run a Build (AWS CLI). May 15, 2018
Support for overriding more build project settings You can now override more build project settings when you create a build. The overrides are only for that build. For more information, see Run a Build in AWS CodeBuild. May 15, 2018
VPC Endpoint support You can now use VPC endpoints to improve the security of your builds. For more information, see Use VPC Endpoints. March 18, 2018
Support of triggers You can now create riggers to schedule builds at regular frequencies. For more information, see Create AWS CodeBuild Triggers. March 28, 2018
FIPS endpoints documentation You can now learn about how to use the AWS Command Line Interface (AWS CLI) or an AWS SDK to tell AWS CodeBuild to use one of four Federal Information Processing Standards (FIPS) endpoints. For more information, see Specify the AWS CodeBuild Endpoint. March 28, 2018
AWS CodeBuild available in Asia Pacific (Mumbai), EU (Paris), and South America (São Paulo) AWS CodeBuild is now available in the Asia Pacific (Mumbai), EU (Paris), and South America (São Paulo) regions. For more information, see the AWS CodeBuild section of the "AWS Regions and Endpoints" topic in the Amazon Web Services General Reference. March 28, 2018
GitHub Enterprise support AWS CodeBuild can now build from source code stored in a GitHub Enterprise repository. For more information, see GitHub Enterprise Sample. January, 25, 2018
Git clone depth support AWS CodeBuild now supports the creation of a shallow clone with a history truncated to the specified number of commits. For more information, see Create a Build Project. January, 25, 2018
VPC support VPC-enabled builds are now able to access resources inside your VPC. For more information, see VPC Support. November, 27, 2017
Dependency caching support AWS CodeBuild now supports the dependency caching. This allows AWS CodeBuild to save certain reusable pieces of the build environment in the cache and use this across builds. November, 27, 2017
Build badges support AWS CodeBuild now supports the use of build badges, which provide an embeddable, dynamically generated image (badge) that displays the status of the latest build for a project. For more information, see Build Badges Sample. November 27, 2017
AWS Config integration AWS Config now supports AWS CodeBuild as an AWS resource, which means the service can track your AWS CodeBuild projects. For more information about AWS Config, see Use AWS Config with AWS CodeBuild Sample. October 20, 2017
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

On this page: