同じconcurrency groupでは、実行中のジョブ1件と保留中のジョブ1件が基本の上限です(GitHub公式のconcurrency仕様)。 症状:GitHub Actions macOS-26のキュー待ち。最短の対応:Runnerを増やす前に、待機場所、並行実行数、concurrency設定、自ホストRunnerの状態とラベルを照合してください。
キューに入った事実だけでは、Macの処理能力不足とは判断できません。重要なMacジョブが継続的に容量制約を受けていると記録で確認できた場合に限り、タスク分散や増強、専用のリモートMacを検討します。
対象は、リリース計画とCI資源を管理する企業IT担当者、GitHub Actionsの運用を担うCIプラットフォームエンジニア、投資判断を行う技術・FinOps責任者です。 最終更新日:2026年11月20日。GitHub公式の制限、ジョブ表示、concurrency、自ホストRunner、macOS-26イメージに関する資料を確認しています。
キューの位置を特定して、原因を混同しない
「待っている」ように見える状態でも、詰まっている場所は異なります。まずGitHub Actionsのジョブ状態とワークフローの実行時刻を記録し、Runner側のログと突き合わせます。組織または企業の稼働中ジョブは、GitHub公式の現在のジョブ確認手順で確認できます。
| 観測した状態 | 最初に確認するもの | 可能性のある原因 | 次の確認 |
|---|---|---|---|
| ワークフロー自体が始まらない | イベント、ブランチ条件、実行履歴 | トリガー条件や対象ブランチ | 対象イベントとワークフローの実行記録を照合 |
| ジョブがキューにある | Runner種別、組織の同時実行状況 | GitHub-hostedの同時実行枠、需要による起動待ち | 現在のジョブと公式の制限を確認 |
| 自ホストRunnerがジョブを受け取らない | Runnerのオンライン状態、runs-on、Runner group | Runner停止、ラベルやグループの不一致 | Runner側の状態・ログとジョブのルーティング情報を照合 |
| Runnerが受け取った後に進まない | Runnerログ、ステップの開始状況 | 初期化やワークフロー内の処理 | デバッグログを有効にし、止まった段階を確認 |
並行実行数とconcurrencyを切り分ける
GitHub Actions macOS Runnerの並行実行制限に達しているかどうかは、契約上の枠だけでなく、対象組織・企業で実際に動作しているジョブを確認して判断します。プランごとの制限や適用条件は変わる可能性があるため、数値を過去のメモから転記せず、確認時点の公式制限一覧を参照してください。
同時に、ワークフローとジョブの両方に設定されたconcurrencyも確認します。上記の仕様では、同じgroup内で実行中のジョブと保留中のジョブがそれぞれ1件となり、新しい保留ジョブが既存の保留ジョブを置き換える場合があります。cancel-in-progressの設定も含め、意図した直列化なのか、古いコミットを取り消してよいワークフローなのかを公式のconcurrency説明で確認します。
| 設定・観測 | 適した使い方 | 注意する点 | 見直しの判断 |
|---|---|---|---|
| 同時実行枠の使用が多い | 制限とジョブ履歴を照合し、実行枠を消費する処理を特定 | macOSジョブだけの問題と決めつけない | キューと同時実行の記録が繰り返し連動するか |
| リリース用groupで直列化 | リリース順序や共有環境を守りたい | 待ち時間が設定どおり発生する | 順序を保つ必要があるジョブを分離できるか |
| 古いコミットを取消可能 | 最新コミットだけを検証したいブランチ | 途中のジョブを取り消してよいか | テスト目的とリリース要件に合う場合のみ取消 |
| groupが広すぎる | 無関係なワークフロー同士が同じgroupを共有 | 本来並行できるジョブまで直列化 | 用途別にgroupを分け、挙動を試験 |
自ホストRunnerの状態とラベルを照合する
ジョブが自ホストのMacへルーティングされる設計なら、最初にRunnerがオンラインで、ジョブを受け取れる状態かを確認します。そのうえで、ワークフローのruns-onに指定したラベルと、Runner groupの割り当てが一致しているかを照合します。
自ホストRunnerのワークフロールーティング規則では、ラベルとRunner groupがジョブの割り当てに関わります。設定が合っていてもRunnerが停止している場合はジョブを処理できません。状態や接続を含む確認事項は自ホストRunnerの公式ガイドに沿って確認し、Runner側の記録も保存してください。
ログだけで停止位置を特定できない場合は、[GitHub Actionsのデバッグログ手順](https://docs.github.com/en/actions/how-tos/monitor-workflows/enable-debug-logging)を参照して詳細ログを取得します。トークンや署名情報など、ログに残すデータの範囲を社内ルールに照らしてから有効化してください。注意:GitHub-hostedのキュー待ちと、自ホストRunnerがオンラインでない状態は別の問題です。Runnerの表示、ジョブのルーティング情報、Runnerログを同じ実行について突き合わせてから原因を分類してください。
記録をそろえて、最適化・分散・増強を選ぶ
企業iOS CIの拡張判断では、待ち時間だけでなく、対象ジョブの重要度、同時実行枠、Runnerの障害記録を同じ表にまとめます。単発の遅延だけで継続的な容量不足とは判断せず、曜日やワークフロー、Runner種別が異なる記録を比較します。
| 記録項目 | 残す内容 | 判断への使い方 |
|---|---|---|
| ジョブとワークフロー | 対象ブランチ、トリガー、ジョブ名 | 特定の処理だけが待つのかを分ける |
| 待機の発生位置 | ワークフロー開始前、キュー中、Runner受領後 | GitHub-hosted、設定、Runner側のどこを調べるか決める |
| Runner情報 | GitHub-hostedか自ホストか、ラベル、group | ルーティングと稼働状態を照合する |
| 実行の目的 | リリース、必須テスト、旧コミットの検証など | 取消可否と優先度を決める |
| 結果と影響 | 成功・失敗、リリース計画への影響、調査したログ | 調整後に同じ症状が残るか評価する |
GitHub Actions macOS Runnerが繰り返し待つときの確認手順
- 同じ期間の対象ワークフローについて、ジョブ状態、実行時刻、Runner種別を記録します。
- 組織・企業の現在のジョブと、適用中のGitHub-hosted制限を照合します。
- ワークフローとジョブ双方の
concurrency、group名、取消設定を確認します。 - 自ホストRunnerを使うジョブでは、オンライン状態、空き状況、
runs-onラベル、Runner groupを確認します。 - Runnerがジョブを受け取った後に停滞する場合は、ログから初期化・ビルド・署名などの段階を特定します。
- 変更は対象ワークフローを絞って試し、変更前後で待機の位置とリリースへの影響を比較します。
運用上の目安:一度の長い待ちを容量不足の証拠にしないでください。重要なリリースジョブで同じ待機が繰り返され、設定やルーティングの問題を除外しても改善しない場合に、分散・増強の試験へ進みます。
判断条件:条件に合う対応を選ぶ
- 同じconcurrency groupの直列化が原因なら、直列化を保つ必要がある処理と、独立して実行できる処理を分けます。取消可能な旧コミットだけを対象にするなど、リリース保護を崩さない変更から試します。
- GitHub-hostedの並行実行枠が継続的に制約となっているなら、現在の制限と実行記録を再確認し、まず適用可能な枠やジョブ構成の見直しを検討します。
- 自ホストRunnerがオフライン、またはラベル・group不一致なら、Macを追加する前にRunnerの復旧とルーティング修正を行います。
- 高需要時の起動遅延が単発で、リリース影響も確認できないなら、記録を継続し、単発の事象だけを理由に専用ノードを追加しません。
- 重要なMacジョブで容量制約が繰り返され、設定・ルーティングの問題を除外できたなら、タスク分散またはMac Runnerの増強を試験します。ビルド、テスト、署名の境界を実ワークフローで検証し、結果を確認してから対象範囲を広げます。
| 対応案 | 適合度 | 得られるもの | 主な運用上の負担 |
|---|---|---|---|
| concurrencyとワークフローを調整 | 直列化や取消設定が主因の場合に高い | 不要な待機を減らせる可能性 | 取消条件やリリース順序の再検証 |
| GitHub-hostedを継続 | 待機が一時的で、現行構成が要件を満たす場合に高い | 自ホストMacの管理を避けられる | 制限と需要状況の継続確認 |
| 自ホストRunnerを修復・増強 | 管理要件があり、Runnerを運用できる場合に高い | ラベルやグループでジョブを分けられる | ホストの稼働、更新、接続、障害対応 |
| リモートMacで試験分散 | 容量制約が記録で確認され、Mac環境が必須の場合に中〜高 | 対象ジョブの受け皿を段階的に検証できる | 接続、権限、署名情報、受け入れ試験 |
GitHub-hostedだけで運用すると、同時実行枠の影響を受けることがあり、高需要時の起動待ちも制御しにくく、自ホストのラベルや環境を使った細かな受け皿設計にも限界があります。一方、長期にわたる安定した高負荷や物理インターフェースが必要なら、購入・自社管理が適する場合もあります。実ログが継続的な容量制約を示し、短期の試験や段階導入を優先するなら、MACGPUのリモートMac案内を確認し、実際のワークフローでビルド・テスト・署名を受け入れ検証してください。拠点や利用条件を照合する際は、MACGPUのMac案内も参照し、適合性を確認してから対象ジョブを移します。