本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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
有关更多信息,请参阅构建矩阵。