教程：使用 SSH 连接到沙盒 - Amazon CodeBuild
步骤 1：启动沙盒步骤 2：修改本地 SSH 配置步骤 3：连接到沙盒步骤 4：检查您的结果
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

教程：使用 SSH 连接到沙盒

本教程介绍如何使用 SSH 客户端连接到 CodeBuild 沙盒。

要完成本教程，您首先必须：

  • 确保您有一个现有的 Amazon CodeBuild 项目。

  • 设置为 CodeBuild 项目角色配置的相应 IAM 权限。

  • 在本地计算机上安装并配置 Amazon CLI。

步骤 1：启动沙盒

在控制台中启动 CodeBuild 沙盒

  1. 从 https://console.aws.amazon.com/codesuite/codebuild/home 打开 Amazon CodeBuild 控制台。

  2. 在导航窗格中，选择构建项目。选择构建项目，然后选择调试构建。

    控制台中的构建项目详细信息页面。

  3. 在 SSH 客户端选项卡中，选择启动沙盒。

    控制台中的“SSH 客户端”选项卡，带有“启动沙盒”按钮。

  4. 沙盒初始化过程可能需要一些时间。当沙盒的状态更改为 RUN_SANDDBOX 时，您可以连接到沙盒。

    状态更改为“RUN_SANDDBOX”之后的 SSH 沙盒连接。

步骤 2：修改本地 SSH 配置

如果您是首次连接到沙盒，则需要使用以下步骤执行一次性设置过程：

在控制台中修改本地 SSH 配置

  1. 找到适用于您的操作系统的安装命令。

  2. 打开本地终端，然后复制并执行提供的命令，以下载并运行脚本来设置本地 SSH 配置。例如，如果您的操作系统是 macOS，请使用以下命令：

    用于在控制台中通过 SSH 连接到 CodeBuild 沙盒的 macOS 命令。

  3. 配置脚本将添加连接到沙盒所需的配置。系统将提示您接受这些更改。

  4. 成功配置后，将为 CodeBuild 沙盒创建一个新的 SSH 配置条目。

    成功的 SSH 沙盒连接。

步骤 3：连接到沙盒

在控制台中修改本地 SSH 配置

  1. 配置 Amazon CLI 身份验证并确保您的 Amazon CLI 用户拥有 codebuild:StartSandboxConnection 权限。有关更多信息，请参阅《Amazon 命令行界面版本 1 的用户指南》中的在 Amazon CLI 中使用 IAM 用户凭证进行身份验证。

  2. 使用以下命令连接到您的沙盒：

    ssh codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1:<account-id>:sandbox/<sandbox-id>
    注意

    要对连接失败进行故障排除，请使用 -v 标志启用详细输出。例如 ssh -v codebuild-sandbox-ssh=arn:aws:codebuild:us-east-1:<account-id>:sandbox/<sandbox-id>。

    有关其它故障排除指南，请参阅排查 Amazon CodeBuild 沙盒 SSH 连接问题。

步骤 4：检查您的结果

连接后，您可以调试构建失败、测试构建命令、试验配置更改以及使用沙盒验证环境变量和依赖项。