コンテンツへスキップ
Latchkey ホーム
無料で始める
ドキュメントメニュー

プロビジョニングの仕組み

GitHub でジョブがキューに入ってからランナーがピックアップするまでに何が起きるか: ウォームプール、ジャストインタイム登録によるコールドスタート、同時実行の上限、そしてジョブが待たされる理由。

ウォームピックアップ
約 2 秒
ウォームランナーが既にオンラインの場合
コールドスタート
JIT
新しいマシン、ジャストインタイムで登録
VM あたりのジョブ
1
すべてのランナーはジョブの後に破棄されます
ランナーの寿命
4h
Latchkey on GH の場合 (4 時間の時点でジョブがまだ実行中なら最大 8 時間)

要点

  1. キューに入ったジョブは、既にオンラインのウォームランナーに約 2 秒でピックアップされるか、新しいマシンがジャストインタイム登録でコールドスタートします。
  2. すべてのランナーはエフェメラルです: VM ごとに 1 ジョブ、単回使用の認証情報、ジョブ後にマシンは終了されます。
  3. 現在はすべてのプランが同じウォームのベースラインを受け取ります: latchkey-small 上の常時オンのウォームランナー 1 台とパーク済み容量です。それを超える需要はコールドスタートします。
  4. ワークスペースごとに開始時点で 40 の同時ビジーランナー (Launch プランの数値)。アイドル状態のウォームランナーとパーク済みランナーが上限にカウントされることは決してありません。

GitHub が latchkey-* ラベル付きのジョブをキューに入れると、Webhook が即座に Latchkey に伝え、Latchkey は 1 つの判断を下します: ジョブを既にウォームなランナーに渡すか、そのために新しいマシンを起動するか。あなたがその判断を目にすることはありませんが、それがほぼ即座に開始するジョブと、マシンの起動を待つジョブの違いであり、このページで扱う内容の大半を説明するものです。

01
ジョブがキューに入る
GitHub が latchkey-* ラベルを対象とするジョブをキューに入れます
02
Webhook
ジョブがキューに入った瞬間に GitHub が Latchkey に通知します
03
スケールアップの判断
ウォームランナーがジョブを引き受けるか、新しいマシンが起動します
04
ピックアップ
ウォーム: ランナーが既にオンラインなら約 2 秒。コールド: 新しいマシンが起動してジャストインタイムで登録します。
05
実行して破棄
ジョブはマシン上で単独で実行され、マシンはその後終了されます

ウォームピックアップ vs コールドスタート#

ウォームピックアップ は、事前にプロビジョニングされたランナーがあなたのワークスペース向けに既にオンラインだったことを意味します: ジョブはそのままそのランナーに渡され、約 2 秒で開始します。コールドスタート は、適合するウォームランナーがなかったことを意味します: そのジョブのためだけに新しいマシンが起動し、ジャストインタイムの単回使用構成で GitHub に登録し、その後あなたのステップを実行します。どちらのパスも終わり方は同じです: ランナーは正確に 1 つのジョブを引き受け、ジョブが終了するとマシンは終了されます。

ランナー · キューから終了まで

3 つのジョブが 3 通りの方法でランナーに届きます。latchkey-small のジョブ 1 は、すでにオンラインのウォームランナーが約 2 秒で受け取ります。latchkey-small のジョブ 2 は、パーク中のマシンが再開するのを待ちます。latchkey-large のジョブ 3 は、新しいマシンが起動してジャストインタイムで登録されるのを待ちます。どのマシンも 1 つのジョブだけを実行し、その後に終了されます。

FIG. 3.10-A最も速いのはすでにオンラインのウォームランナーです。パーク中のマシンは再開し、ウォームの基本容量を超えるジョブはコールドスタートします。どの経路でも、1 台のマシンが実行するのはちょうど 1 つのジョブで、その後に終了されます。

ウォームプール#

プランウォームプール
Developerウォームな latchkey-small ランナー 1 台とパーク済み容量
Launch同じベースライン: ウォームランナー 1 台とパーク済み容量
Scale同じベースライン: ウォームランナー 1 台とパーク済み容量

現在はすべてのプランが同じウォームのベースラインを受け取り、その対象は latchkey-small のみです: 常時オンのウォームランナー 1 台と、オンデマンドで再開するパーク済みマシンです。それを超えるもの、およびより大きなサイズを要求するジョブは、コールドスタートします。ウォーム容量はアイドル中に何のコストもかかりません。課金はジョブの分単位であり、アイドル状態のウォームランナーはジョブを実行していないからです。

常にエフェメラル#

プロビジョニングがマシンを再利用することは決してありません。ウォームでもコールドでも、ランナーは正確に 1 つのジョブを引き受け、その後ディスクとともに終了されます。GitHub の実行ビューでランナー名が実行ごとに変わるのはこのためであり、ジョブがローカルディスクに書き込んだものがジョブ終了時に消えるのもこのためです。この設計のセキュリティ面、すなわちジャストインタイムの認証情報、インバウンドのネットワークアクセスなし、暗号化された単回使用ディスクについては、セキュリティアーキテクチャ で扱います。

同時実行#

