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

Test and Debug Locally with the 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 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 CodeBuild agent is available from Its Secure Hash Algorithm (SHA) signature is 2c2b0a6b3595abfb5408cfa263d91ef280a910e2a03e920f65c3ffb9a97d0550. 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 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 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 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 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.