CI/CD

2026 Xcode 18 brew エラー:リモート Mac CI は予備ノードをいくつ残すべきか?

CI のアップグレード後、brew install が失敗し、署名・アーカイブ・アップロード用の Mac まで同じ待ち行列に入っている。

最短の判断は、固定比率で予備ノードを置かず、重要ジョブの同時実行数、同時に失う障害ドメイン、復旧時間、許容待ち時間から必要容量を算出することです。 日常負荷が安定している組織は独立した予備プール、ピークが短くバージョンリスクが高い組織は発行期間だけクラウド Mac を追加する方式が適しています。

この記事は、iOS の発行を担当する DevOps エンジニア、共有 Mac Runner 池を管理するプラットフォームチーム、そして常設容量と一時レンタルの費用配分を決める技術責任者向けです。Homebrew や Command Line Tools の障害を診断・降格する記事ではなく、障害中にどれだけ切り替え可能な容量を確保するかに絞ります。

最終更新:2026年9月3日。Apple のバージョン情報は Xcode のシステム要件、Command Line Tools の扱いは Apple のインストール手順、Homebrew の対応境界は Homebrew の公式ドキュメントで確認しています。

最初に実施すること:バージョン名を実体へ置き換える

「Xcode 18 brew エラー」は、そのまま容量計算の入力値にはできません。2026年9月3日時点で Apple の公式バージョン表に確認できる安定版系列は Xcode 26.6、次世代は Xcode 27 beta であり、公式の Xcode 18 が存在することは確認されていません。したがって、Xcode 18 はユーザーの検索語、社内チケット名、または既存の運用ラベルとして扱い、実際の Xcode、macOS、独立した Command Line Tools のバージョンを記録してから判断します。

Xcode.app に含まれるツールチェーンと、別途インストールされる Command Line Tools は同じものではありません。clang や brew の参照先を戻せても、iOS の SDK、署名、アーカイブ、アップロードを含む Xcode 全体のビルドを代替できるとは限らないため、空いている Mac をすべて予備ノードとして数えるのは危険です。

注意: コミュニティ上の「Xcode 18 への更新後に Homebrew の C++ 依存関係が壊れた」という報告は、個別事例または未検証の報告として扱います。発生率や平均復旧時間を公式事実として容量モデルへ入れてはいけません。

計算には、次の変数だけを使います。

  • 発行、署名、アーカイブ、アップロードなど、障害中も止められない重要ジョブの同時実行数
  • 1つのアップグレード作業で同時に影響を受けるノード群
  • 既存ノードを復旧するまでの見積時間
  • ジョブが待機できる時間と、待機を許容できない発行期限
  • Xcode、macOS、CPU アーキテクチャ、署名材料が一致する予備ノード数

予備容量の基本形は、次のように表せます。

必要な切り替え容量 = 障害中に継続する重要ジョブの同時実行数 − 障害後も利用できる適合ノード数

ただし、結果が負になる場合でも、待機列が長くなるなら十分とは限りません。復旧時間が不確実で、発行期限が固定されている場合は、計算結果に任せず、独立した故障ドメインを先に確保します。

単一アプリの発行では、重要ジョブだけを予備化する

単一アプリで同時実行が少ない場合、テスト、静的解析、開発ブランチのビルドまで日常どおり維持する必要はありません。署名、アーカイブ、ストアへのアップロードなど、遅延が発行判断に直結するジョブを分離し、その同時実行数を最低可用容量の基準にします。

Xcode 18 が原因とされる brew エラーの際、予備 Mac ノードはどう見積もるべきでしょうか。 まず、過去の発行期間から重要ジョブの最大同時実行数を取り出し、アップグレード対象と別の障害ドメインにある適合ノードだけを差し引きます。単に「本番ノードの一定割合」を予備にする方法では、発行ジョブが集中する時間帯や、同じ更新作業で複数ノードが同時に使えなくなる条件を反映できません。

予備環境には、アップグレード中の本番ノードと異なる管理単位、イメージ、または更新タイミングを設定します。同じツールチェーン更新を同じ作業者が同じ順番で適用すれば、ノードを分けても障害ドメインは分離されません。