ワークスペースは開始時点で最大 40 の同時ビジーランナー を実行し (Launch プランの数値。プラン変更後は Developer が 20、Scale が 80。Enterprise の上限は契約で定められます)、カウントされるのはビジーなランナーだけです: アイドル状態のウォームランナーがスロットを消費することは決してないため、ウォーム容量があなたの実際のジョブと競合することはありません。バーストが一度にあなたの上限数を超える場合、あふれたジョブはキューに留まり、自動的に開始します。何もエラーにならず、何も失われません。Latchkey CI のジョブは順番を保ったまま、スロットが空き次第開始します。上限に近づくと、キュー内のバッチのジョブより先に開始します。バッチのジョブが道を譲るのは、キューに入ってから最大 30 分までです。GitHub Actions のジョブは、スロットが空くまで GitHub のキューで待ちます。ワークスペースの GitHub Actions のジョブが終わると、Latchkey はそのスロットを待機中のジョブにすぐに割り当てようとします (アイドル状態のウォームランナーがそのジョブを先に受け取った場合を除きます)。その時点で割り当てられなかった待機中のジョブは、5 分ごとの見直しで拾われるため、スロットが空いてから数分後に開始することがあります。GitHub Actions では、上限に達した時点ですでにアイドル状態だったウォームランナーは、待っていたその 1 つのジョブを受け取るため、ワークスペースはそのようなランナー 1 台につき最大で上限より 1 つ多いジョブを実行していることがあります。Latchkey が数値を守るためにランナーを停止することはありません。ピーク時に定期的にキュー待ちが発生するなら、より高い上限が利用可能です。サポートに連絡してください。

ランナー · 使用中ランナーの上限に対するバースト

上限が 40 ビジーランナーの Launch プランのワークスペースで、40 中 36 のランナーが使用中です。8 つのジョブが一度にキューに入ります。ジョブ 1 から 4 が空いている 4 つの枠を使って開始し、ワークスペースは 40 中 40 になります。ジョブ 5 から 8 はキューに残ります。エラーにはならず、何も失われません。ビジーランナーが 1 つ終わって枠が空くと、ジョブ 5 がそこで開始します。もう 1 つ終わるとジョブ 6 が開始し、さらに 2 つ終わるとジョブ 7 と 8 が開始します。最後の 4 つはキューで待った後に、バースト全体が実行されます。アイドル状態のウォームランナーとパーク中のランナーは枠を使いません。

FIG. 3.10-B上限に数えられるのはビジーランナーだけです。上限を超えたジョブは拒否されず、キューに残って、ビジーランナーが終わるにつれて開始します。

ハードな境界#

  • Latchkey CI のジョブは timeout-minutes を最大 180 (デフォルトは 30) まで設定でき、CLI のジョブは最大 3 時間実行でき、Latchkey on GH のランナーは起動から最大 4 時間 (4 時間の時点でジョブがまだ実行中なら最大 8 時間) 稼働できます。
  • ランナーは x86_64 上の Ubuntu 24.04 LTS のみです: Windows、macOS、arm64、GPU ホストはありません。
  • ランナーは AWS us-east-1 で実行されます。

ディスクサイズやプランごとのカスタム構成数を含む完全な表は、上限と同時実行数 にあります。

ジョブが queued のまま留まる理由#

プロビジョニングがランナーを起動できない、または起動しない場合、GitHub 側にエラーはありません。ジョブはただ待ちます。これは設計によるものです: latchkey-* ラベルを対象とするジョブは、エラーになるのではなく GitHub でキューに留まります。よくある原因:

  • ラベルのタイプミス: どの構成もラベルに一致しないため、何もジョブをピックアップしません。
  • リポジトリが監視されていない、またはランナーの 構成が無効になっている。
  • 課金またはトライアルのブロック: 期限切れのトライアル、失効したサブスクリプション、またはカードなしトライアルで使い切った無料ティア。このブロックについて "Managed runner blocked" 通知が 1 日に最大 1 回送信され、その月の "Free tier running out" 通知が送られた後は無料枠については送信されません。期限切れのトライアルによるブロックは、イベントをオンにするまでメールと Slack ではオフのままです。
  • カスタムランナーのイメージがまだビルド中: そのラベルを対象とするジョブは、ビルドが完了するまで待ちます。
  • ワークスペースが ビジーランナーの上限 (開始時点で 40、Launch プランの数値) に達している: ワークスペースの GitHub Actions のジョブが終わると、Latchkey は空いたスロットを待機中のジョブにすぐに割り当てようとします。アイドル状態のウォームランナーが先に受け取った場合は別で、その時点で漏れたジョブは 5 分ごとの見直しで拾われるため、数分後に開始することがあります。

各原因の確認方法を含む、症状ごとのウォークスルーは トラブルシューティング にあります。

Q.01ジョブが queued のまま止まるのはなぜですか?

ウォームの基準容量を超えて待機している場合は、そのジョブのために新しいマシンがコールドスタート中です。それ以外は何かがブロックしています。ラベル、監視設定、構成、請求、進行中のイメージビルド、同時実行の上限のいずれかを、この順で確認してください。

Q.02ウォームピックアップとコールドスタートの違いは?

ウォームピックアップは既に稼働中のマシンにジョブを渡し、ランナーが既にオンラインなら約 2 秒です。コールドスタートは Just-in-Time 登録で新しいマシンを用意するため、より長くかかります。現在はすべてのプランが同じウォーム基準を持ち、常時稼働のウォームランナー 1 台に加えて latchkey-small の待機容量が用意されます。

Q.03アイドル状態のウォームランナーは同時実行の上限に数えられますか?

数えられません。あなたのワークスペースの同時ランナー数 (開始時点で 40 台) はビジー状態のランナーのみを数えるため、仕事を待っているウォーム容量が上限を消費することはありません。