Tutorial: Connecting to a sandbox using SSH (original) (raw)

This tutorial shows you how to connect to a CodeBuild sandbox using an SSH client.

To complete this tutorial, you must first:

Step 1: Start a sandbox

To start a CodeBuild sandbox in the console
  1. Open the AWS CodeBuild console at https://console.aws.amazon.com/codesuite/codebuild/home.
  2. In the navigation pane, choose Build projects. Choose the build project, and then choose Debug build.
    The build project detail page in the console.
  3. In the SSH Client tab and choose Start sandbox.
    The "SSH Client" tab in the console with "Start sandbox" button.
  4. The sandbox initialization process may take some time. You can connect to the sandbox when its status changes to RUN_SANDDBOX.
    The SSH sandbox connection after the status changes to "RUN_SANDDBOX".

Step 2: Modify local SSH configuration

If you're connecting to sandbox for the first time, you need to perform a one-time setup process using the following steps:

To modify the local SSH configuration in the console
  1. Locate the setup commands for your operating system.
  2. Open your local terminal, then copy and execute the provided commands to download and run the script to set up your local SSH configuration. For example, if your operating system is macOS, use the following command:
    The macOS commands for SSH connection to the CodeBuild sandbox in the console.
  3. The configuration script will add the required configurations for connecting to your sandboxes. You'll be prompted to accept these changes.
  4. Upon successful configuration, a new SSH configuration entry for CodeBuild sandbox will be created.
    A successful SSH sandbox connection.

Step 3: Connect to the sandbox

To modify the local SSH configuration in the console
  1. Configure AWS CLI Authentication and ensure your AWS CLI user has the codebuild:StartSandboxConnection permission. For more information, see Authenticating using IAM user credentials for the AWS CLI in the AWS Command Line Interface User Guide for Version 1.
  2. Connect to your sandbox with following command:
ssh codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1:<account-id>:sandbox/<sandbox-id>

Step 4: Review your results

Once connected, you can debug build failures, test build commands, experiment with configuration changes and verify environment variables and dependencies with your sandbox.