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.

Test and Debug Locally with the AWS CodeBuild Agent

This topic provides information about how to run the AWS CodeBuild agent and subscribe to notifications about new versions of the agent.

Test and Debug on a Local Machine with the AWS CodeBuild Agent

You can use the AWS CodeBuild agent to test and debug builds on a local machine. To use the agent:

  1. Download the script.

  2. Run the script and specify your container images and output directory: [-i image_name] [-a artifact_output_directory] [options]

The AWS CodeBuild agent is available from Its Secure Hash Algorithm (SHA) signature is 17230d017b97ea06054b93209230943add0c2bc3b888ab565dbbd9368f77bacc. You can use this to identify the version of the agent. To see the agent's SHA signature, run the following command:

docker inspect amazon/aws-codebuild-local

Receive Notifications for New AWS CodeBuild Agent Versions

Amazon SNS can notify you when new versions of the AWS CodeBuild Agent are released. Use the following procedure to subscribe to these notifications.

To subscribe to the AWS CodeBuild Agent notifications:

  1. Open the Amazon SNS console at

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

  3. In the navigation pane, choose Subscriptions.

  4. Choose Create subscription.

  5. In the Create subscription dialog box:

    1. For Topic ARN, use the following Amazon Resource Name (ARN):

    2. For Protocol choose Email or SMS.

    3. For Endpoint choose where to receive the notifications:

      • If you choose Email, type an email address.

      • If you choose SMS, type a phone number, including area code.

    4. Choose Create subscription.

  6. If you choose Email, you'll receive an email asking you to confirm your subscription. Follow the directions in the email to complete your subscription.

When a new version of the AWS CodeBuild agent is released, subscribers receive notifications. If you no longer want to receive these notifications, use the following procedure to unsubscribe.

To unsubscribe from AWS CodeBuild agent notifications:

  1. Open the Amazon SNS console at

  2. In the navigation pane, choose Subscriptions.

  3. Select the subscription and then from Actions, choose Delete subscriptions. When you are prompted to confirm, choose Delete.