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

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

Batch 构建构建规范参考

本主题包含批量构建属性的构建规范引用。

batch

可选的映射。项目的批量生成设置。

批次/快速故障

可选。

false

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

true

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

默认情况下,所有批处理构建任务都使用构建设置(如envphases,在构建规范文件中指定。可以覆盖默认构建设置,方法是指定不同的env值或其他构建规范文件batch/<batch-type>/buildspec参数。

中的内容batch属性因指定的批量生成类型而异。可能的批处理构建类型包括:

batch/build-graph

定义生成图表。构建图定义了一组与批处理中其他任务具有依赖性的任务。有关更多信息,请参阅 生成图表

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

identifier

必填项。任务的标识符。

BuildSpec

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

调试会话

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

false

会话调试已禁用。

true

已启用会话调试。

相关

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

env

可选。生成环境将覆盖任务。此操作可以包含以下属性:

计算类型

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

image

要用于任务的映像的标识符。请参阅映像标识符inCodeBuild 提供的码头映像以获取可能的值。

特权模式

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

类型

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

variables

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

忽略失败

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

false

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

true

如果一个构建任务失败,剩余的构建任务仍将运行。

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

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

batch/build-list

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

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

identifier

必填项。任务的标识符。

BuildSpec

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

调试会话

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

false

会话调试已禁用。

true

已启用会话调试。

env

可选。生成环境将覆盖任务。此操作可以包含以下属性:

计算类型

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

image

要用于任务的映像的标识符。请参阅映像标识符inCodeBuild 提供的码头映像以获取可能的值。

特权模式

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

类型

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

variables

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

忽略失败

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

false

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

true

如果一个构建任务失败,剩余的构建任务仍将运行。

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

batch: fast-fail: false build-list: - identifier: linux_small env: compute-type: BUILD_GENERAL1_SMALL ignore-failure: true debug-session: true - 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 为每个可能的配置组合创建一个单独的构建。有关更多信息,请参阅 生成矩阵

静态

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

忽略失败

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

false

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

true

如果一个构建任务失败,剩余的构建任务仍将运行。

env

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

计算类型

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

image

要用于任务的映像的标识符。请参阅映像标识符inCodeBuild 提供的码头映像以获取可能的值。

特权模式

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

类型

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

variables

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

特权模式

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

类型

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

动态

动态属性定义构建矩阵。

BuildSpec

可选。包含用于这些任务的 buildspec 文件的路径和文件名的数组。如果未指定此参数,则使用当前构建规范文件。

env

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

计算类型

包含用于这些任务的计算类型标识符的数组。请参阅computeTypein构建环境计算类型以获取可能的值。

image

包含用于这些任务的映像标识符的数组。请参阅映像标识符inCodeBuild 提供的码头映像以获取可能的值。

variables

一个数组,其中包含将出现在这些任务的构建环境中的环境变量。请参阅env/variables有关更多信息,请参阅。

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

batch: build-matrix: static: ignore-failure: false env: type: LINUX_CONTAINER image: aws/codebuild/amazonlinux2-x86_64-standard:3.0 privileged-mode: true dynamic: buildspec: - matrix1.yml - matrix2.yml env: variables: MY_VAR: - VALUE1 - VALUE2 - VALUE3

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