Amazon CodeBuild 沙箱 SSH 连接问题疑难解答 - Amazon CodeBuild
StartSandboxConnectionInvalidInputExceptionSSH 进入 CodeBuild 沙盒环境时出错错误：SSH 进入 CodeBuild 沙盒环境时出现 “找不到凭证”StartSandboxConnectionAccessDeniedExceptionSSH 进入 CodeBuild 沙盒环境时出错SSH 进入 CodeBuild 沙盒环境时出现错误：“ssh：无法解析主机名”
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Amazon CodeBuild 沙箱 SSH 连接问题疑难解答

使用本主题中的信息来帮助您识别、诊断和解决 CodeBuild 沙箱 SSH 连接问题。

StartSandboxConnectionInvalidInputExceptionSSH 进入 CodeBuild 沙盒环境时出错

问题：尝试使用命令连接到 CodeBuild 沙盒环境时ssh codebuild-sandbox-ssh=<sandbox-arn>，可能会遇到如下InvalidInputException错误：

An error occurred (InvalidInputException) when calling the StartSandboxConnection 
operation: Failed to start SSM session for {sandbox-arn}
User: arn:aws:sts::<account-ID>:assumed-role/<service-role-name>/AWSCodeBuild-<UUID> 
is not authorized to perform: ssm:StartSession on resource.
An error occurred (InvalidInputException) when calling the StartSandboxConnection 
operation: Failed to start SSM session for 
sandbox <sandbox-arn>: codebuild:<UUID> is not connected.

可能的原因：

  • 缺少 Amazon S EC2 ystems Manager 代理：构建映像未正确安装或配置 SSM 代理。

  • 权限不足： CodeBuild 项目服务角色缺少所需的 SSM 权限。

推荐的解决方案：如果您在构建中使用自定义映像，请执行以下操作。

  1. 安装 SSM 代理 有关更多信息，请参阅中的在 Amazon Linux EC2 实例上手动安装和卸载 SSM 代理。SSM 代理版本必须是3.0.1295.0或更高版本。

  2. 将文件 https://github.com/aws/aws-codebuild-docker-images/blob/master/ubuntu/standard/7.0/amazon-ssm-agent.js on 复制到图像中的目录中。/etc/amazon/ssm/这将在 SSM 代理中启用容器模式。

  3. 确保 CodeBuild 项目的服务角色具有以下权限，然后重新启动沙盒环境：

    {
   "Effect": "Allow",
      "Action": [
         "ssmmessages:CreateControlChannel",
         "ssmmessages:CreateDataChannel",
         "ssmmessages:OpenControlChannel",
         "ssmmessages:OpenDataChannel"
      ],
      "Resource": "*"
 },
 {
    "Effect": "Allow",
    "Action": [
       "ssm:StartSession"
     ],
     "Resource": [
        "arn:aws:codebuild:region:account-id:build/*",
        "arn:aws:ssm:region::document/AWS-StartSSHSession"
     ]
 }

错误：SSH 进入 CodeBuild 沙盒环境时出现 “找不到凭证”

问题：尝试使用命令连接到 CodeBuild 沙盒环境时ssh codebuild-sandbox-ssh=<sandbox-arn>，可能会遇到以下凭据错误：

Unable to locate credentials. You can configure credentials by running 
"aws configure".

可能的原因：您的本地环境中未正确配置 Amazon 凭证。

推荐的解决方案：按照官方文档配置您的 Amazon CLI 证书： Amazon CLI在版本 2 的Amazon 命令行界面用户指南中配置设置。

StartSandboxConnectionAccessDeniedExceptionSSH 进入 CodeBuild 沙盒环境时出错

问题：尝试使用命令连接到 CodeBuild 沙盒环境时ssh codebuild-sandbox-ssh=<sandbox-arn>，可能会遇到以下权限错误：

An error occurred (AccessDeniedException) when calling the StartSandboxConnection 
operation: 
User: arn:aws:sts::account-id:assumed-role/role-name
is not authorized to perform: codebuild:StartSandboxConnection on resource: 
sandbox-arn
because no identity-based policy allows the codebuild:StartSandboxConnection action

可能的原因：您的 Amazon 凭证缺少执行此操作所需的 CodeBuild 权限。

推荐的解决方案：确保与您的 Amazon CLI 证书关联的 IAM 用户或角色具有以下权限：

{
    "Effect": "Allow",
    "Action": [
       "codebuild:StartSandboxConnection"
     ],
     "Resource": [
        "arn:aws:codebuild:region:account-id:sandbox/*"
     ]
}

SSH 进入 CodeBuild 沙盒环境时出现错误：“ssh：无法解析主机名”

问题：尝试使用命令连接到 CodeBuild 沙盒环境时ssh codebuild-sandbox-ssh=<sandbox-arn>，遇到以下主机名解析错误：

ssh: Could not resolve hostname

可能的原因：此错误通常发生在本地环境中未正确执行所需的 CodeBuild 沙箱连接脚本时。

建议的解决方案：

  1. 下载 CodeBuild 沙箱连接脚本。

  2. 在终端中执行脚本以建立必要的 SSH 配置。

  3. 重试与沙盒环境的 SSH 连接。