运行构建 (Amazon CLI)

使用以下方法之一运行 start-build 命令：

aws codebuild start-build --project-name <project-name>

如果您要运行的构建项目使用的是最新版本的构建输入项目和构建项目现有设置，请使用此方法。

aws codebuild start-build --generate-cli-skeleton

如果您要运行的构建具有早期版本的构建输入项目，或者如果您要覆盖构建输出项目、环境变量、构建规范或默认构建超时期限的设置，请使用此方法。

如果您运行具有 --project-name 选项的 start-build 命令，请将 <project-name> 替换为构建项目的名称，然后跳至此过程中的第 6 步。要获取构建项目的列表，请参阅查看构建项目名称的列表。

如果您运行带 --idempotency-token 选项的 start-build 命令，则 start-build 请求将附带区分大小写的唯一标识符或令牌。令牌在发出请求后的 5 分钟内有效。如果您重复发出带相同令牌的 start-build 请求，但更改了参数，则 CodeBuild 会返回“参数不匹配”错误。

如果您运行具有 --generate-cli-skeleton 选项的 start-build 命令，则采用 JSON 格式的数据将出现在输出中。将数据复制到本地计算机上或安装 Amazon CLI 的实例上某位置处的文件（如 start-build.json）中。修改所复制的数据，使其符合以下格式，然后保存结果：

{
  "projectName": "projectName",
  "sourceVersion": "sourceVersion",
  "artifactsOverride": {
    "type": "type",
    "location": "location",
    "path": "path",
    "namespaceType": "namespaceType",
    "name": "artifactsOverride-name",
    "packaging": "packaging"
  },
  "buildspecOverride": "buildspecOverride",
  "cacheOverride": {
    "location": "cacheOverride-location",
    "type": "cacheOverride-type"
  },
  "certificateOverride": "certificateOverride",
  "computeTypeOverride": "computeTypeOverride",
  "environmentTypeOverride": "environmentTypeOverride",
  "environmentVariablesOverride": {
    "name": "environmentVariablesOverride-name",
    "value": "environmentVariablesValue",
    "type": "environmentVariablesOverride-type"
  },
  "gitCloneDepthOverride": "gitCloneDepthOverride",
  "imageOverride": "imageOverride",
  "idempotencyToken": "idempotencyToken",
  "insecureSslOverride": "insecureSslOverride",
  "privilegedModeOverride": "privilegedModeOverride",
  "queuedTimeoutInMinutesOverride": "queuedTimeoutInMinutesOverride",
  "reportBuildStatusOverride": "reportBuildStatusOverride",
  "timeoutInMinutesOverride": "timeoutInMinutesOverride",
  "sourceAuthOverride": "sourceAuthOverride",
  "sourceLocationOverride": "sourceLocationOverride",
  "serviceRoleOverride": "serviceRoleOverride",
  "sourceTypeOverride": "sourceTypeOverride"
}

替换以下占位符：

我们建议您将具有敏感值（例如 Amazon 访问密钥 ID、Amazon 秘密访问密钥或密码）的环境变量作为参数存储在 Amazon EC2 Systems Manager Parameter Store 中。如果 Amazon EC2 Systems Manager Parameter Store 中存储的参数的名称以 /CodeBuild/ 开头 (例如，/CodeBuild/dockerLoginPassword)，则 CodeBuild 可以使用该参数。您可以使用 CodeBuild 控制台在 Amazon EC2 Systems Manager 中创建参数。选择创建参数，然后按照说明操作。（在该对话框中，对于 KMS 密钥，您可以选择性指定您账户中的 Amazon KMS 密钥的 ARN。Amazon EC2 Systems Manager 使用此密钥在存储过程中加密参数的值并在检索过程中解密参数的值。） 如果您使用 CodeBuild 控制台创建参数，控制台将在参数被存储时以 /CodeBuild/ 作为它的开头。但是，如果您使用 Amazon EC2 Systems Manager Parameter Store 控制台创建参数，则必须使用以 /CodeBuild/ 开头的参数名称，且必须将类型设置为安全字符串。有关更多信息，请参阅《Amazon EC2 Systems Manager 用户指南》中的 Amazon Systems Manager Parameter Store 和演练：创建和测试参数（控制台）。

如果您的构建项目引用了 Amazon EC2 Systems Manager Parameter Store 中存储的参数，则构建项目的服务角色必须允许 ssm:GetParameters 操作。如果您之前选择了在账户中创建新服务角色，则 CodeBuild 将自动在您的构建项目的默认服务角色中包含此操作。但是，如果您选择了 Choose an existing service role from your account，则必须将此操作单独包含在您的服务角色中。

您设置的环境变量将替换现有的环境变量。例如，如果 Docker 映像已经包含一个名为 MY_VAR 的环境变量 (值为 my_value)，并且您设置了一个名为 MY_VAR 的环境变量 (值为 other_value)，那么 my_value 将被替换为 other_value。同样，如果 Docker 映像已经包含一个名为 PATH 的环境变量 (值为 /usr/local/sbin:/usr/local/bin)，并且您设置了一个名为 PATH 的环境变量 (值为 $PATH:/usr/share/ant/bin)，那么/usr/local/sbin:/usr/local/bin 将被替换为文本值 $PATH:/usr/share/ant/bin。

请勿使用以 CODEBUILD_ 打头的名称设置任何环境变量。此前缀是专为内部使用预留的。

如果具有相同名称的环境变量在多处都有定义，则将按照如下方式确定环境变量的值：

有关这些占位符的有效值的信息，请参阅创建构建项目 (Amazon CLI)。有关构建项目的最新设置列表，请参阅查看构建项目的详细信息。

切换到包含您刚才保存的文件的目录，然后再次运行 start-build 命令。

aws codebuild start-build --cli-input-json file://start-build.json

如果成功，与运行构建 过程中所述内容类似的数据将出现在输出中。