CI/CD

GitLab Runner macOSの分離方法:2026年企業導入ガイド

GitLab Runner macOSの分離は、低リスクで同じ信頼ドメインに属するビルドだけを共有し、正式な署名・公開処理は保護された専用 Mac Runner に分ける構成が適切です。タグや保護ブランチだけでホスト分離を済ませず、Runner の範囲、認証情報、作業領域、復旧状態まで検証できる場合に限って共有を放行します。

この判断が必要なチーム

複数の iOS プロジェクトを管理し、共通の GitLab macOS ビルドプールを準備するプラットフォームチームが対象です。証明書、Keychain、公開用認証情報を守るセキュリティ担当者にも関係します。

Mac Runner の購入、レンタル、混合構成を比較している企業 IT、調達担当者にも有用です。導入時の主眼は「何台用意するか」ではなく、「どのジョブを、どの信頼境界で、どの証拠を残して実行するか」です。

最初に信頼境界を固定する

共有 Shell Runner の典型的な失敗は、あるプロジェクトのジョブが終了した後も、ソースコード、DerivedData、依存キャッシュ、ログ、または認証情報がホスト上に残り、次のジョブから読み取れる状態になることです。macOS Shell executor はジョブを Runner ホストのユーザー権限で実行するため、GitLab 公式の安全説明でもホストとネットワークに対するリスクが明示されています。

判定単位は部署名ではなく、プロジェクト、ジョブ、資産の組み合わせにします。次の条件を満たす処理は、同一信頼ドメイン内の共有ビルドノード候補です。

  • ソースコードの機密度が近い。
  • コミット権限を持つ利用者の範囲が管理されている。
  • 外部コントリビューターが任意の CI 定義を実行できない。
  • 正式な署名鍵や公開用トークンを常時利用しない。
  • ジョブ終了後の残留スキャンを実施できる。

一つでも満たせない場合は、事業部単位の共有ではなく、別の Runner 群または専用ホストへ移します。公開リポジトリや外部から変更可能なパイプラインと、正式リリース用の処理を同一ホストへ無条件に載せる設計は避けてください。

共有・分割・専用を決める条件

  • 共有ビルドノード:同じ信頼ドメインの通常コンパイル、正式署名を持たない検証処理。
  • 分割ビルドノード:機密度やコミット権限が異なる複数チーム、依存キャッシュを共有したくないプロジェクト群。
  • 専用リリースノード:正式な証明書、秘密鍵、Provisioning Profile、公開用認証情報を扱うジョブ。

企業の多くは、通常ビルドを共有プールに置き、機密プロジェクトとリリース処理を専用プールへ分ける混合構成から始めると、過度な遊休容量を避けながら境界を明確にできます。

第一段階:Runner の範囲と実行経路を測定する

GitLab の Runner には、プロジェクト、グループ、インスタンスという異なる管理範囲があります。範囲が広いほど再利用しやすい一方、登録先や管理責任を誤ると、意図しないプロジェクトが実行入口を得ます。範囲の違いは、GitLab 公式の Runner スコープ説明で導入前に確認してください。

測定する指標は「どのプロジェクトが見えるか」「誰が設定を変更できるか」「どのラベルでジョブが到達するか」です。機密度が高いほど、プロジェクト範囲の Runner を優先し、管理者と変更履歴を限定します。

タグは単なる分類名ではなく、ジョブが特定ノードへ到達するための条件です。タグのないジョブを許可したままにせず、リリース用タグを保護対象にし、保護ブランチまたは保護タグからのジョブだけが選択できるようにします。設定方法と Protected Runner の関係は、Runner のタグと保護設定に関する公式資料に沿って確認します。

ただし、タグやブランチの保護はホスト内部の完全分離ではありません。経路の制御に失敗した場合だけでなく、正しく経路制御できた場合にも、作業領域と認証情報の残留を別指標として検査する必要があります。

第二段階:認証情報をノードの役割から切り離す

Runner authentication token、リポジトリの認証情報、Apple の署名証明書、Provisioning Profile、Keychain、App Store Connect 用認証情報は、同じ権限層に置かないでください。Runner の登録や接続に使うトークンと、アプリを署名・公開する資産は、目的も漏えい時の影響も異なります。

GitLab は Runner 認証トークンの扱いにもリスクを示しています。認証トークンのリスクに関する公式説明を確認し、登録情報をリポジトリ内のスクリプトや一般変数へ直接埋め込まない運用にします。

