运行构建 (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 格式的数据将出现在输出中。将数据复制到安装的本地计算机或实例上某个位置的文件（例如start-build.json）。 Amazon CLI 修改所复制的数据，使其符合以下格式，然后保存结果：

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

替换以下占位符：

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

如果您的构建项目引用存储在 Amazon S EC2 ystems 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

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