GitHub Agentic WorkflowsはMac Runnerで直接実行できません。2026年11月5日時点で、公式要件はDockerを利用できるLinuxであり、macOSは非対応です。Xcodeなどが必要な作業は、独立した通常のGitHub Actions Macジョブに分けてください。(公式FAQ)
対象読者: GitHub Agentic Workflowsの導入を検討している企業IT担当者、CI/CD基盤の設計者、技術責任者向けです。
Agent処理とAppleプラットフォームのビルドを、どの環境に割り当てるか判断するための実務上の確認点を整理します。
更新情報:2026年11月5日。 GitHubのGA発表、自セルフホストRunnerの要件、FAQ、GitHub ActionsのMac Runner資料を照合しています。公式の対応状況が変わった場合は、構成決定の前に各資料を再確認してください。
GitHub Agentic WorkflowsとMac Runnerの実行境界
GitHubは2026年10月28日にGitHub Agentic Workflowsの一般提供を発表しました。(GA発表) 一方、セルフホスト実行環境の公式要件はLinuxとDockerで、macOSはサポートされていません。(Runner要件と制限)
ここで分けるべきなのは、Agentic WorkflowsをMac上で動かすことと、Agentが関与する開発フローからMacのビルドを依頼することです。後者は、Agentの実行環境をLinuxに保ち、Xcode CIを通常のGitHub Actions Macジョブとして別に構成する設計です。Mac Runner自体の使い方や選択肢はGitHub ActionsのRunner公式資料で確認できます。
Agentに割り当てる作業の見極め
文書の更新、課題の振り分け、レビュー補助などは、XcodeやmacOS専用ツールを必要としない限り、Agent側の候補になります。ただし、作業名だけで適合性を判断するのは避けてください。依存パッケージ、必要な権限、ワークフロー定義、変更可能なファイルを確認し、実際の処理単位で判定します。
Agentの処理がリポジトリを書き換える場合は、生成物を誰が確認し、どの条件で次のジョブに進めるかも決めます。ワークフロー構文ではジョブの実行条件やRunnerを指定できますが、Agent側からMacジョブへの連携が自動的に成立するわけではありません。(GitHub Actionsワークフロー構文)
Xcode CIに分けるApple専用タスク
Xcode、Apple SDK、シミュレーター、またはmacOS専用ツールに依存するビルドやテストは、通常のGitHub Actions Macジョブに割り当てます。Agentの実行基盤でこれらを実行できると仮定せず、必要なツールとジョブの責任範囲を分離してください。
署名や公開を同じ構成に含める場合は、対象の秘密情報にアクセスできるジョブ、実行を許可する変更、承認者を個別に定義します。Agentのサンドボックスを、後続のMacジョブまで含めた安全保証として扱うことはできません。権限の付与やワークフローの安全な利用については、GitHub Actionsのセキュリティ資料を前提に、チームの審査手順を設計してください。
独立ジョブ間の受け渡しと責任
連携では、Agentが作成した変更または作業依頼、Macジョブが必要とする入力、ビルド・テスト結果、失敗理由をそれぞれ明確にします。ジョブ出力やワークフロー成果物を利用する場合も、適用範囲と取得方法をワークフロー定義で確かめてください。GitHubにはジョブ出力の受け渡しと成果物のダウンロードの資料がありますが、これらの機能が特定のAgent構成で自動的に利用できることを意味しません。
運用前に、次の責任分担をチーム内で合意します。
- Agentが生成した変更を確認し、Macジョブの開始を許可する担当者。
- ビルドやテストが失敗したとき、ログを調査して修正依頼を戻す担当者。
- 署名や公開を含む場合に、秘密情報と承認を管理する担当者。
- Macジョブの結果を受け入れる条件と、証跡を保管する場所。
導入を決める比較表
下表の評価記号は、公式の実行境界と運用上の分離のしやすさをもとにした設計評価です。ベンチマークや性能保証ではありません。
| 構成案 | タスク適合性 | 権限・承認の設計 | 運用上の境界 | 評価 |
|---|---|---|---|---|
| Linux上のAgent処理のみ | macOS専用ツールを使わない処理向け | Agentが必要とする権限を個別に確認 | Mac依存のビルドは別途実行が必要 | ○ |
| 通常のMacジョブのみ | XcodeやApple SDKを使う処理向け | 署名・公開の権限と承認をジョブ側で設計 | Agent処理を使う場合は別の実行経路が必要 | ○ |
| Linux Agentと通常のMacジョブを併用 | Agent処理とApple専用タスクの両方がある場合 | 受け渡し、承認、失敗時の責任を明確化 | 各環境の保守と連携確認が必要 | ◎ |
選択の目安は、Apple専用ツールが不要ならLinuxのAgent環境を使い、必要ならMacジョブを追加することです。両方の処理が継続的に発生するチームでは、二つの経路を並行運用する案を評価します。GitHub Agentic Workflowsの処理までMac Runnerに載せる案は、現在の公式サポート境界に合いません。
独立したMacジョブの試験と費用確認
本番に組み込む前に、実際のXcodeビルドまたはテストを一つ選び、必要なツール、ソースの取得方法、認証、成果物、失敗ログを確認します。試験を通じて、Mac環境で作業が完了するかだけでなく、結果をチームが審査できるか、Agent側へ失敗を戻せるかも検証してください。Mac環境への接続手段を比較する際は、リモートアクセスの案内を確認し、必要な接続・運用条件を洗い出せます。
| 検討対象 | 導入前に確認する変数 | 判断に使う証拠 |
|---|---|---|
| Linux Agent環境 | Docker要件、権限範囲、処理対象の依存関係 | Runner要件、ワークフロー定義、実行ログ |
| 通常のMacジョブ | XcodeやSDKの要件、接続方式、必要な認証 | 実際のビルド・テスト結果、成果物、失敗ログ |
| 二つの環境の併用 | 入力と成果物の受け渡し、再実行条件、担当者 | ジョブ出力や成果物の確認記録、承認記録 |
| 費用と運用負担 | 利用期間、稼働時間、保守担当、契約条件 | 実際の見積もり、社内運用工数、契約資料 |
料金やTCOは、実際の利用条件と確認できる見積もりをそろえてから比較します。根拠のない単価を置くのではなく、利用期間、必要な稼働、保守工数、認証や成果物の管理コストを変数として記録してください。Mac Runnerで必要な成果物を取得・確認する手順は、ワークフロー成果物の公式説明も参照できます。
チームの実行経路を決める
Agentic WorkflowsのLinux実行と、Xcode CIのMac実行は、同一Runnerへまとめるのではなく、役割と検証責任を分けて設計するのが適切です。現行環境にMacの実機を追加する場合は、調達、保守、利用期間を含めて比較します。短期の検証や必要な台数を見極める試験では、自社購入だけでなく、リモートMacの利用条件も並べて評価できます。日本向けの利用条件はMacレンタルの案内で確認し、まず実際のAppleプラットフォーム構築タスクを基準に適合性を判断してください。恒常的な高負荷運用や物理接続が必須なら、リモート環境が合うとは限らないため、自社保有を含めて選定します。
よくある質問
GitHub Agentic WorkflowsをmacOS Runnerで動かせますか?
Agentic Workflowsのセルフホスト実行環境として、公式資料が求めているのはDockerを利用できるLinuxです。macOSはサポート対象外と明記されています。Macが必要なビルドを同じAgent実行環境に載せるのではなく、通常のGitHub Actions Macジョブに分離してください。
Agentic WorkflowsがMacをサポートしない理由は何ですか?
現時点で確認できる理由は、公式の実行要件とサポート境界です。セルフホストRunnerにはDockerを備えたLinuxが必要で、macOSは非対応とされています。将来の対応予定を前提にせず、導入時には最新のRunner要件とFAQを再確認してください。
Agentic WorkflowsからMacのビルドをどう依頼しますか?
Agent側で変更案や作業依頼を用意し、通常のGitHub Actions Macジョブに入力として渡す構成を検討します。ジョブの起動方法や成果物の受け渡しは、リポジトリのワークフロー定義に合わせて設計が必要です。ビルド結果と失敗理由を確認できる形で記録し、Agentが作った変更を人が審査する責任も決めてください。
Agentic WorkflowsとXcode CIはどう分担すべきですか?
文書の更新やコードレビュー補助など、XcodeやApple SDKを必要としない処理はAgentの対応範囲と依存関係を確認して割り当てます。Xcodeビルド、Appleプラットフォーム向けテスト、署名などは通常のMacジョブで実行します。署名や公開は権限と承認を別途設計し、Agentの実行環境を安全性の保証とみなさないでください。
Apple専用のビルド処理には、OSXBuildの専有Macを
Linux環境でのワークフロー制御と、Apple向けのビルドやテストを分けて運用するために、専有の物理Macをご利用いただけます。
クラウド Mac のプランを選ぶ