バッチビルド仕様参照 - AWS CodeBuild

バッチビルド仕様参照

このトピックでは、バッチビルドプロパティのビルドスペックリファレンスについて説明します。

batch

オプションのマッピング。プロジェクトのバッチビルド設定。

バッチ/fast-fail(ファストフェイル)

(オプション) ビルド グラフの場合、このプロパティは使用されず、常に true.

false

デフォルト値。実行中のすべてのビルドが完了します。

true

いずれかのビルドが失敗した場合、実行中のビルドはすべて停止します。

デフォルトでは、すべてのバッチビルドタスクは、 env および phases、buildspec ファイルで指定。デフォルトのビルド設定は、異なる env 値または異なる buildspec ファイル batch/<batch-type>/buildspec パラメータ。

_の内容 batch プロパティは、指定するバッチビルドのタイプによって異なります。可能なバッチビルドタイプは次のとおりです。

batch/build-graph

定義 グラフの作成. ビルドグラフは、バッチ内の他のタスクに依存するタスクのセットを定義します。

バッチ/ビルド-グラフ/ビルドスペック

(オプション) このタスクに使用する buildspec ファイルのパスとファイル名。

バッチ/ビルド-グラフ/依存

このタスクが依存するタスク識別子の配列。このタスクは、これらのタスクが完了するまで実行されません。

バッチ/ビルド-グラフ/環境

(オプション) ビルド環境は、タスクに対して上書きされます。

バッチ/ビルド-グラフ/env/計算タイプ

タスクに使用する計算タイプの識別子。参照 計算タイプ () ビルド環境のコンピューティングタイプ 可能な値。

バッチ/ビルド-グラフ/env/画像

タスクに使用する画像の識別子。参照 画像識別子 () CodeBuild に用意されている Docker イメージ 可能な値。

バッチ/ビルド-グラフ/env/特権モード

(オプション) Dockerコンテナ内でDockerデーモンを実行するかどうかを示すブール値。に設定 true 構築プロジェクトがDockerイメージの構築に使用される場合のみ。そうしないと、Docker デーモンとやり取りしようとするビルドは失敗します。デフォルトの設定は、false です。

バッチ/ビルド-グラフ/env/種類

タスクに使用する環境タイプの識別子。参照 環境タイプ () ビルド環境のコンピューティングタイプ 可能な値。

バッチ/ビルド-グラフ/env/変数

ビルド環境に存在する環境変数。詳細については、「env/variables」を参照してください。

バッチ/ビルド-グラフ/識別子

必須。タスクの識別子。

以下は、ビルドグラフビルドスペックエントリの例です。

batch: build-graph: - identifier: linux_small env: compute-type: BUILD_GENERAL1_SMALL - identifier: linux_medium env: compute-type: BUILD_GENERAL1_MEDIUM depend-on: - linux_small - identifier: linux_large env: compute-type: BUILD_GENERAL1_LARGE depend-on: - linux_medium

batch/build-list

定義 ビルドリスト. ビルドリストを使用して、並行して実行されるタスクの数を定義します。

バッチ/ビルドリスト/ビルドスペック

(オプション) このタスクに使用する buildspec ファイルのパスとファイル名。

バッチ/ビルドリスト/環境

(オプション) ビルド環境は、タスクに対して上書きされます。

バッチ/ビルドリスト/env/計算タイプ

タスクに使用する計算タイプの識別子。参照 計算タイプ () ビルド環境のコンピューティングタイプ 可能な値。

バッチ/ビルドリスト/env/画像

タスクに使用する画像の識別子。参照 画像識別子 () CodeBuild に用意されている Docker イメージ 可能な値。

バッチ/ビルドリスト/env/特権モード

(オプション) Dockerコンテナ内でDockerデーモンを実行するかどうかを示すブール値。に設定 true 構築プロジェクトがDockerイメージの構築に使用される場合のみ。そうしないと、Docker デーモンとやり取りしようとするビルドは失敗します。デフォルトの設定は、false です。

バッチ/ビルドリスト/env/種類

タスクに使用する環境タイプの識別子。参照 環境タイプ () ビルド環境のコンピューティングタイプ 可能な値。

バッチ/ビルドリスト/env/変数

