第 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:4.0",
       "computeType": "BUILD_GENERAL1_SMALL"
     },
     "serviceRole": "serviceIAMRole"
   }

   ReplaceserviceIAMRole使用的 Amazon 资源名称 (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)。

   • 适用于environment、image是一个必需值，表示此构建项目使用的 Docker 映像名称和标签组合，由 Docker 映像存储库类型指定 (在本示例中为：aws/codebuild/standard:4.0在中获取 Docker 镜像 CodeBuild Docker 映像存储库）。aws/codebuild/standard是 Docker 镜像的名称。4.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) 为可选的值。本教程中未使用这些值，因此它们没有在这里显示。有关更多信息，请参阅 创建构建项目 (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: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表示客户托管密钥的 ARN， CodeBuild 用于加密构建输出构件。

     • arn 表示构建项目的 ARN。