DevOps / CI/CD

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

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の日本語案内を確認し、利用条件と必要な権限を照合したうえで判断できます。

自社運用のCI環境に、専用のクラウドMacを

ProxyMacなら、専用のMac実機を使ってmacOS向けのビルド環境を構築できます。
SSHやVNCから接続できるため、用途に合わせて作業環境を柔軟に管理できます。