ビルド環境に存在する環境変数。詳細については、「env/variables」を参照してください。

バッチ/ビルドリスト/識別子

(オプション) タスクの識別子。

バッチ/ビルドリスト/無視-失敗

(オプション) バッチの失敗を無視できるかどうかを示すブール値。

false

デフォルト値。1つのビルド タスクが失敗すると、バッチ ビルドは直ちに失敗します。

true

1つのビルド タスクが失敗しても、残りのビルド タスクは引き続き実行されます。

以下は、ビルドリストビルドスペックエントリの例です。

batch: fast-fail: false build-list: - identifier: linux_small env: compute-type: BUILD_GENERAL1_SMALL - identifier: windows_medium env: type: WINDOWS_CONTAINER image: aws/codebuild/windows-base:2.0 compute-type: BUILD_GENERAL1_MEDIUM

batch/build-matrix

定義 マトリックスの構築. ビルドマトリックスは、異なる環境と並行して実行されるタスクを定義するために使用されます。 CodeBuild は、環境構成ごとに個別のビルドを作成します。

バッチ/ビルド-マトリックス/静的

静的プロパティは、すべてのビルドタスクに適用されます。

バッチ/ビルド-マトリックス/スタティック/無視-失敗

(オプション) バッチの失敗を無視できるかどうかを示すブール値。

false

デフォルト値。1つのビルド タスクが失敗すると、バッチ ビルドは直ちに失敗します。

true

1つのビルド タスクが失敗しても、残りのビルド タスクは引き続き実行されます。

バッチ/ビルド-マトリックス/スタティック/環境

(オプション) ビルド環境は、タスクに対して上書きされます。

バッチ/ビルド-マトリックス/静的/env/特権モード

(オプション) Dockerコンテナ内でDockerデーモンを実行するかどうかを示すブール値。に設定 true 構築プロジェクトがDockerイメージの構築に使用される場合のみ。そうしないと、Docker デーモンとやり取りしようとするビルドは失敗します。デフォルトの設定は、false です。

バッチ/ビルド-マトリックス/静的/env/種類

(オプション) タスクに使用する環境タイプの識別子。参照 環境タイプ () ビルド環境のコンピューティングタイプ 可能な値。

バッチ/ビルド-マトリックス/動的

動的プロパティは、ビルド マトリックスを定義します。

バッチ/ビルド-マトリックス/ダイナミック/ビルドスペック

(オプション) このタスクに使用する buildspec ファイルのパスとファイル名。

バッチ/ビルド-マトリックス/ダイナミック/環境

(オプション) ビルド環境は、タスクに対して上書きされます。

バッチ/ビルド-マトリックス/ダイナミック/env/計算タイプ

タスクに使用する計算タイプの識別子。参照 計算タイプ () ビルド環境のコンピューティングタイプ 可能な値。

バッチ/ビルド-マトリックス/ダイナミック/env/画像

(オプション) タスクに使用する画像の識別子。参照 画像識別子 () CodeBuild に用意されている Docker イメージ 可能な値。

バッチ/ビルド-マトリックス/ダイナミック/env/変数

ビルド環境に存在する環境変数。詳細については、「env/variables」を参照してください。

たとえば、ビルド マトリックスに2つのイメージと、環境変数の3つの値がある場合、たとえば、次のようにします。

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:2.0 variables: MY_VAR: - VALUE1 - VALUE2 - VALUE3

CodeBuild 6つのビルドを作成します。

  • aws/codebuild/amazonlinux2-x86_64-standard:3.0 / MY_VAR=VALUE1

  • aws/codebuild/amazonlinux2-x86_64-standard:3.0 / MY_VAR=VALUE2

  • aws/codebuild/amazonlinux2-x86_64-standard:3.0 / MY_VAR=VALUE3

  • aws/codebuild/windows-base:2.0 / MY_VAR=VALUE1

  • aws/codebuild/windows-base:2.0 / MY_VAR=VALUE2

  • aws/codebuild/windows-base:2.0 / MY_VAR=VALUE3

各ビルドには、以下の設定があります。

  • ignore-failure に設定 false

  • env/type に設定 LINUX_CONTAINER

  • env/privileged-モードをに設定 true