步骤 5: 创建构建项目

创建构建项目

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

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

   输出中将显示 JSON 格式的数据。将数据复制到已安装 AWS 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/amazonlinux2-x86_64-standard:3.0",
       "computeType": "BUILD_GENERAL1_SMALL"
     },
     "serviceRole": "serviceIAMRole"
   }

   Replace serviceIAMRole 替换为 CodeBuild 服务角色的 Amazon 资源名称 (ARN)(例如,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 是目前唯一允许的值)。

   • 对于 environment,image 是一个必需值,表示此构建项目使用的 Docker 映像名称和标签组合,由 Docker 映像存储库类型指定(在本示例中,aws/codebuild/standard:4.0 表示 CodeBuild Docker 映像存储库中的 Docker 映像)。aws/codebuild/standard 是 Docker 映像的名称。1.0 是 Docker 镜像的标签。

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

   • 对于 environment，computeType 是一个必需值，表示 CodeBuild 将会使用的计算资源（在本示例中为 BUILD_GENERAL1_SMALL）。

   注意

   原始 JSON 格式的数据中的其他可用值(如 description、buildspec、auth(包括 type 和 resource)、path、namespaceType、name(对于 artifacts)、packaging、environmentVariables(包括 name 和 value)、timeoutInMinutes、encryptionKey 和 tags(包括 key 和 value)是可选的。本教程中未使用这些值，因此它们没有在这里显示。有关更多信息，请参阅创建构建项目 (AWS 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:4.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 用于加密生成输出项目的 AWS KMS 客户主密钥 (CMK) 的 ARN。

     • arn 表示构建项目的 ARN。