Skip to content
Latchkey

パイプラインの実行(run)とは? pipelineの1回の実行

パイプラインの実行(run)はpipelineの1回の実行であり、トリガーによって開始され、独自のjob、ログ、ステータス、artifactの一式を持ちます。

pipelineは定義であり、runはその定義が実行されるときに起こることです。トリガーが発火するたびに、プラットフォームは特定のcommitに紐づく新しいrunを作成します。runは独自のアイデンティティ、独自のログ、そして最終的なステータスを持ちます。runは、何かが失敗したときに調べる単位であり、pipelineの健全性を追跡するときに測定する単位です。

runが捉えるもの

  • それをトリガーしたcommitとブランチ。
  • 実行されたすべてのjobとステップ、そのログとともに。
  • 最終ステータス: success、failure、または cancelled。
  • 生成されたartifactと各部分のタイミング。

runはcommitに紐づく

各runは1つのcommit SHAに固定されるため、runはそのコードがCIで何をしたかの再現可能な記録です。異なるcommit上での同じpipelineの2つのrunは、別々の独立したrunです。

runのライフサイクル

runは各状態を経て進みます。queued(runnerを待機中)、running(jobが実行中)、そして終端状態(success、failure、または cancelled)です。running前にqueuedで費やされる時間は待機であり、より高速なrunnerの可用性でしばしば削減できます。

簡単な例

commitをプッシュすると、CIにIDとjobのリストとスピナーを持つ新しいrunが表示されます。完了すると、runにチェックマークかバツが付き、任意のjobを開いてそのログを読むことができます。

run、キュー時間、そして速度

runはrunnerが利用可能になるまで開始できないため、作業が何も行われていなくてもキュー時間はrunの総所要時間の一部です。マネージドrunner(Latchkey)はウォームな容量でそのキュー時間を削減するため、負荷がかかっていてもrunがほぼ即座に開始されます。

重要なポイント

  • パイプラインの実行(run)は、特定のcommitに紐づくpipelineの1回の実行です。
  • その実行のjob、ログ、ステータス、artifact、タイミングを捉えます。
  • runには作業開始前のキュー時間が含まれ、より高速なrunnerがそれを削減します。

関連ガイド