Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

创建构建项目 (Amazon CLI)

有关Amazon CLI搭配使用的更多信息 CodeBuild，请参阅命令行参考。

要使用创建 CodeBuild 生成项目Amazon CLI，请创建 JSON 格式的项目结构，填写该结构，然后调用create-project命令来创建项目。

创建 JSON 文件

利用 create-project 命令和 --generate-cli-skeleton 选项创建骨架 JSON 文件：

aws codebuild create-project --generate-cli-skeleton > <json-file>

这将创建 JSON 文件，其路径和文件名由 <json-file> 指定。

填写 JSON 文件

按照下面所示修改 JSON 数据，并保存您的结果。

{
  "name": "<project-name>",
  "description": "<description>",
  "source": {
    "type": "CODECOMMIT" | "CODEPIPELINE" | "GITHUB" | "GITHUB_ENTERPRISE" | "BITBUCKET" | "S3" | "NO_SOURCE",
    "location": "<source-location>",
    "gitCloneDepth": "<git-clone-depth>",
    "buildspec": "<buildspec>",
    "InsecureSsl": "<insecure-ssl>",
    "reportBuildStatus": "<report-build-status>",
    "buildStatusConfig": {
      "context": "<context>",
      "targetUrl": "<target-url>"
    },
    "gitSubmodulesConfig": {
      "fetchSubmodules": "<fetch-submodules>"
    },
    "auth": {
      "type": "<auth-type>",
      "resource": "<auth-resource>"
    },
    "sourceIdentifier": "<source-identifier>"
  },
  "secondarySources": [
    {
        "type": "CODECOMMIT" | "CODEPIPELINE" | "GITHUB" | "GITHUB_ENTERPRISE" | "BITBUCKET" | "S3" | "NO_SOURCE",
        "location": "<source-location>",
        "gitCloneDepth": "<git-clone-depth>",
        "buildspec": "<buildspec>",
        "InsecureSsl": "<insecure-ssl>",
        "reportBuildStatus": "<report-build-status>",
        "auth": {
          "type": "<auth-type>",
          "resource": "<auth-resource>"
        },
        "sourceIdentifier": "<source-identifier>"
    }
  ],
  "secondarySourceVersions": [
    {
      "sourceIdentifier": "<secondary-source-identifier>",
      "sourceVersion": "<secondary-source-version>"
    }
  ],
  "sourceVersion": "<source-version>",
  "artifacts": {
    "type": "CODEPIPELINE" | "S3" | "NO_ARTIFACTS",
    "location": "<artifacts-location>",
    "path": "<artifacts-path>",
    "namespaceType": "<artifacts-namespacetype>",
    "name": "<artifacts-name>",
    "overrideArtifactName": "<override-artifact-name>",
    "packaging": "<artifacts-packaging>"
  },
  "secondaryArtifacts": [
    {
      "type": "CODEPIPELINE" | "S3" | "NO_ARTIFACTS",
      "location": "<secondary-artifact-location>",
      "path": "<secondary-artifact-path>",
      "namespaceType": "<secondary-artifact-namespaceType>",
      "name": "<secondary-artifact-name>",
      "packaging": "<secondary-artifact-packaging>",
      "artifactIdentifier": "<secondary-artifact-identifier>"
    }
  ],
  "cache": {
    "type": "<cache-type>",
    "location": "<cache-location>",
    "mode": [
      "<cache-mode>"
    ]
  },
  "environment": {
    "type": "LINUX_CONTAINER" | "LINUX_GPU_CONTAINER" | "ARM_CONTAINER" | "WINDOWS_SERVER_2019_CONTAINER",
    "image": "<image>",
    "computeType": "BUILD_GENERAL1_SMALL" | "BUILD_GENERAL1_MEDIUM" | "BUILD_GENERAL1_LARGE" | "BUILD_GENERAL1_2XLARGE",
    "certificate": "<certificate>",
    "environmentVariables": [
      {
        "name": "<environmentVariable-name>",
        "value": "<environmentVariable-value>",
        "type": "<environmentVariable-type>"
      }
    ],
    "registryCredential": [
      {
        "credential": "<credential-arn-or-name>",
        "credentialProvider": "<credential-provider>"
      }
    ],
    "imagePullCredentialsType": "CODEBUILD" | "SERVICE_ROLE",
    "privilegedMode": "<privileged-mode>"
  },
  "serviceRole": "<service-role>",
  "timeoutInMinutes": <timeout>,
  "queuedTimeoutInMinutes": <queued-timeout>,
  "encryptionKey": "<encryption-key>",
  "tags": [
    {
      "key": "<tag-key>",
      "value": "<tag-value>"
    }
  ],
  "vpcConfig": {
    "securityGroupIds": [
         "<security-group-id>"
    ],
    "subnets": [
         "<subnet-id>"
    ],
    "vpcId": "<vpc-id>"
  },
  "badgeEnabled": "<badge-enabled>",
  "logsConfig": {
    "cloudWatchLogs": {
      "status": "<cloudwatch-logs-status>",
      "groupName": "<group-name>",
      "streamName": "<stream-name>"
    },
    "s3Logs": {
      "status": "<s3-logs-status>",
      "location": "<s3-logs-location>",
      "encryptionDisabled": "<s3-logs-encryption-disabled>"
    }
  },
  "fileSystemLocations": [
    {
      "type": "EFS",
      "location": "<EFS-DNS-name-1>:/<directory-path>",
      "mountPoint": "<mount-point>",
      "identifier": "<efs-identifier>",
      "mountOptions": "<efs-mount-options>"
    }
  ],
  "buildBatchConfig": {
    "serviceRole": "<batch-service-role>",
    "combineArtifacts": <combine-artifacts>,
    "restrictions": {
      "maximumBuildsAllowed": <max-builds>,
      "computeTypesAllowed": [
        "<compute-type>"
      ]
    },
    "timeoutInMins": <batch-timeout>,
    "batchReportMode": "REPORT_AGGREGATED_BATCH" | "REPORT_INDIVIDUAL_BUILDS"
  },
  "concurrentBuildLimit": <concurrent-build-limit>
}

