ホーム / ブログ / GitHub Actions macOS-14退役後、CI失敗はどうする?2026
ENGINEERING_BLOG · 2026.11.15

GitHub Actions macOS-14退役後、CI失敗はどうする?2026

2026年10月1日付の告知で、GitHubはmacos-14、macos-14-large、macos-14-xlarge Runnerの退役を案内しています。公式告知を確認し、まずワークフローのラベルを、現在サポートされていてプロジェクトのアーキテクチャ要件に合うRunnerへ変更してください。

症状 → 最短の対応
Runnerが割り当てられない場合は、runs-onと実行記録から退役ラベルの残存を確認します。ラベル変更後も、アーキテクチャ、Xcode、テスト、署名を個別に検証し、成功したジョブの証拠がそろうまで復旧扱いにしないでください。

企業IT担当者:macOS-14退役による影響範囲と修正責任を確認したい方。
プラットフォームエンジニア:Runnerの割り当て、アーキテクチャ、ツールチェーンのどこで失敗するか特定したい方。
リリース担当者:ビルドだけでなく、テストと署名・公開まで再開できた証拠を求める方。

最終更新:2026年11月15日。退役対象はGitHubの告知、Runnerラベルとイメージ情報は公式イメージ一覧および関連ドキュメントを照合しています。ラベルやイメージ内容は変わるため、切り替え作業時にも再確認してください。

SECTION 01Runnerが割り当てられないときの確認

runs-onに退役済みのラベルが残っていれば、ジョブが開始しない原因になり得ます。ただし、画面のエラーだけで退役が原因と決めつけず、ワークフロー定義と実行記録を突き合わせてください。GitHub Actionsのワークフロー障害の公式ガイドも、ログや設定を確認して原因を絞る手順を案内しています。

まず、失敗したジョブのワークフローと実行時刻を特定します。次に、ブランチやイベントごとに異なるruns-on指定がないか検索し、macos-14だけでなく、告知に記載された大規模Runnerのラベルも確認します。再利用ワークフローや複数のジョブで別々のラベルを指定している場合は、失敗したジョブの定義までたどってください。

症状 確認する証拠 次の判断
ジョブがRunner待ちのまま 対象ジョブのruns-on、イベント、実行記録 退役ラベルが残っていれば、要件に合うサポート対象へ変更
ジョブ開始後に依存導入で失敗 実行時のアーキテクチャ、依存取得ログ バイナリや依存パッケージの対応状況を検証
コンパイルは成功するがテストが失敗 選択されたXcode、SDK、シミュレーター ツールチェーンとテスト環境を分けて調査
アーカイブ後に署名・公開が失敗 署名ID、プロビジョニングプロファイル、Keychainの状態 Runnerの問題と資格情報の問題を切り分け

GitHub ActionsのRunnerコンテキストでは、実行環境のOSやアーキテクチャなどを確認できます。修正前後で同じ情報をログに残し、設定ファイルに書いたラベルだけでなく、実際にジョブを受けた環境を記録してください。

SECTION 02アーキテクチャ不一致と依存ツールの切り分け

macOS-14から別のmacOS Runnerへ切り替えても、旧環境で使っていたIntel向けバイナリや特定アーキテクチャの依存関係がそのまま動くとは限りません。ラベルの置き換えは、アプリやビルド依存のアーキテクチャ移行を自動で完了させる操作ではありません。

ログには、RunnerのOSとアーキテクチャ、依存ツールの導入結果、失敗したコマンドを記録します。依存の取得段階でエラーになるのか、取得後の実行で「実行形式が不正」などのエラーになるのかを分けると、ラベルの指定ミスとバイナリの非互換を見分けやすくなります。

場面例: Runnerのラベル変更後にパッケージ取得は完了したものの、プロジェクト内の補助ツールが起動しない場合、まず実行ファイルの対応アーキテクチャを確認します。新しいイメージの選択だけを繰り返すのではなく、依存ツールの入手元、ビルド方法、代替バイナリの有無を確認し、同一コミットで再現するかを記録してください。

macOS-15 Runnerを候補にする場合は、ラベルが有効かだけでなく、macOS-15イメージのソフトウェア一覧で必要なツールとバージョンを調べます。macOS-26 Runnerを検討する場合も、利用可能なラベルやイメージ内容を前提にせず、Runnerイメージの公式一覧で現時点の状態を確認してください。

SECTION 03XcodeとSDKの選択差分

Runnerが起動しても、ワークフローで想定したXcodeやSDKが実際に選ばれているとは限りません。ジョブのログから、xcodebuildのバージョン、利用中のXcodeパス、SDK、シミュレーターランタイムを記録し、イメージのソフトウェア一覧と照合してください。