通常のコンパイルノードには正式な配布資産を長期保存しません。リリース Runner では、保護されたパイプラインだけが保護変数を参照できる状態にし、変数の保護条件はGitLab CI/CD 変数の公式仕様で照合します。

検収で取得する証拠は次のとおりです。

  • 変数ごとの保護状態と利用可能な環境。
  • 一時 Keychain の作成時刻、利用ジョブ、消去結果。
  • Runner 認証情報と公開用認証情報のローテーション記録。
  • 未承認ブランチからの署名資産アクセスが拒否されたログ。
  • ジョブ終了後に秘密鍵、Profile、トークンが残っていないスキャン結果。

正式な公開処理を保護された環境へ限定する場合は、保護環境の公式ドキュメントも確認します。保護設定が未検証なら、専用ノードを用意しても放行条件は満たしません。

第三段階:作業領域と清掃状態を検証する

Shell executor の隔離では、ジョブの終了をホストの初期化と同一視しないことが重要です。ソースディレクトリ、DerivedData、依存キャッシュ、生成物、テンポラリ Keychain、ログ、バックグラウンドプロセスを、次のジョブが参照できるか確認します。

固定の作業ディレクトリを使う場合は、ジョブ開始前に期待する所有者と権限へ戻します。ジョブ終了後には、次の項目を検査します。

  • 前回プロジェクトのソースファイルが残っていない。
  • DerivedData とビルド生成物に別プロジェクトの識別情報がない。
  • キャッシュ内に署名ファイルやアクセストークンがない。
  • 一時 Keychain が削除され、関連プロセスも終了している。
  • CI ログへ秘密情報が出力されていない。
  • 失敗したジョブのプロセスやマウント領域が残っていない。

清掃スクリプトは必要ですが、それだけで主催者ホストの隔離を保証するものではありません。信頼度の違うジョブを同一アカウントで実行する場合、清掃漏れ、プロセスの残留、権限設定の誤りが境界を破ります。差分の大きいプロジェクトは、アカウント分離または専用ホストを選びます。

導入時は、意図的に残留ファイルを作るジョブと、その後に別プロジェクトを実行するジョブを用意します。後続ジョブから読み取れないことを確認し、さらに通常のビルドを再実行して成果物、署名、依存解決が壊れていないことを確認します。

第四段階:容量と復旧性を同じ指標で見る

分離を強めるほど、異なるプロジェクト間で空き時間を融通しにくくなります。したがって、ノード数を先に決めるのではなく、キュー待ち時間、ジョブ継続時間、失敗再試行、リリース時間帯、単一ノード障害時の代替経路を記録します。

固定の同時実行数を一般化するのは適切ではありません。Xcode、依存パッケージ、署名処理、テストデータによって負荷が変わるため、実際のプロジェクトのジョブを再生して判断します。Xcode 27 を採用する場合も、Apple のXcode システム要件で macOS とチップの条件を確認し、対象プロジェクトの依存関係を含めて検証します。

容量設計は次の3層に分けると、隔離と可用性の衝突を整理しやすくなります。

  • 通常ビルドプール:同一信頼ドメインの負荷を吸収する共有ノード。
  • 機密・リリースプール:保護されたジョブだけを受ける専用ノード。
  • 一時拡張容量:リリース集中や移行期間に利用する追加ノード。

専用 Runner が1台だけの場合、そのノードの停止が公開工程全体を止める可能性があります。代替ノードへの切り替え、署名資産の再投入、Keychain の再生成、失敗ジョブの再実行を、実際のパイプラインで確認してください。Runner fleet の設計指針も、プールの役割と運用責任を整理する際の基準になります。

第五段階:負のテストを含む放行チェックを実施する

正しいジョブが動くことだけでは、隔離の証明になりません。未承認のプロジェクト、保護されていないブランチ、タグのないジョブ、期限切れの認証情報から、機密ノードへ到達できないことを確認します。

企業向け放行チェックリスト

  • [ ] プロジェクトを信頼ドメイン、ソース機密度、コミット権限で分類した。
  • [ ] 各ジョブに共有、分割、専用のいずれかのノード方針を割り当てた。
  • [ ] Runner の範囲と管理責任者を記録した。
  • [ ] タグのないジョブが機密ノードへ入れないことを確認した。
  • [ ] 保護ブランチまたは保護タグ以外からリリース Runner を選べないことを確認した。
  • [ ] 正常系ジョブで、想定したノードとツールチェーンが使われた。
  • [ ] 未承認ジョブによるソース、Keychain、変数へのアクセスを拒否した。
  • [ ] DerivedData、キャッシュ、ログ、テンポラリ Keychain の残留を検査した。
  • [ ] Runner 認証トークン、署名資産、公開用認証情報を別々に管理した。
  • [ ] ノード停止後に代替ノードでビルド、署名、復旧を再現した。
  • [ ] Xcode 27 と対象プロジェクトの依存関係を実ジョブで確認した。
  • [ ] キュー時間と失敗再試行を記録し、分離による容量不足を判断した。