常設プールは、発行以外の時間にも待機資源が残りやすい一方、切り替えテストを継続しやすい方式です。発行期間だけ KuzCloud の Mac 利用環境 を追加する方式は、短いピークや一時的なバージョン検証に向きますが、事前にイメージ、権限、署名材料、接続方法を確認していなければ、借りた容量が即時の切り替え容量にはなりません。

多ブランチ運用では、履歴からピークを取り出す

通常発行、緊急修正、回帰検証が重なるチームでは、リポジトリ数に比例させてノードを増やすべきではありません。同じコードベースの複数ジョブが同じ時間帯に実行されるのか、あるいは同じ Runner を順番に使うのかで、必要容量は変わります。

リモート Mac CI の発行期間には、どれだけ冗長容量を残せばよいでしょうか。 CI の履歴から、発行期間における重要ジョブの同時実行数、待機時間、ジョブ継続時間を抽出し、通常発行と緊急修正が重なる最悪の実測区間を入力にします。ここで具体的な同時実行数や復旧時間を外部記事から借用してはいけません。組織ごとの CI ログに記録された値だけが、そのチームの容量判断に使えます。

キャッシュは依存関係の取得やビルド準備を短縮する可能性がありますが、正しい Xcode、macOS、アーキテクチャを備えたスケジュール可能なノードの代わりにはなりません。キャッシュが残っているためにビルドが始まっても、署名鍵へのアクセスやアーカイブ後のアップロード権限が欠けていれば、発行経路は復旧していないからです。

第二段階:Xcode のバージョンごとに Runner を分ける

安定版、候補版、旧版を同じ予備プールで扱う場合、「空いている Mac」を「どのビルドでも受けられる Mac」と誤認しやすくなります。まず必要な組み合わせを一覧化し、各組み合わせについて重要ジョブの同時実行数を別々に集計します。

運用方式 予備容量の数え方 適する条件 主な欠点
安定版専用の常設プール 安定版の重要ジョブ同時実行数と障害ドメインを基準にする 日常的に発行があり、切り替え確認を継続できる 低負荷時も資源を保持する
発行期間だけの追加容量 発行期間の履歴から得たピークと許容待機時間を基準にする ピークが短く、通常時の負荷が安定している 事前検証なしでは即時利用できない
バージョン別プール Xcode、macOS、アーキテクチャの組み合わせごとに集計する 複数の SDK や候補版を並行運用する 共有による利用率向上が難しい
共通プール 互換性を確認済みの組み合わせだけを共通容量として数える プロジェクト間の要件が近い 低優先度ジョブが容量を占有しやすい

GitHub Actions の自ホスト Runner を使う場合は、Runner のラベル指定で Xcode 系列やアーキテクチャを表し、ワークフローが対象外のノードへ流れないようにします。さらに Runner グループの権限とルーティングで、安定版専用、候補版専用、緊急修正用などの利用範囲を分けます。

複数の Xcode を同じ Runner 池で使う場合、予備ノードはどのように隔離すべきでしょうか。 Runner ラベルだけでなく、ノード側に実際の Xcode、macOS、CPU アーキテクチャ、署名証明書、プロビジョニング設定を記録し、代表的なプロジェクトのビルドが通った組み合わせだけを切り替え対象にします。Apple が説明する xcodebuild の利用方法や選択可能な開発ディレクトリについては、Apple のビルド環境に関するテクニカルノートも確認対象になります。

共有 Runner 池は、優先順位と権限を先に固定する

複数プロジェクトが同じ予備ノードを使う場合、容量不足の原因はノード数そのものではなく、事故中に低優先度の回帰テストが重要な発行ジョブを押し出すことにあります。発行、緊急修正、回帰検証、通常テストの順に優先順位を定義し、事故時には低優先度ジョブを停止または待機させる運用を用意します。

プロジェクト別に Runner グループを分ければ権限境界を明確にできますが、互換性の高い容量を共有しにくくなります。ツールチェーン別のグループはバージョン事故を抑えやすい一方、各プロジェクトの署名材料や秘密情報が同じノードへ流れないよう、アクセス権を追加で確認する必要があります。