Xcodeの選択を明示する処理があるなら、その実行結果と後続のビルドログを確認します。意図したバージョンが導入されていない場合は、プロジェクトのコード変更より先に、イメージに含まれるツールと選択処理の適合を調査します。なお、コマンドラインツールとXcode本体の導入状態は同一視できません。Appleのコマンドラインツールに関する説明も参照し、必要なツールがどの方法で提供されているかを確認してください。

SECTION 04ビルド後に残るテスト・成果物の失敗

ビルドが通っても、テスト、アーカイブ、公開用成果物が正常とは限りません。失敗が最初に現れた段階を特定するため、次の順で同じコミットを検証します。

  1. ジョブが想定したRunnerラベルで実行されたことをログで確認します。
  2. OS、アーキテクチャ、Xcode、SDK、シミュレーターの選択結果を保存します。
  3. クリーンな依存導入とコンパイルを実行し、どの処理で最初に失敗するか記録します。
  4. 単体テストとシミュレーターを使うテストを分けて実行し、失敗するテスト群を特定します。
  5. アーカイブを作成し、成果物の内容とビルドログを照合します。
  6. 変更前後の同一コミットでログと成果物を比較し、修正箇所と結果の対応を残します。

新しいイメージでだけテストが失敗するなら、環境変数、ツール選択、シミュレーターの利用可能性など、プロジェクト側が暗黙に期待している条件を調べます。テストが通ったという結果だけでなく、利用した環境情報と成果物を記録すれば、次回のイメージ更新時にも再検証できます。

Runnerの変更とアプリの変更を同じコミットにまとめると、どちらが失敗原因か判別しにくくなります。可能なら環境変更だけを先に適用し、同一のソースで差分を取ってください。

SECTION 05署名・公開障害をRunner退役と混同しない

コンパイルとテストが成功しても、署名や公開が止まる場合があります。署名ID、プロビジョニングプロファイル、Keychainへの登録、CIで参照する資格情報を、それぞれ代替環境で利用できるか確認してください。

資格情報が存在するかだけで合格とは判断せず、対象の署名処理が実行され、期待する署名付き成果物が生成されたことを確かめます。署名の失敗ログとRunnerの割り当て・ツール選択ログを分けて保存すれば、環境変更による問題と資格情報の不備を切り分けられます。一度アーカイブできただけで、公開までの経路が復旧したとは扱わないでください。

SECTION 06自管Macへ切り替える判断条件

托管Runnerで要件を満たせるなら、まずその構成で検証を続けます。一方、必要なアーキテクチャ、ツールチェーン、ネットワーク接続、署名資格情報の扱いが満たせないことを実際のジョブログで確認した場合は、自管Macや遠隔Macを候補として比較します。自管Runnerをワークフローで使う際の設定は、GitHubの自管Runnerに関する説明を参照してください。遠隔Macの利用を検討する場合は、MACNOXのサービス案内で公開されている情報を確認し、自分たちのジョブ要件と照合してください。

選択肢 向いている条件 主な確認点
GitHub托管Runner 現行イメージでアーキテクチャとツール要件を満たせる イメージ更新によるツール差分、私設ネットワークへの接続条件
自管Mac Runner OSやツールを管理し、ジョブの実行環境を自分たちで運用できる 更新、監視、資格情報の保護、障害時の復旧責任
遠隔Mac チームに物理Macを配備せず、管理可能なmacOS環境でジョブを動かしたい 必要な構成、接続・交付条件、利用期間を実際のサービス情報で確認

自管や遠隔の環境では、ツールの固定やネットワーク接続を調整しやすくなる一方、運用側に保守、アクセス管理、資格情報の保護、障害対応が発生します。単にRunnerイメージを変えただけで直る問題なら、基盤の変更は不要です。まず、満たせない要件と再現ログをそろえ、どの制約が托管Runnerの継続を妨げているかを説明できる状態にしてください。

退役後のCI障害は、ラベル変更だけで完了とは判断できません。現在のRunnerで必要なアーキテクチャとツールチェーンを満たせるなら托管環境を検証し、実ジョブで満たせない条件が確認できた場合に限り、自管Macや遠隔Macの運用責任と比較してください。現在の環境には、イメージの選択肢やツール構成を細かく制御しにくいこと、チーム固有のネットワーク要件を満たせないこと、更新時に環境差分が生じることがあります。

一時的な検証環境や、チームで管理できるmacOSホストが必要な場合は、MACNOXの利用料金とプランで、実際に公開されている構成や利用条件を確認してください。恒常的な高負荷ジョブや物理接続が必須の処理では、遠隔利用が適さない場合もあります。要件と運用責任を照らし合わせてから選定してください。

SECTION 07関連記事