批量构建规范参考 - AWS CodeBuild
batchbatch/build-graphbatch/build-listbatch/build-matrix
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

批量构建规范参考

本主题包含批处理构建属性的构建规范参考。

batch

可选的映射。项目的批处理构建设置。

批处理/fast-fail

可选。

false

默认值。所有正在运行的构建都将完成。

true

如果其中一个构建失败,将停止所有正在运行的构建。

默认情况下,所有批处理构建任务都使用构建规范文件中指定的构建设置(如 env 和 phases)运行。您可以通过在 env 参数中指定不同的 batch/<batch-type>/buildspec 值或不同的构建规范文件来覆盖默认构建设置。

属性的内容因指定的批量构建类型而异。batch可能的批处理构建类型为:

batch/build-graph

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

batch/build-graph/buildspec

可选。要用于此任务的 buildspec 文件的路径和文件名。

batch/build-graph/dependency-on

此任务依赖的任务标识符的数组。此任务在这些任务完成之前不会运行。

batch/build-graph/env

可选。构建环境将覆盖任务。

batch/build-graph/env/compute-type

要用于任务的计算类型的标识符。有关可能的值,请参阅 中的 computeType构建环境计算类型。

batch/build-graph/env/image (批/生成图表/env/映像)

要用于任务的映像的标识符。有关可能的值,请参阅 中的映像标识符CodeBuild 提供的 Docker 映像。

batch/build-graph/env/privileged-mode

可选。一个布尔值,指示是否在 Docker 容器内运行 Docker 守护程序。仅当构建项目用于构建 Docker 映像时,才设置为 true。否则，尝试与 Docker 守护程序进行交互的构建将失败。默认设置为 false。

batch/build-graph/env/类型

要用于任务的环境类型的标识符。有关可能的值,请参阅 中的环境类型构建环境计算类型。

batch/build-graph/env/变量

构建环境中将存在的环境变量。有关更多信息,请参阅env/variables。

batch/build-graph/identifier

必填项。任务的标识符。

batch/build-graph/ignore-failure

可选。一个布尔值,指示是否可以忽略批处理中的故障。

false

默认值。如果一个生成任务失败,则批处理生成将失败。

true

如果一个生成任务失败,其余生成任务仍将运行。

以下是构建图构建规范条目的示例:

batch:
  fast-fail: false
  build-graph:
    - identifier: build1
      env:
        compute-type: BUILD_GENERAL1_SMALL
    - identifier: build2
      env:
        compute-type: BUILD_GENERAL1_MEDIUM
      depend-on:
        - build1
    - identifier: build3
      env:
        compute-type: BUILD_GENERAL1_LARGE
      depend-on:
        - build2

有关更多信息，请参阅生成图。

batch/build-list

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

batch/build-list/buildspec

可选。要用于此任务的 buildspec 文件的路径和文件名。

batch/build-list/env

可选。构建环境将覆盖任务。

batch/build-list/env/compute-type

要用于任务的计算类型的标识符。有关可能的值,请参阅 中的 computeType构建环境计算类型。

batch/build-list/env/image (批/构建列表/env/映像)

要用于任务的映像的标识符。有关可能的值,请参阅 中的映像标识符CodeBuild 提供的 Docker 映像。

batch/build-list/env/privileged-mode

可选。一个布尔值,指示是否在 Docker 容器内运行 Docker 守护程序。仅当构建项目用于构建 Docker 映像时,才设置为 true。否则，尝试与 Docker 守护程序进行交互的构建将失败。默认设置为 false。

batch/build-list/env/类型

要用于任务的环境类型的标识符。有关可能的值,请参阅 中的环境类型构建环境计算类型。

batch/build-list/env/变量

构建环境中将存在的环境变量。有关更多信息,请参阅env/variables。

batch/build-list/identifier

可选。任务的标识符。

batch/build-list/ignore-failure

可选。一个布尔值,指示是否可以忽略批处理中的故障。

false

默认值。如果一个生成任务失败,则批处理生成将失败。

true

如果一个生成任务失败,其余生成任务仍将运行。

以下是构建列表构建规范条目的示例:

batch:
  fast-fail: false
  build-list:
    ignore-failure: true
      - identifier: linux_small
        env:
          compute-type: BUILD_GENERAL1_SMALL
      - identifier: windows_medium
        env:
          type: WINDOWS_SERVER_2019_CONTAINER
          image: aws/codebuild/windows-base:2019-1.0
          compute-type: BUILD_GENERAL1_MEDIUM

有关更多信息，请参阅内部版本列表。

batch/build-matrix

定义构建矩阵。构建矩阵用于定义将与其他环境并行运行的任务。CodeBuild 为每个可能的环境配置创建一个单独的构建。

batch/build-matrix/static

静态属性适用于所有生成任务。

batch/build-matrix/static/ignore-failure

可选。一个布尔值,指示是否可以忽略批处理中的故障。

false

默认值。如果一个生成任务失败,则批处理生成将失败。

true

如果一个生成任务失败,其余生成任务仍将运行。

batch/build-matrix/static/env

可选。构建环境将覆盖任务。

batch/build-matrix/static/env/特权模式

可选。一个布尔值,指示是否在 Docker 容器内运行 Docker 守护程序。仅当构建项目用于构建 Docker 映像时,才设置为 true。否则，尝试与 Docker 守护程序进行交互的构建将失败。默认设置为 false。

batch/build-matrix/static/env/类型

可选。要用于任务的环境类型的标识符。有关可能的值,请参阅 中的环境类型构建环境计算类型。

batch/build-matrix/动态

动态属性定义构建矩阵。

batch/build-matrix/dynamic/buildspec

可选。要用于此任务的 buildspec 文件的路径和文件名。

batch/build-matrix/dynamic/env

可选。构建环境将覆盖任务。

batch/build-matrix/dynamic/env/compute-type

要用于任务的计算类型的标识符。有关可能的值,请参阅 中的 computeType构建环境计算类型。

batch/build-matrix/dynamic/env/image

可选。要用于任务的映像的标识符。有关可能的值,请参阅 中的映像标识符CodeBuild 提供的 Docker 映像。

batch/build-matrix/dynamic/env/变量

构建环境中将存在的环境变量。有关更多信息,请参阅env/variables。

以下是构建矩阵构建规范条目的示例:

batch:
  build-matrix:
    static:
      ignore-failure: false
      env:
        type: LINUX_CONTAINER
        privileged-mode: true
    dynamic:
      env:
        image:
          - aws/codebuild/amazonlinux2-x86_64-standard:3.0
          - aws/codebuild/windows-base:2019-1.0
        variables:
          MY_VAR:
            - VALUE1
            - VALUE2
            - VALUE3

有关更多信息，请参阅生成矩阵。