替换以下内容：

name

必需。此构建项目的名称。此名称在您的 Amazon 账户的所有构建项目中必须是唯一的。

描述

可选。此构建项目的描述。

源

必需。一个ProjectSource对象，其中包含有关此构建项目的源代码设置的信息。添加 source 对象后，可以使用 secondarySources 额外添加多达 12 个源。这些设置包括：

secondarySources

可选。包含有关构建项目辅助源信息的ProjectSource对象数组。最多可以添加 12 个辅助源。这些 secondarySources 对象使用的属性与源对象使用的属性相同。在辅助源对象中，sourceIdentifier 是必需项。

secondarySourceVersions

可选。ProjectSourceVersion 对象数组。如果在构建级别指定 secondarySourceVersions，则它们优先于此对象。

sourceVersion

可选。要为此项目构建的构建输入的版本。如果未指定，则使用最新版本。如果已指定，则它必须是下列项之一：

如果在构建级别指定 sourceVersion，则该版本将优先于此 sourceVersion（在项目级别）。有关更多信息，请参阅 源版本示例，包含 Amazon CodeBuild。

构件

必需。一个ProjectArtifacts对象，其中包含有关此构建项目的输出构件设置的信息。添加 artifacts 对象后，可以使用 secondaryArtifacts 额外添加最多 12 个构件。这些设置包括：

secondaryArtifacts

可选。包含有关构建项目的次要构件设置信息的ProjectArtifacts对象数组。最多可以添加 12 个辅助构件。secondaryArtifacts 使用的许多设置与 构件 对象相同。

cache

必需。一个ProjectCache对象，其中包含有关此构建项目的缓存设置的信息。有关更多信息，请参阅构建缓存。

environment

必需。一个ProjectEnvironment对象，其中包含有关此项目的构建环境设置的信息。这些设置包括：

serviceRole

必需。服务角色的 ARN CodeBuild 用于代表用户与服务进行交互（例如，arn:aws:iam::account-id:role/role-name）。

timeoutInMinutes

可选。5 到 480 分钟 (8 个小时) 之间的一个分钟数，在此时间后，如果构建未完成， CodeBuild 会将其停止。如果未指定，则使用默认值 60。要确定是否以及何时由于超时而 CodeBuild 停止构建，请运行batch-get-builds命令。要确定构建是否已停止，请在输出中查看 buildStatus 的值是否为 FAILED。要确定构建何时超时，请在输出中查看与 TIMED_OUT 的 phaseStatus 值关联的 endTime 值。

queuedTimeoutIn分钟

可选。分钟数，介于 5 到 480（8 小时）之间，如果仍在排队，则在该时间之后 CodeBuild停止构建。如果未指定，则使用默认值 60。

encryptionKey

可选。Amazon KMS key用于加密生成输出的 CodeBuild 别名或 ARN。如果您指定别名，请使用格式 arn:aws:kms:region-ID:account-ID:key/key-ID，或者，如果存在别名，请使用格式 alias/key-alias。如果未指定，则会使用 Amazon S3 的 Amazon 托管 KMS 密钥。

tags

可选。一组 Tag 对象，提供您要与此构建项目关联的标签。您最多可指定 50 个标签。任何支持 CodeBuild 构建项目标签的Amazon服务都可以使用这些标签。每个标签都表示为带有 key 和 value 的对象。

vpcConfig

可选。一个VpcConfig对象，其中包含有关您的项目 VPC 配置的信息信息。有关更多信息，请参阅将 Amazon CodeBuild 与 Amazon Virtual Private Cloud 结合使用。

这些属性包括：

badgeEnabled

可选。指定是否在 CodeBuild 项目中包含构建徽章。设置为 true 可启用构建徽章；设置为 false 可将其禁用。有关更多信息，请参阅 使用制作徽章示例 CodeBuild。

logsConfig

一个LogsConfig对象，其中包含有关此版本日志所在位置的信息。

fileSystemLocations

可选。包含有关您的 Amazon EFS 配置信息的ProjectFileSystemsLocation对象数组。

buildBatchConfig

可选。该buildBatchConfig对象是一个包含项目的批量生成配置信息的ProjectBuildBatchConfig结构。

concurrentBuildLimit

此项目允许的并发构建的最大数量。

仅当当前构建数量小于或等于此限值时，才会启动新构建。如果当前构建计数达到此限值，则新构建将受到限制且不会运行。

创建项目

要创建项目，请再次运行 create-project 命令，传递您的 JSON 文件：

aws codebuild create-project --cli-input-json file://<json-file>

如果成功，项目对象的 JSON 表示形式将显示在控制台输出中。有关此数据的示例，请参阅CreateProject 响应语法。

您稍后可以更改构建项目的任何设置，但构建项目名称除外。有关更多信息，请参阅更改构建项目的设置 (Amazon CLI)。

要开始运行构建，请参阅运行构建 (Amazon CLI)。

如果您的源代码存储在存储 GitHub 库中，并且您希望在每次将代码更改推送 CodeBuild 到存储库时都重新生成源代码，请参阅开始自动运行构建 (Amazon CLI)。