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

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

创建构建项目 (Amazon CLI)

有关将 Amazon CLI 与 CodeBuild 结合使用的更多信息，请参阅命令行参考。

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

创建 JSON 文件

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

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>
}

替换以下内容：

名称

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

description

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

source

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

次要来源

可选。一系列的ProjectSource包含有关构建项目辅助源信息的对象。您最多可以添加 12 个辅助来源。的secondarySources对象使用的属性与使用的属性相同source对象。在辅助源对象中，sourceIdentifier是必填的。

secondarySourceVersions

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

源版本

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

如果在构建级别指定 sourceVersion，则该版本将优先于此 sourceVersion（在对象级别）。有关更多信息，请参阅使用 Amazon CodeBuild 的源版本示例：

人工制品

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

次要工件

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

缓存

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

环境

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

serviceRole

必需。服务角色的 ARNCodeBuild用于代表用户与服务进行交互（例如，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。

加密密钥

可选。的别名或 ARNAmazon KMS key由CodeBuild对构建输出进行加密。如果您指定别名，请使用格式 arn:aws:kms:region-ID:account-ID:key/key-ID，或者，如果存在别名，请使用格式 alias/key-alias。如果未指定，Amazon使用亚马逊 S3 的托管 KMS 密钥。

标签

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

VPCConfig

可选。一个VpcConfig对象，其中包含有关您的项目 VPC 配置的信息。有关更多信息，请参阅使用Amazon CodeBuild使用亚马逊虚拟私有云：

这些属性包括：

已启用徽章

可选。指定是否在你的 build 徽章中包含构建徽章CodeBuild项目。设置为true启用构建徽章，或false否则。有关更多信息，请参阅使用 CodeBuild 构建徽章示例：

日志配置

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

fileSystemLocations

可选。一系列的ProjectFileSystemsLocation包含有关您的 Amazon EFS 配置信息的对象。

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)。