批量运行构建

您可以使用使用批量生成 AWS CodeBuild 来运行项目的并行和协调生成。

安全角色

批量构建为批量配置引入了全新的安全角色。这个新角色是必需的，因为 CodeBuild 必须能够代表你调用StartBuildStopBuild、和RetryBuild操作才能将生成作为批处理的一部分运行。客户应该使用新角色，而不是他们在构建中使用的角色，原因有两个：

• 向构建角色授予 StartBuild、StopBuild 和 RetryBuild 权限后，将允许单个构建通过 buildspec 启动多个构建。

• CodeBuild 批处理生成提供了限制，限制了可用于批次构建的生成数量和计算类型。如果构建角色拥有这些权限，则构建本身就有可能绕过这些限制。

批量构建类型

CodeBuild 支持以下批量构建类型：

批量构建类型

• 构建图
• 构建列表
• 构建矩阵

构建图

构建图定义了一组任务，这些任务依赖于批量处理中的其他任务。

以下示例定义了构建图，展示如何创建依赖项链。

batch:
  fast-fail: false
  build-graph:
    - identifier: build1
      env:
        variables:
          BUILD_ID: build1
      ignore-failure: false
    - identifier: build2
      buildspec: build2.yml
      env:
        variables:
          BUILD_ID: build2
      depend-on:
        - build1
    - identifier: build3
      env:
        variables:
          BUILD_ID: build3
      depend-on:
        - build2

在本示例中：

• 先运行 build1，因为它没有依赖项。

• 由于 build2 对 build1 存在依赖关系，因此 build2 会在完成 build1 后运行。

• 由于 build3 对 build2 存在依赖关系，因此 build3 会在完成 build2 后运行。

有关构建图 buildspec 语法的更多信息，请参阅batch/build-graph。

构建列表

构建列表定义了多个并行运行的任务。

以下示例定义了构建列表。build1 和 build2 构建将并行运行。

batch:
  fast-fail: false
  build-list:
    - identifier: build1
      env:
        variables:
          BUILD_ID: build1
      ignore-failure: false
    - identifier: build2
      buildspec: build2.yml
      env:
        variables:
          BUILD_ID: build2
      ignore-failure: true

有关构建列表 buildspec 语法的更多信息，请参阅batch/build-list。

构建矩阵

构建矩阵定义了具有不同配置且并行运行的任务。 CodeBuild 为每种可能的配置组合创建单独的版本。

以下示例显示了一个具有两个 buildspec 文件和三个环境变量值的构建矩阵。

batch:
  build-matrix:
    static:
      ignore-failure: false
    dynamic:
      buildspec: 
        - matrix1.yml
        - matrix2.yml
      env:
        variables:
          MY_VAR:
            - VALUE1
            - VALUE2
            - VALUE3

在此示例中， CodeBuild 创建了六个版本：

• matrix1.yml 与 $MY_VAR=VALUE1

• matrix1.yml 与 $MY_VAR=VALUE2

• matrix1.yml 与 $MY_VAR=VALUE3

• matrix2.yml 与 $MY_VAR=VALUE1

• matrix2.yml 与 $MY_VAR=VALUE2

• matrix2.yml 与 $MY_VAR=VALUE3

每个构建都将具有以下设置：

• ignore-failure 设置为 false

• env/type 设置为 LINUX_CONTAINER

• env/image 设置为 aws/codebuild/amazonlinux2-x86_64-standard:4.0

• env/privileged-mode 设置为 true

这些构建并行运行。

有关构建矩阵 buildspec 语法的更多信息，请参阅batch/build-matrix。

批量报告模式

如果您的项目的源提供商是 Bitbucket GitHub、或 E GitHub nterprise，并且您的项目配置为向源提供商报告构建状态，则可以选择如何将批量生成状态发送给源提供商。您可以选择将状态作为批处理的单个汇总状态报告发送，也可以单独报告批处理中每个构建的状态。

有关更多信息，请参阅以下主题：

• 批量配置（创建）

• 批量配置（更新）

更多信息

有关更多信息，请参阅以下主题：

• 批量构建 buildspec 参考

• 批量配置

• 运行批量构建 (AWS CLI)

• 停止批量构建 AWS CodeBuild