Introducing our new CEO Don Johnson - Read More

amazon/aws-codebuild-local

Verified Publisher

By Amazon Web Services

Updated 8 months ago

AWS CodeBuild Local Builds

Image
Developer Tools
59

500K+

AWS CodeBuild Local Builds

You can now locally test and debug your AWS CodeBuild builds using the new CodeBuild local agent. Previously, if you wanted to test your AWS CodeBuild build, you had to fully configure and run CodeBuild. Now, you can simulate a CodeBuild environment locally to quickly troubleshoot the commands and settings located in the BuildSpec file. The agent also allows you to build your application locally before committing your changes to build on the cloud.

Start by pulling the signed local agent image:

docker pull amazon/aws-codebuild-local:latest --disable-content-trust=false

You can verify the SHA matches our latest release. Please allow at least 4 hours after a new version has been pushed for the updated SHA to be reflected in our documentation.

You can run your build using our codebuild_build script

Note that if you want to use an AWS CodeBuild Curated image, you can build it locally on your machine by cloning our github repository and performing a docker build on your choice of image.


Subscribing to AWS CodeBuild Local Agent Notifications

Amazon SNS can notify you when new versions of the AWS CodeBuild Local Agent are released. To subscribe to AWS CodeBuild Local Agent notifications

  1. Open the Amazon SNS console at https://console.aws.amazon.com/sns/v2/home.

  2. In the navigation bar, change the region to US East (N. Virginia), if it is not selected already. You must select this region because the SNS notifications that you are subscribing to were created in this region.

  3. In the navigation pane, choose Subscriptions.

  4. Choose Create subscription.

  5. In the Create subscription dialog box, do the following: a. For Topic ARN, use the following Amazon Resource Name (ARN): arn:aws:sns:us-east-1:850632864840:AWS-CodeBuild-Local-Agent-Updates b. For Protocol, choose Email or SMS. c. For Endpoint, type an email address that you can use to receive the notifications. If you choose SMS, type an area code and number. d. Choose Create subscription.

    If you chose Email, you'll receive an email asking you to confirm your subscription. Open the email and follow the directions to complete your subscription.

Whenever a new version of AWS CodeBuild Local Agent is released, we send notifications to subscribers. If you no longer want to receive these notifications, use the following procedure to unsubscribe.

To unsubscribe from AWS CodeBuild Local Agent notifications

  1. Open the Amazon SNS console.
  2. In the navigation pane, choose Subscriptions.
  3. Select the subscription and then choose Actions, Delete subscriptions. When prompted for confirmation, choose Delete.

License information

Docker Pull Command

docker pull amazon/aws-codebuild-local