Batch 构建 buildspec 参考 - Amazon CodeBuild
批处理batch/build-graphbatch/build-listbatch/build-matrix
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 Amazon Web Services 服务入门。

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

Batch 构建 buildspec 参考

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

批处理

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

批处理/快速失败

可选。指定一个或多个构建任务失败时批量构建的行为。

false

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

true

当其中一个构建任务失败时，所有正在运行的构建都将停止。

默认情况下，所有批量构建任务都使用构建设置运行，例如env和phases，在构建规范文件中指定。可以覆盖默认构建设置，方法是指定不同的env中的值或不同的 buildspec 文件batch/<batch-type>/buildspec参数。

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

batch/build-graph

定义构建图表. 构建图定义了一组与批处理中的其他任务有依赖关系的任务。有关更多信息，请参阅构建图。

此元素包含一组构建任务。每个构建任务包含以下属性。

标识符

必填项。任务的标识符。

构建规范

可选。用于此任务的构建规范文件的路径和文件名。如果未指定此参数，将使用当前构建规范文件。

调试会话

可选。一个布尔值，指示是否对此批处理构建启用会话调试。有关会话调试的更多信息，请参阅在会话管理器中查看正在运行的版本.

false

会话调试已禁用。

true

会话调试已启用。

取决于

可选。此任务所依赖的任务标识符数组。在这些任务完成之前，此任务才会运行。

env

可选。构建环境将覆盖任务。这可以包含以下属性：

计算类型

用于任务的计算类型的标识符。请参阅computeType在构建环境计算类型获取可能的值。

映像

用于任务的映像的标识符。请参阅映像标识符在提供的 Docker 映像 CodeBuild获取可能的值。

特权模式

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

type

要用于任务的环境类型的标识符。请参阅环境类型在构建环境计算类型获取可能的值。

变量

构建环境中将出现的环境变量。参阅 env/variables 了解更多信息。

忽略失败

可选。一个布尔值，指示是否可以忽略此构建任务的失败。

false

默认值。如果此构建任务失败，批量构建将失败。

true

如果此构建任务失败，批量构建仍可以成功。

下面是构建图构建规范条目示例。

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

batch/build-list

定义构建列表. 构建列表用于定义一些并行运行的任务。有关更多信息，请参阅构建列表。

此元素包含一组构建任务。每个构建任务包含以下属性。

标识符

必填项。任务的标识符。

构建规范

可选。用于此任务的构建规范文件的路径和文件名。如果未指定此参数，将使用当前构建规范文件。

调试会话

可选。一个布尔值，指示是否对此批处理构建启用会话调试。有关会话调试的更多信息，请参阅在会话管理器中查看正在运行的版本.

false

会话调试已禁用。

true

会话调试已启用。

env

可选。构建环境将覆盖任务。这可以包含以下属性：

计算类型

用于任务的计算类型的标识符。请参阅computeType在构建环境计算类型获取可能的值。

映像

用于任务的映像的标识符。请参阅映像标识符在提供的 Docker 映像 CodeBuild获取可能的值。

特权模式

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

type

要用于任务的环境类型的标识符。请参阅环境类型在构建环境计算类型获取可能的值。

变量

构建环境中将出现的环境变量。参阅 env/variables 了解更多信息。

忽略失败

可选。一个布尔值，指示是否可以忽略此构建任务的失败。

false

默认值。如果此构建任务失败，批量构建将失败。

true

如果此构建任务失败，批量构建仍可以成功。

下面是构建列表构建规范条目示例。

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

batch/build-matrix

定义构建矩阵. 构建矩阵定义了并行运行的具有不同配置的任务。CodeBuild 为每种可能的配置组合创建一个单独的构建。有关更多信息，请参阅构建矩阵。

静态的

静态属性适用于所有构建任务。

忽略失败

可选。一个布尔值，指示是否可以忽略此构建任务的失败。

false

默认值。如果此构建任务失败，批量构建将失败。

true

如果此构建任务失败，批量构建仍可以成功。

env

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

特权模式

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

type

要用于任务的环境类型的标识符。请参阅环境类型在构建环境计算类型获取可能的值。

动态

动态属性定义了构建矩阵。

构建规范

可选。一个数组，其中包含要用于这些任务的 buildspec 文件的路径和文件名。如果未指定此参数，将使用当前构建规范文件。

env

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

计算类型

一个数组，其中包含用于这些任务的计算类型的标识符。请参阅computeType在构建环境计算类型获取可能的值。

映像

一个数组，其中包含要用于这些任务的图像的标识符。请参阅映像标识符在提供的 Docker 映像 CodeBuild获取可能的值。

变量

一个数组，其中包含将存在于这些任务的构建环境中的环境变量。参阅 env/variables 了解更多信息。

下面是构建矩阵构建规范条目示例。

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

有关更多信息，请参阅构建矩阵。