正のテストが通っても、負のテストに失敗した場合は放行しません。タグ、保護ブランチ、清掃スクリプトを物理隔離の代替と記録している場合は、設計書を修正する必要があります。

購入・レンタル・混合構成を決める基準

自社で Mac を購入すると、長期的に一定の負荷が続く場合は資産を固定しやすくなります。一方で、リリース期だけ増える負荷、拠点をまたぐ運用、故障時の代替機、初期セットアップと消去手順まで自社で管理しなければなりません。

Mac のレンタルは、短期の検証、移行期間、一時的なリリース増加、地理的に分けた Runner の試行に向きます。ただし、契約上の再構築手順、root 権限の範囲、データ消去、接続方法、請求単位を事前に確認してください。KuzCloud の日本語ヘルプでは、利用前に接続と運用条件を確認できます。

最初から大規模な共有プールを購入するより、信頼境界を定義したうえで、隔離された Mac 1台に GitLab Runner、Xcode 27、署名処理、障害復旧を実装する方が、実測に基づく判断につながります。接続や環境の確認にはコンソールを使い、キューと公開処理の実績が蓄積してから共有プールを拡張します。

よくある判断

GitLab の macOS Runner は複数プロジェクトで共有できますか

同じ信頼ドメインに属し、外部から任意の CI 定義を投入できず、正式な署名資産を常時扱わない低リスクのビルドであれば共有できます。ただし macOS Shell executor はホスト上のユーザー権限で実行されるため、異なる信頼ドメインや公開プロジェクトを無条件に同じ Runner へ送る構成は避けてください。

Shell executor で別プロジェクトのファイルを読まれないようにするにはどうしますか

プロジェクト範囲の Runner、保護タグ、保護ブランチ、保護変数を組み合わせ、作業ディレクトリ、DerivedData、依存キャッシュ、ログ、Keychain の残留を検査します。ジョブ終了後の清掃だけを主な防御策にせず、信頼度が異なる処理は別アカウントまたは専用ホストへ分けます。

iOS の署名タスクには独立した Runner が必要ですか

正式な配布証明書、Provisioning Profile、秘密鍵、公開用認証情報を扱う場合は、保護されたパイプラインだけが到達できる専用 Runner が適切です。通常のコンパイルノードに正式資産を長期保存せず、一時 Keychain の生成、利用、消去と、失敗時の漏えい確認を記録できる構成にします。

Runner のタグや保護ブランチでホスト分離を代替できますか

代替できません。タグと保護設定はジョブの経路や変数の利用条件を制御しますが、同じ macOS ホストに残るファイル、キャッシュ、プロセス、ログを完全に分離する仕組みではありません。高機密の署名・公開処理では、経路制御に専用ノードと復旧検証を加えます。

結論:先に1台で境界を証明する

GitLab Runner macOSの分離では、低敏感度で同じ信頼ドメインに属する処理だけを共有し、高機密の署名・公開処理を専用 Runner に置く判断が基本です。プロジェクト範囲、タグ、保護資源、認証情報、残留スキャン、負のテスト、復旧手順がそろって初めて、企業の共有基盤として放行できます。

購入前には、信頼境界とタスク経路を作成し、隔離された Mac 1台で GitLab Runner、Xcode 27、署名処理、障害復旧を検証してください。自社購入だけでは初期投資、故障時の代替、増減するリリース負荷、消去運用が重くなりやすく、一般的なクラウドだけでは Apple の実機環境と署名運用を同じ条件で扱えない場合があります。短期検証や容量の変動が大きい段階では、KuzCloud の Mac レンタルを試験ノードとして使い、実際のキュー時間と復旧結果を確認してから共有ビルドプールと専用リリースプールの台数を決める方法が、調達リスクを抑えやすい選択です。料金条件を比較する場合は、KuzCloud の日本語料金案内で契約前の前提を確認してください。

分離性の高いmacOS開発環境をKuzCloudで整えませんか

プロジェクトごとに専用のMac環境を用意し、共有ホストに依存しない運用を実現できます。

遠隔操作に対応したMacを必要な期間だけ利用でき、ビルドや署名作業を柔軟に進められます。