“将 Docker 映像发布到亚马逊 ECR 镜像存储库” 示例 CodeBuild

要运行此示例，请执行以下操作：

1. 如果 Amazon ECR 中已存在要使用的映像存储库，请跳至第 3 步。否则，如果您使用的是用户而不是 Amazon 根账户或管理员用户来使用 Amazon ECR，请将此语句（介于### BEGIN ADDING STATEMENT HERE ###和之间### END ADDING STATEMENT HERE ###）添加到用户（或用户关联的 IAM 群组）。不建议使用 Amazon 根账户。此语句允许创建用于存储 Docker 镜像的 Amazon ECR 存储库。为了简洁起见，也为了帮您查找添加语句的位置，此处使用了省略号 (...)。请勿删除任何语句，也不要将这些省略号键入策略中。有关更多信息，请参阅《用户指南》中的通过 Amazon Web Services Management Console使用内联策略。

   {
     "Statement": [
       ### BEGIN ADDING STATEMENT HERE ###
       {
         "Action": [
           "ecr:CreateRepository"
         ],
         "Resource": "*",
         "Effect": "Allow"
       },
       ### END ADDING STATEMENT HERE ###
       ...
     ],
     "Version": "2012-10-17"
   }

   注意

   修改该策略的 IAM 实体必须拥有在 IAM 中修改策略的权限。

2. 在 Amazon ECR 中创建映像存储库。请务必在创建构建环境和运行构建的同一 Amazon 区域创建存储库。有关更多信息，请参阅《Amazon ECR 用户指南》中的创建存储库。该存储库的名称必须与您将在此过程的稍后部分指定的存储库名称相匹配，并以 IMAGE_REPO_NAME 环境变量的形式表示。确保 Amazon ECR 存储库策略为您的 CodeBuild服务 IAM 角色授予图片推送访问权限。

3. 将此语句（介于### BEGIN ADDING STATEMENT HERE ###和之间### END ADDING STATEMENT HERE ###）添加到您附加到 Amazon CodeBuild 服务角色的策略中。此声明允许将 Docker 镜像上传 CodeBuild 到亚马逊 ECR 存储库。为了简洁起见，也为了帮您查找添加语句的位置，此处使用了省略号 (...)。请勿删除任何语句，也不要将这些省略号键入策略中。

   {
     "Statement": [
       ### BEGIN ADDING STATEMENT HERE ###
       {
         "Action": [
           "ecr:BatchCheckLayerAvailability",
           "ecr:CompleteLayerUpload",
           "ecr:GetAuthorizationToken",
           "ecr:InitiateLayerUpload",
           "ecr:PutImage",
           "ecr:UploadLayerPart"
         ],
         "Resource": "*",
         "Effect": "Allow"
       },
       ### END ADDING STATEMENT HERE ###
       ...
     ],
     "Version": "2012-10-17"
   }

   注意

   修改该策略的 IAM 实体必须拥有在 IAM 中修改策略的权限。

4. 按照本主题目录结构和文件部分所述创建文件，然后将其上传到 S3 输入存储桶或 Amazon CodeCommit GitHub、或 Bitbucket 存储库。有关更多信息，请参阅《Amazon CodePipeline 用户指南》中的映像定义文件参考。

   重要

   请不要上传 (root directory name)，而只上传 (root directory name) 中的文件。

   如果您使用的是 S3 输入存储桶，请务必创建一个包含这些文件的 ZIP 文件，然后将其上传到输入存储桶。请不要将 (root directory name) 添加到 ZIP 文件中，而只添加 (root directory name) 中的文件。

5. 创建构建项目、运行构建和查看构建信息。

   如果您使用控制台创建项目：

   1. 对于操作系统，选择 Ubuntu。

   2. 对于运行时，选择标准。

   3. 对于 “图像”，选择:5.0 aws/codebuild/standard。

   4. 添加以下环境变量：

      • AWS_DEFAULT_REGION 值为 region-ID

      • AWS_ACCOUNT_ID 值为 account-ID

      • 具有最新值的 IMAGE_TAG

      • IMAGE_REPO_NAME 的值为 Amazon-ECR-repo-name

   如果您使用创建构建项目，则create-project命令的 JSON 格式输入可能与此类似。 Amazon CLI (请将占位符替换为您自己的值。)

   {
     "name": "sample-docker-project",
     "source": {
       "type": "S3",
       "location": "codebuild-region-ID-account-ID-input-bucket/DockerSample.zip"
     },
     "artifacts": {
       "type": "NO_ARTIFACTS"
     },
     "environment": {
       "type": "LINUX_CONTAINER",
       "image": "aws/codebuild/standard:5.0",
       "computeType": "BUILD_GENERAL1_SMALL",
       "environmentVariables": [
         {
           "name": "AWS_DEFAULT_REGION",
           "value": "region-ID"
         },
         {
           "name": "AWS_ACCOUNT_ID",
           "value": "account-ID"
         },
         {
           "name": "IMAGE_REPO_NAME",
           "value": "Amazon-ECR-repo-name"
         },
         {
           "name": "IMAGE_TAG",
           "value": "latest"
         }
       ],
     },
     "serviceRole": "arn:aws:iam::account-ID:role/role-name",
     "encryptionKey": "arn:aws:kms:region-ID:account-ID:key/key-ID"
   }

6. 确认 CodeBuild 已成功将 Docker 镜像推送到存储库：

   1. 打开 Amazon ECR 控制台，网址为https://console.aws.amazon.com/ecr/。

   2. 选择存储库名称。映像应在映像标签列中列出。