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

批量构建规范参考

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

batch

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

批处理/fast-fail

可选。

false

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

true

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

默认情况下,所有批处理构建任务都使用构建规范文件中指定的构建设置(如 envphases)运行。您可以通过在 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

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