コンテンツへスキップ

ランナーがジョブを取得するのを待っています:対処法

最終更新

Waiting for a runner to pick up this jobは、ジョブがキューに入っていてまだどのランナーも受け付けていない状態を意味します。GitHubホストランナーの場合は通常、同時実行数の制限か一時的なキャパシティの遅延が原因です。セルフホステッドランナーの場合は、ほぼ必ずruns-onのラベルがどのオンラインランナーにも一致していないことが原因です。このページでは両方を扱い、制限値はGitHubの利用制限のページ(2026年10月時点で確認)に基づいて説明します。

表示される正確なメッセージ

Waiting for a runner to pick up this job...

キューに入ったジョブのログ上部に表示され、ジョブのステータスは黄色の「Queued」になります。セルフホステッド環境によっては、Requested labels: self-hosted, linux, gpuとJob defined at: ...が表示され、その下にWaiting for a runner to pick up this job...と出ることがあります。これを見るとラベルの不一致に気付きやすくなります。

原因1:セルフホステッドランナーのラベルが一致していない

runs-on: [self-hosted, linux, x64]を使う場合、そのすべてのラベルを持つランナーがオンラインである必要があります。最も多い原因はタイプミスとラベルの付け忘れです。次の点を確認してください。

  1. [Settings]、[Actions]、[Runners]の順に開き、ランナーがOnlineかつIdleになっているかを確認します。
  2. ランナーのラベルにruns-onの内容がすべて含まれているかを確認します。すべてのラベルが同じランナーに付いている必要があります。
  3. ランナーが正しいランナーグループに属しているか、そのグループがリポジトリの使用を許可しているかを確認します。
  4. ホスト上でランナーのサービスが動いているかを確認します(systemctl status actions.runner.*)。
jobs:
  build:
    runs-on: [self-hosted, linux, x64]

利用制限のページによると、セルフホステッドランナーでのジョブのキュー待ち時間は24時間が上限で、それを過ぎるとジョブは自動的にキャンセルされます。

原因2:同時実行数の上限に達している

GitHubは同時に実行できるジョブ数に上限を設けています。上限を超えたジョブは、空きが出るまでキューで待機します。標準のGitHubホストランナーの数値は次のとおりです。

プラン同時実行ジョブ数macOS
無料205
Pro405
チーム605
Enterprise50050

ラージランナーには別の上限があります。TeamプランとEnterpriseプランでは全体で最大1,000の同時ジョブを実行でき、ランナーごとの同時実行数はタイプによって異なります。Freeプランで30セルのマトリックスを実行すると、20セルが実行されて10セルがキューで待機します。マトリックスのサイズ、多数のプルリクエストによる同時プッシュ、毎時0分に集中するスケジュールワークフローが重なると、上限に達しやすくなります。max-parallelについてはマトリックスビルドを、セル数を数えるにはマトリックス展開ツールを参照してください。

対処法:並列ジョブを減らす、古い実行をキャンセルする、またはキャパシティを追加します。

concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true

これは、新しいプッシュが届いたときに同じブランチの古い実行をキャンセルする設定で、スロットが空くようになります(デプロイ用ワークフローでこの設定を有効にする前に、The operation was canceledを読んでください)。

原因3:より大きなランナーの待機

ラージランナー(カスタムラベルで指定されたもの)は、そのランナーの最大数に達したとき、または自動スケーリングがまだマシンを用意していないときにキューで待機します。ランナーの最大同時実行数を確認し、プランで許可されていればランナーの設定で増やしてください。

原因4:一時的なキャパシティ不足やインシデントによる遅延

ホストランナーの特定のタイプは、起動に時間がかかることが時々あります。複数のリポジトリで無関係なジョブが大量にキューに入っている場合は、GitHubのステータスページを確認して待ってください。キャンセルと再実行を繰り返さないでください。再実行のたびにキューの最後尾に戻ってしまいます。

原因5:ホストランナーに対してruns-onのラベルが間違っている

存在しないラベル(例えばubuntu-24.04ではなくubuntu-24、または提供終了したイメージ)を指定すると、ジョブを取得するランナーがないためキューで待機したままになります。ホストランナーの一覧にあるラベルを使ってください。明らかなタイプミスはYAMLチェッカーで見つけられます。

原因6:請求またはポリシーによるブロック

アカウントが利用額の上限に達している場合、ジョブはキューに入らずに失敗し、別のメッセージが表示されます。また、組織のポリシーによってリポジトリが使用できるランナーが制限されている場合もあります。

すばやく原因を切り分ける方法

gh run list --status queued --limit 20
gh api repos/OWNER/REPO/actions/runners --jq '.runners[] | {name, status, busy, labels: [.labels[].name]}'

ランナーがonlineでbusy: falseと表示されているのにジョブが待機している場合は、ラベルかグループが一致していません。すべてのランナーがbusy: trueの場合は、キャパシティを増やす必要があります。

キュー待ち時間を根本から解消する

キュー待ち時間は、フィードバックを待つ開発者にとって無駄な時間です。セルフホステッドランナーを追加して(スケーリングも自分で管理して)運用するか、GitHubのラージランナーに課金するか、必要なときにマシンを提供するランナーサービスを利用できます。compiler.devでは、ジョブごとに新しい8 vCPU / 16 GBのVMを起動し、runs-on: [self-hosted, Linux, compiler-ci]に1行変更するだけで既存のジョブを実行できます。そのため、同時実行数がGitHubのプランの階層によって制限されることはありません。料金とセルフホステッドランナーとGitHubホストランナーの比較を参照してください。

予防方法

  1. プルリクエスト用のワークフローでは、concurrencyとcancel-in-progressを使ってください。
  2. マトリックスのサイズはプランの同時実行数の範囲内に収めるか、max-parallelを設定してください。
  3. すべてに0 * * * *を使うのではなく、cronのスケジュールをずらしてください(cronビルダーが役立ちます)。
  4. セルフホステッドランナーを監視し、オンラインのランナーが一台もない場合に通知が届くようにしてください。
  5. ランナーのラベルは、ドキュメントにまとめて一箇所で管理してください。

よくある質問

ジョブはランナーをどのくらいの時間待てますか?

セルフホステッドランナーの場合は24時間で、その後GitHubがジョブをキャンセルします。ホストランナーのジョブは、同時実行数の上限に達していない限り、通常は数秒から数分で開始します。

他のジョブが実行されていないのに、なぜ自分のジョブがキューに入っているのですか?

セルフホステッドランナーの場合は、ラベルかランナーグループが一致していないか、オンラインのランナーがありません。ホストランナーの場合は、ラベルを確認し、ステータスページも確認してください。

キューに入っているジョブに料金はかかりますか?

キューで待機している時間は課金されません。課金は、ランナーがジョブの実行を開始したときに始まります。

同時実行数の上限を引き上げることはできますか?

上限はプランによって異なります。上位プランほど上限が高く、大きいランナーには別の上限が設けられています。プランごとの引き上げについては、GitHub サポートにお問い合わせください。