私有表Amazon Secrets Manager示例 CodeBuild - Amazon CodeBuild
私有注册表示例要求 创建 CodeBuild 带有私有注册表的项目
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

私有表Amazon Secrets Manager示例 CodeBuild

此示例向您显示如何使用在私有注册表中存储的 Docker 映像作为您的 Amazon CodeBuild 运行时环境。私有注册表的凭证存储在 Amazon Secrets Manager 中。任何私有注册表均可使用 CodeBuild. 此示例使用 Docker Hub。

私有注册表示例要求

要将私有注册表与 Amazon CodeBuild 结合使用，您必须具有以下各项：

  • 存储 Docker Hub 凭证的 Secrets Manager 密钥。该凭证可用于访问您的私有存储库。

  • 一个私有存储库或账户。

  • 一个 CodeBuild 服务角色 IAM 策略，授予对您的 Secrets Manager 密钥的访问。

执行以下步骤可创建这些资源，然后创建 CodeBuild 使用存储在您的私有注册表中的 Docker 镜像构建项目。

创建 CodeBuild 带有私有注册表的项目

  1. 有关如何创建免费的私有存储库的更多信息，请参阅 Docker Hub 上的存储库。您还可以在终端中运行以下命令来提取映像、获取其ID，并将其推送到新的存储库。

    docker pull amazonlinux
docker images amazonlinux --format {{.ID}}
docker tag image-id your-username/repository-name:tag
docker login
docker push your-username/repository-name

  2. 按中的步骤操作创建基本密钥在里面Amazon Secrets Manager用户指南. 在第 3 步的选择密钥类型中，执行以下操作：

    1. 选择其他密钥类型。

    2. 在密钥键/值中，为您的 Docker Hub 用户名创建一个键值对，为您的 Docker Hub 密码创建一个键值对。

    3. 对于密钥名称，输入一个名称，例如 dockerhub。您可以输入可选说明以帮助您记住这是 Docker Hub 的密钥。

    4. 将禁用自动轮换选定，因为密钥对应于您的 Docker Hub 凭证。

    5. 选择 Store secret (存储密钥)。

    6. 当您检查设置时，请记下要在此示例中稍后使用的ARN。

    有关更多信息，请参阅什么是 Amazon Secrets Manager？

  3. 在您创建容量预留Amazon CodeBuild控制台中的项目， CodeBuild 为您附加所需的权限。如果您使用的是 DefaultEncryptionKey 之外的 Amazon KMS 密钥，您必须将其添加到服务角色。有关更多信息，请参阅 。修改角色（控制台）在里面IAM 用户指南.

    要使您的服务角色与 Secrets Manager 结合使用，它必须至少具有secretsmanager:GetSecretValue权限。

  4. 要使用控制台创建一个具有在私有注册表中存储的环境的项目，请在创建项目时执行以下操作。有关信息，请参阅创建构建项目 (控制台)。

    注意

    如果您的私有注册表位于您的 VPC 中，则它必须具有公共互联网访问权限。 CodeBuild 无法从 VPC 中的私有 IP 地址提取镜像。

    1. 在环境中，选择自定义映像。

    2. 对于 Environment type (环境类型)，选择 Linux 或 Windows。

    3. 对于自定义映像类型，选择其他位置。

    4. 中其他地点，输入图片位置以及您的 Secrets Manager 证书的 ARN 或名称。

      注意

      如果您的凭证在当前区域中不存在，则必须使用 ARN。如果凭证存在于其他区域中，则无法使用凭证名称。