切り替え時には、次の項目を記録します。

  • ジョブが要求する Runner ラベルと実際に割り当てられたノード
  • xcode-select や開発ディレクトリが指す Xcode の実体
  • macOS と CPU アーキテクチャの組み合わせ
  • 署名証明書、プロビジョニング設定、キーチェーンのアクセス権
  • Homebrew のパス、依存関係、環境変数
  • アーティファクト保存先、アップロード先、秘密情報への権限
  • 予備ノードへ切り替えた時刻と、元のノードを戻した時刻

KuzCloud の管理コンソールを利用して追加した Mac を運用する場合も、割り当てが完了した時点で切り替え可能とみなさず、上記の代表的な発行ジョブを実行してから容量台帳へ登録します。

発行前に、容量決定チェックを完了させる

アップグレード前

  • [ ] 実際の Xcode、macOS、Command Line Tools のバージョンを記録した
  • [ ] 重要ジョブと、事故中に停止できるジョブを分けた
  • [ ] 発行期間の CI 履歴から同時実行数と待機時間を抽出した
  • [ ] アップグレード対象と予備プールの障害ドメインを分けた
  • [ ] Xcode、macOS、アーキテクチャ別の Runner ラベルを確認した

障害発生時

  • [ ] 重要ジョブを優先し、低優先度ジョブの流入を制限した
  • [ ] 予備ノードが署名、アーカイブ、アップロードまで実行できることを確認した
  • [ ] Homebrew の修復状態だけでなく、Xcode 全体のビルド可否を確認した
  • [ ] 復旧時間が不確実で発行期限が固定なら、先に隔離容量を追加した
  • [ ] 切り替えたジョブ、待機時間、失敗理由を記録した

復旧後

  • [ ] 元のノードを戻す前に、同じ代表ジョブを再実行した
  • [ ] 予備ノードが実際に使われた時間と、待機した時間を分離した
  • [ ] どのバージョン組み合わせが不足したかを記録した
  • [ ] 次回の常設容量と一時追加容量の判断に実測ログを反映した

Homebrew の障害後は、拡張するべきか、元ノードの復旧を待つべきでしょうか。 重要ジョブが待機可能で、すでに検証済みの予備プールが発行期限を満たすなら、無条件の増強は不要です。一方、同じ故障ドメインで複数ノードが失われ、復旧手順が破壊的または時間不明で、発行を延期できないなら、原ノードの修復より先に適合する隔離容量を追加します。

この判断は、ノード数ではなく「検証済みで今すぐジョブを受けられる容量」で行います。Command Line Tools の参照先を直しただけの Mac、署名権限を持たない Mac、必要な旧 Xcode を保持していない Macは、一覧上は空きでも容量計算上はゼロです。

運用上の経験則: 予備プールを常設するかどうかは、平常時の負荷ではなく、発行期限を守れない場合の影響と、予備環境を継続的に検証できるかで決めます。短いピークだけが問題なら、検証済みのクラウド Mac を発行期間に追加する方が合理的な場合があります。

現在の構成がオンプレミスの Mac だけであれば、物理故障、更新作業、署名環境の差分が同じ障害ドメインに集中しやすく、発行直前の一時追加にも時間がかかります。逆に、常設予備を増やしすぎると、低負荷時も未使用の Mac と検証コストを抱えることになります。必要な時期だけ KuzCloud の Mac 容量を申請し、実際の重要ジョブ同時実行数とツールチェーン組み合わせに合わせて隔離できるなら、固定ノード数や未確認の料金を前提にせず、発行リスクと待機資源を比較できます。

まずは CI 履歴から重要ジョブの同時実行数、許容待機時間、Xcode と macOS の組み合わせを整理し、常設プールで守る範囲と発行期間だけ追加する範囲を分けることが先決です。長期にわたり安定した重負荷を処理する組織や、物理インターフェースを必要とする検証では自前環境が適しますが、短期の発行ピークやアップグレード事故の切り替え先を必要とする場合は、検証済みのレンタル容量を候補にできます。

CI用の予備MacをKuzCloudで柔軟に確保しませんか

KuzCloudなら、ビルドやテストに適したリモートMacを必要な台数だけ用意できます。

通常時の常設ノードに加え、リリースや大規模な更新期間だけ一時的に容量を増やせます。