macOS 27のDocker CIはどうデプロイする?セルフホストMacの2026年ガイド

macOS 27のDocker CIは、Docker Desktopを使ったホスト上のビルドなら、対応OS・ライセンス・実行環境を確認したうえでセルフホストMacに構築できます。一方、Docker container actionやservice containerを使うジョブはLinux runnerへ分けてください。GitHubの公式要件では、これらを実行する自ホストrunnerはLinuxが必要です。(GitHubのrunner要件)
この手順は、Dockerイメージ構築をGitHub Actionsへ追加するDevOps担当者と、Mac上の処理を含むCIを組む開発チーム向けです。
レンタルMacを検討するチーム責任者は、ライセンスだけでなく仮想化と管理権限も確認してください。
最終更新:2026年10月4日。GitHubのrunner要件・登録とルーティングの文書、DockerのMac向けインストール・ライセンス・Buildx文書を照合しています。macOS 27への対応状況は、導入時点のDocker Desktop公式インストール要件と実環境で再確認してください。
導入前のジョブ分解:Macの役割とLinuxの役割
最初にワークフローを、Mac上のshell処理、Dockerイメージ構築、コンテナaction、service containerに分けます。Docker CLIが使えることだけでは、Docker関連の全ジョブをMacで実行できるとは限りません。
| ジョブの種類 | 主な実行先 | 配置判断 |
|---|---|---|
| macOSを必要とするshell処理 | Mac runner | macOS固有のツールや処理が必要な場合に配置 |
| ホスト上からのDockerイメージ構築 | Mac runner候補 | Docker DesktopとBuildxを対象環境で検証してから配置 |
| Docker container action | Linux runner | GitHubの自ホストrunner要件に従う |
| service containerを使うジョブ | Linux runner | GitHubの自ホストrunner要件に従う |
Mac runnerはGitHub Actionsのコンテナactionを実行できますか。
Docker Desktopを導入しても、このジョブのOS要件は変わりません。コンテナactionやservice containerが必要なジョブはLinux runnerへ送ります。Macに残すのは、macOS固有の処理と、ホスト上で実行するDocker CLIによるイメージ構築です。(GitHubの自ホストrunner要件)
| 確認項目 | 確認する内容 | 未確認の場合の判断 |
|---|---|---|
| macOS対応 | Docker Desktopの現行要件に対象OSが含まれるか | 導入を保留し、公式要件を再確認 |
| CPUアーキテクチャ | Macのプロセッサーと必要なビルド対象 | 対象環境でイメージ構築を検証 |
| Docker Desktopの利用条件 | 組織・利用形態がライセンス条件に合うか | 契約条件を確認するまで本番利用しない |
| 仮想化と権限 | 対象環境でDocker Desktopを起動できるか | 管理者に確認し、実機または実際のレンタル環境で検証 |
Docker Desktopの対応OS、インストール条件は更新されるため、macOS 27で利用できると先に決めつけないでください。ライセンスの適用範囲も、チームの規模や利用形態を含めてDocker Desktopのライセンス説明で照合します。仮想化やセットアップに必要な権限は、Macの権限要件も確認してください。
runnerの登録とルーティング:ラベルをジョブ要件に合わせる
macOS 27のGitHub Actions self-hosted runnerはどう登録しますか。
対象がリポジトリ単位か組織単位かを先に決め、GitHubの案内に沿ってrunnerを追加します。登録方法や利用できる操作は設定範囲により異なるため、画面や権限を一律に想定せず、公式のrunner追加手順で対象環境の手順を確認してください。
ラベルはOS、アーキテクチャ、用途を表すように設定し、ワークフロー側の指定と一致させます。runnerグループを使う場合も、グループのアクセス範囲とジョブの要件を合わせます。GitHubはラベルとグループをrunnerの振り分けに使います。ワークフローの書式はrunnerルーティングの公式説明を参照してください。
| ワークフロー側の要件 | runnerに付ける情報の例 | 運用上の確認 |
|---|---|---|
| macOSでのshell処理 | macOS、対象アーキテクチャ、用途 | 意図したMacだけにジョブが割り当たるか |
| ホストからのDockerビルド | macOS、Dockerビルド用途 | Docker Desktopの起動とCLI接続を確認済みか |
| コンテナactionまたはservice container | Linux、必要な用途 | Linux runnerへルーティングされるか |
登録直後に行う疎通確認
runnerがオンラインであることだけでは、ジョブを実行できる保証になりません。GitHubとの通信条件を確認し、テスト用ワークフローで指定ラベルにジョブが割り当たること、終了後にrunnerが期待どおり待機状態へ戻ることを確認します。runnerはチーム側で稼働状態とアクセス権を管理する必要があります。(GitHubの自ホストrunner要件)
Docker Desktop導入後の最小ビルド:ホスト実行を確かめる
macOSの自ホストrunner上でDockerイメージを構築するには。
Docker Desktopを対象のMacに導入して初回起動を完了し、runnerの実行ユーザーからDocker CLIがdaemonへ接続できるかを確かめます。クラウドやレンタルのMacでは、仮想化やインストール権限が自動的に使えるとは限りません。実際のCI環境での確認が必要です。
検証用の小さなDockerfileを用意し、ワークフローのshell stepからBuildxを呼び出します。たとえば、ローカルで成果物を使う検証ならdocker buildx build --tag ci-check --load .のようにビルドします。Buildxの出力方法やキャッシュ指定は用途で変わるため、Buildxのbuildコマンド仕様を確認して選びます。
成功表示だけで合格にせず、次の点を確かめます。
- runnerの実行ユーザーがDocker CLIを呼び出せること。
- Docker daemonへの接続とイメージ構築が完了すること。
- ローカル利用なら期待したイメージが生成され、レジストリーへ送るなら認証情報とpush結果を確認できること。
- キャッシュを設定した場合は、指定した出力先と保存範囲が意図どおりであること。
複数アーキテクチャ向けの成果物が必要なら、単一のMac上で期待どおりに作れると決めつけず、対象環境で個別に検証します。Buildxの対応方法と条件はDockerのマルチプラットフォームビルドガイドを参照してください。ビルド時間やクロスアーキテクチャの結果は実環境で確かめる項目であり、ここでは性能を保証しません。
配置先の判断:条件に応じてMacかLinuxを選ぶ
- macOS固有の処理があり、Docker Desktopの対応・ライセンス・権限を確認できた場合は、Mac runnerを候補にします。
- Docker CLIを使うホスト上のDockerイメージ構築で、対象環境のビルドと成果物を確認できた場合は、そのジョブをMacに配置します。
- Docker container actionまたはservice containerを使う場合は、Linux runnerへ切り替えます。
- Docker Desktopの起動権限や仮想化が確認できない場合は、Macへの割り当てを見送り、要件を満たすLinux runnerなどに処理を分けます。
この分岐は、runnerのラベルだけでなく、job内のactionやservice設定にも合わせてください。MacとLinuxの両方を使う流水線では、処理の依存関係を分け、各jobに必要なラベルだけを指定します。
継続運用の負担:資格情報・キャッシュ・更新を管理する
自ホストrunnerは、登録して終わりではありません。チームがオンライン状態、runnerへアクセスできる人、CIで扱う秘密情報、不要なイメージやキャッシュの削除、runnerソフトウェアの更新を管理します。失敗時にジョブを再実行できるか、終了後に作業ファイルや認証情報が残らないかも、非本番のワークフローで確認してから本番へ広げます。
macOS、Docker Desktop、ワークフローを変更したときは、変更点と検証結果を記録します。失敗時にOS更新、Docker Desktop更新、ワークフロー変更を切り分けやすくなり、変更前後の比較にも使えます。運用者や対象環境の管理方法を確認する場合は、ProxyMacのヘルプとコンソールも参照できます。
現行環境とMac環境の比較:短期検証と長期運用を分ける
現在のLinux中心のCIをそのまま使えば、Dockerのコンテナactionやservice containerを同じrunner上で扱いやすい一方、macOS固有の処理を別環境へ移す必要があります。Mac runnerを追加するとその差を埋められますが、Docker Desktopのライセンス確認、仮想化・権限の事前確認、MacとLinuxそれぞれの保守が発生します。ひとつのrunnerですべてのDockerジョブを処理できるわけではありません。
短期の互換性確認や一時的なCI検証なら、購入前にMac環境でDocker Desktopと実ワークフローを試す方法があります。長期にわたる安定した高負荷運用や物理インターフェースが必要な場合は、レンタルより自社所有のMacなども含めて比較してください。まず対象ワークフローを使って環境条件とLinuxへ分けるjobを洗い出す場合は、ProxyMacの日本語案内を確認し、利用条件と必要な権限を照合したうえで判断できます。