イメージパイプラインのパイプライン実行設定を構成する - EC2 イメージビルダー

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

イメージパイプラインのパイプライン実行設定を構成する

パイプラインの実行をスケジュールするには、次のオプションから選択できます。

スケジュールビルダー

Schedule Builder を使用して、パイプラインの自動的な繰り返し実行を設定します。パイプラインを実行するタイミングと頻度 (日、時間、頻度) を定義します。デフォルトのスケジュールは、スケジュールが作成された日時 (UTC) に基づいて毎週です。

Cron 式

スケジュールを指定する cron 式を使用してパイプラインを自動的に実行します。Image Builder が使用する cron 構文の詳細については、「」を参照してくださいImage Builder での cron 式の使用

手動

パイプラインはスケジュールどおりに実行されません。コンソールで、アクションメニューからパイプラインの実行を選択し、パイプラインを実行します。から AWS CLI、 を実行できますstart-image-pipeline-execution

依存関係の設定

スケジュールされたビルドでは、ベースイメージやレシピで使用されるコンポーネントの変更などの依存関係の更新がない限り、常にスケジュールに従って実行するか、パイプライン実行をスキップするかを選択できます。

失敗したパイプラインを自動的に無効にする

スケジュールに従って実行されるイメージパイプラインの場合、Image Builder が自動的にパイプラインを無効にする前に、連続する失敗の最大数 (最大10) を設定できます。

自動無効化設定

Image Builder は、スケジュールされたパイプライン実行の連続した失敗の数を追跡し、スケジュールに従って実行されるたびに次のいずれかのアクションを実行します。

  • パイプラインの実行が成功すると、連続する失敗の数はゼロにリセットされます。

  • パイプラインの実行が失敗した場合、Image Builder は連続する失敗の数を増やします。失敗数が で定義されている制限を超えるとAutoDisablePolicy、Image Builder はパイプラインを無効にします。

次の条件では、連続する障害数もゼロにリセットされます。

  • パイプラインは手動で実行され、成功します。

  • パイプライン設定が更新されます。

パイプラインを手動で実行して失敗した場合、カウントは変わりません。次のスケジュールされた実行は、以前に中断した増分を続けます。

パイプラインのログ記録を設定する

イメージパイプラインを作成または更新するときに、イメージビルドログとパイプラインログ用にカスタム CloudWatch Logs グループを設定できます。カスタムパイプライン実行ロールに、ロググループリソースを作成してアクセスするための次のアクセス許可があることを確認します。

  • logs:CreateLogGroup

  • logs:CreateLogStream

  • logs:PutLogEvents

カスタムロググループ

イメージビルドまたはパイプラインの実行にカスタムロググループを使用するには、まず CloudWatch Logs でロググループを作成します。詳細については、Amazon CloudWatch Logs ユーザーガイド」の「ロググループの作成」を参照してください。ロググループの命名要件に関するその他のガイダンスについては、Amazon CloudWatch Logs API リファレンスCreateLogGroup」を参照してください。

Console

詳細設定のログ記録設定セクションで、パイプラインのイメージロググループまたはパイプラインロググループを指定します。

CLI

設定に JSON logging-configuration オブジェクトを使用する場合は、 オブジェクト内で次のフィールドを指定します。

  • imageLogGroupName

  • pipelineLogGroupName

コマンドラインですべてのパラメータを直接指定するには、AWS CLI 「 コマンドリファレンス」のcreate-image-pipeline」を参照してください。

カスタムロググループを指定しない場合、Image Builder は次のデフォルトのロググループを使用します。

イメージビルドログ

Image Builder は、次の Image Builder CloudWatch Logs グループとストリームにビルドログを書き込みます。

LogGroup: /aws/imagebuilder/ImageName

LogStream (x.x.x/x): ImageVersion/ImageBuildVersion

パイプライン実行ログ

Image Builder は、パイプライン実行ログを次の Image Builder CloudWatch Logs グループとストリームに書き込みます。

LogGroup: /aws/imagebuilder/pipeline/pipeline-name

LogStream: 2025/09/01 (YYYY/MM/DD 形式のパイプライン実行日)

各パイプラインログは、その日のストリームに追加されます。