步骤 5：创建构建项目

创建构建项目

1. 使用 Amazon CLI 运行 create-project 命令：

   aws codebuild create-project --generate-cli-skeleton

   输出中将显示 JSON 格式的数据。将数据复制到已安装 Amazon CLI 的本地计算机或实例上某个位置的名为 create-project.json 的文件中。如果您选择使用其他文件名，请务必在本教程中使用该名称。

   按照以下格式修改所复制的数据，然后保存结果：

   {
     "name": "codebuild-demo-project",
     "source": {
       "type": "S3",
       "location": "codebuild-region-ID-account-ID-input-bucket/MessageUtil.zip"
     },
     "artifacts": {
       "type": "S3",
       "location": "codebuild-region-ID-account-ID-output-bucket"
     },
     "environment": {
       "type": "LINUX_CONTAINER",
       "image": "aws/codebuild/standard:5.0",
       "computeType": "BUILD_GENERAL1_SMALL"
     },
     "serviceRole": "serviceIAMRole"
   }

   将 s er viceiamRole 替换为服务角色的亚马逊资源名称 (ARN)（ CodeBuild 例如）。arn:aws:iam::account-ID:role/role-name要创建该文件，请参阅 创建 CodeBuild 服务角色。

   在此数据中：

   • name 表示此构建项目的必需标识符（在本示例中为 codebuild-demo-project）。构建项目名称在您账户的所有构建项目中必须是唯一的。

   • 对于 source，type 是一个必需值，表示源代码的存储库类型（在本示例中，S3 表示 Amazon S3 存储桶)。

   • 对于 source，location 表示源代码的路径（在本示例中，为输入存储桶名称后跟 ZIP 文件名称）。

   • 对于 artifacts，type 是一个必需值，表示构建输出构件的存储库类型（在本示例中，S3 表示 Amazon S3 存储桶）。

   • 对于 artifacts，location 表示您先前创建或识别的输出存储桶的名称（在本示例中为 codebuild-region-ID-account-ID-output-bucket）。

   • 对于 environment，type 是表示构建环境类型的必填值（在本例中为 LINUX_CONTAINER）。

   • f image o environment r，是必填值，它表示此构建项目使用的 Docker 映像名称和标签组合，由 Docker 镜像存储库类型指定（在本示例中，aws/codebuild/standard:5.0对于 Docker 镜像存储库中的 Docker 镜像）。 CodeBuild aws/codebuild/standard是 Docker 镜像的名称。 5.0是 Docker 镜像的标签。

     要查找您可以在自己方案中使用的更多 Docker 映像，请参阅构建环境参考。

   • F computeType orenvironment，是一个必填值，它表示 CodeBuild 使用的计算资源（在本例中为BUILD_GENERAL1_SMALL）。

   注意

   原始 JSON 格式数据中的其他可用值，如 description、buildspec、auth (包括 type 和 resource)、path、namespaceType、name (对于 artifacts)、packaging、environmentVariables (包括 name 和 value)、timeoutInMinutes、encryptionKey 和 tags (包括 key 和 value) 为可选的值。本教程中未使用这些值，因此它们没有在这里显示。有关更多信息，请参阅创建构建项目 (Amazon CLI)。

2. 切换到您刚才保存的文件所在的目录，然后再次运行 create-project 命令。

   aws codebuild create-project --cli-input-json file://create-project.json

   如果成功，输出中将显示与此类似的数据。

   {
     "project": {
       "name": "codebuild-demo-project",
       "serviceRole": "serviceIAMRole",
       "tags": [],
       "artifacts": {
         "packaging": "NONE",
         "type": "S3",
         "location": "codebuild-region-ID-account-ID-output-bucket",
         "name": "message-util.zip"
       },
       "lastModified": 1472661575.244,
       "timeoutInMinutes": 60,
       "created": 1472661575.244,
       "environment": {
         "computeType": "BUILD_GENERAL1_SMALL",
         "image": "aws/codebuild/standard:5.0",
         "type": "LINUX_CONTAINER",
         "environmentVariables": []
       },
       "source": {
         "type": "S3",
         "location": "codebuild-region-ID-account-ID-input-bucket/MessageUtil.zip"
       },
       "encryptionKey": "arn:aws:kms:region-ID:account-ID:alias/aws/s3",
       "arn": "arn:aws:codebuild:region-ID:account-ID:project/codebuild-demo-project"
     }
   }

   • project 表示有关此构建项目的信息。

     • tags 表示已经声明的所有标签。

     • packaging 表示构建输出构件将如何存储在输出存储桶中。NONE 表示在输出存储桶中创建文件夹。构建输出构件存储在该文件夹中。

     • lastModified 表示构建项目最后一次更改的时间，采用 Unix 时间格式。

     • timeoutInMinutes表示如果构建尚未完成，则在该分钟后 CodeBuild 停止构建。（默认为 60 分钟。）

     • created 表示构建项目的创建时间，采用 Unix 时间格式。

     • environmentVariables表示已声明且可在构建期间使用的任何环境变量。 CodeBuild

     • encryptionKey表示 CodeBuild 用于加密生成输出工件的客户托管密钥的 ARN。

     • arn 表示构建项目的 ARN。