CI/CD / DevOps

GitLab Runner macOS 怎麼隔離:2026 企業部署指南

GitLab 官方文件將 Shell executor 的主機與網路風險列為較高等級,因此 GitLab Runner macOS 隔離的獲勝方案不是「所有專案共用一台 Mac」,而是:同一信任域的低敏感建置可以共享;正式簽名與發佈必須使用受保護的專用 Mac Runner;多團隊企業則採用共享建置池加獨立發布池的混合部署。GitLab Shell executor 安全說明已明確說明這項邊界。

這篇文章適合三類決策者:管理多個 iOS 專案、準備建立共享 GitLab macOS 建置池的平台團隊;需要保護憑證、Keychain 和發布憑據的安全負責人;以及正在評估購買、租賃或混合配置 Mac Runner 容量的企業 IT 與採購決策者。

先用信任域定義共享邊界

GitLab macOS Runner 是否能供多個專案共用,不能只按部門、產品線或組織名稱判斷。真正需要確認的是:提交者是否互相信任、原始碼敏感度是否接近、是否使用相同的 Apple 團隊與發布權限,以及流水線能否被外部貢獻者觸發。

Shell executor 直接在 Runner 主機的作業系統使用者權限下執行工作。換言之,流水線不只是「取得一次編譯資源」,還可能接觸工作目錄、依賴快取、DerivedData、暫存 Keychain、環境變數與建置日誌。這就是為何 GitLab Runner macOS 隔離需要先畫出信任邊界,再談標籤配置。

可建立一份「專案—任務—資產」矩陣:

任務類型 可共享條件 必須限制的資產 建議 Runner 邊界
一般編譯與測試 同一信任域、無正式私鑰、無外部不可信提交 原始碼、快取、測試報告 群組級共享建置池
敏感專案建置 提交者與專案權限可追蹤,且能完成殘留清理 原始碼、依賴憑據、日誌 專案級或受限群組 Runner
TestFlight 或 App Store 發佈 僅受保護流水線,發布主體可核實 簽名私鑰、Keychain、Profile、商店憑據 專用、受保護發布 Runner
外部貢獻或不可信工作 無法證明主機層互信 全部主機檔案與環境 不進入正式 Mac Runner

當兩個專案的提交權限、程式碼敏感度與發布資產不同時,即使它們同屬一個部門,也不應直接放入同一共享節點。相反,如果只是同一信任域內的普通測試任務,則可先共享,再以殘留掃描和越權測試決定是否保留。

注意:「同一台主機」不等於「同一個安全邊界」。Shell executor 的工作可繼承主機使用者能看到的檔案;清理腳本只能降低殘留,不能宣稱等同於虛擬機或實體主機隔離。

再按 Runner 範圍與標籤限制入口

GitLab 官方文件將 Runner 範圍分為專案級、群組級與執行個體級等管理層次;範圍越寬,管理便利性越高,但錯誤路由和責任追蹤的影響面也越大。Runner scope 官方文件可作為配置核對基準。

建議按以下順序設計:

  1. 普通編譯節點放在明確的群組範圍,避免讓不相關專案自動看到。
  2. 敏感專案優先採用專案級 Runner,將管理責任收窄到能審核其流水線的人員。
  3. 發布 Runner 僅接受指定標籤,例如由平台團隊統一管理的發布用途標籤。
  4. 禁止未帶標籤的工作進入敏感節點,避免新專案因預設行為誤用發布資源。
  5. 將 Runner 設為受保護,並把可用分支或標籤限制在受保護的發布流程。

標籤只解決「工作應該送到哪裡」,不解決「工作到了之後可以讀取什麼」。受保護分支也只限制部分觸發來源,不能消除工作目錄、快取和 Keychain 的跨任務風險。GitLab Runner 標籤與 Protected Runner 配置應與主機隔離策略一併審核。

驗收不能只看設定畫面,至少要做兩組測試:

  • 正向測試:受保護發布分支可進入發布 Runner,普通建置分支可進入共享池。
  • 負向測試:普通專案、未受保護分支、無標籤工作和未授權群組均無法進入發布 Runner。

若負向測試失敗,後果不是「標籤命名不整齊」,而是未授權流水線可能取得簽名環境;該節點應暫緩上線,先收窄 Runner 範圍或拆分主機。

把身份、簽名資產與主機分成不同層級

GitLab Runner authentication token、原始碼存取憑據、Apple 簽名憑證、Provisioning Profile、Keychain 和 App Store Connect 憑據,不能放在同一個權限層,也不應全部以長期環境變數形式留在普通建置節點。

至少要完成以下映射:

  • Runner authentication token:只用於讓指定 Runner 向 GitLab 連線,不代表流水線應取得發布權限;認證令牌本身也需要輪換與撤銷流程。GitLab Runner 認證令牌風險說明
  • CI/CD 變數:依環境和保護狀態分層,正式憑據不能在非受保護工作中可見。GitLab CI/CD 變數保護機制
  • Apple 簽名私鑰與 Keychain:只在發布 Runner 的短暫工作期間可用,完成後刪除或重置。
  • Provisioning Profile:限制到對應專案與發布流程,避免普通編譯任務取得不必要的配置檔。
  • App Store Connect 憑據:與建置節點分開管理,並限制可呼叫的流水線與發布環境。

對 Xcode 27 的導入,不能只驗證「Xcode 能啟動」。Apple 的官方 Xcode 系統要求應作為 macOS 版本、Apple Silicon 條件與工具鏈相容性的核對依據;若官方要求或企業使用的 Xcode 版本條件變動,建置池必須重新驗證,而不是直接複製舊節點映像。

驗收證據應包括:

  • 受保護與非受保護變數的可見性截圖或匯出紀錄;
  • Keychain 建立、使用、刪除或重置的流水線紀錄;
  • Runner token 輪換和撤銷紀錄;
  • 普通工作嘗試讀取發布資產時的拒絕結果;
  • 發布環境的允許分支、標籤與操作者清單。

用環境基線驗證跨任務殘留

GitLab Shell executor 如何防止專案讀取彼此檔案,答案不是「在腳本最後加一行刪除指令」。企業需要把環境清潔度當成可驗收指標,逐項檢查以下位置:

  • 原始碼工作目錄及隱藏檔;
  • DerivedData、編譯快取和套件管理器快取;
  • 臨時 Keychain、Provisioning Profile 與簽名私鑰;
  • 建置產物、測試報告和壓縮檔;
  • .env、設定檔、錯誤日誌及流水線輸出;
  • SSH 金鑰、Git 憑據和其他暫存認證資料。

固定工作目錄適合高度互信的普通建置池,但不適合正式發布或不可信提交。任務後清理可作為第一層控制;若專案敏感度更高,應升級到獨立作業系統帳號、專用主機或一次性重置環境。

可透過兩種測試確認基線:

  1. 在第一個專案中寫入具識別性的測試字串、檔名和假憑據,完成任務後執行全盤範圍的殘留掃描。
  2. 讓第二個專案回放相同建置流程,確認無法讀取前一個專案的路徑、環境變數、日誌與暫存資產。

若掃描發現殘留,後果是該節點不能承載跨信任域任務;若只能依賴人工執行清理,則應把節點降級為單一專案或單一信任域使用。GitLab 官方也提醒 Shell executor 的主機風險較高,因此不應把腳本清理包裝成完全隔離方案。Shell executor 官方安全說明

以容量指標決定隔離粒度

隔離越細,安全邊界通常越清楚,但共享空閒容量會下降。企業不應引用脫離專案的固定並發數字,而應用真實流水線回放記錄以下指標:

  • 等待時間:工作從排隊到取得 Runner 的時間;
  • 任務持續時間:包含依賴安裝、Xcode 27 編譯、測試和封裝;
  • 重試率:因工具鏈、簽名、網路或節點故障而重跑的比例;
  • 發布窗口:正式版本可接受的最長等待區間;
  • 故障恢復時間:節點不可用後恢復建置的時間;
  • 備援覆蓋:專用發布節點故障時是否有合規替代路徑。

共享建置池適合大量低敏感、同信任域工作;敏感發布池則應優先保證資產隔離與恢復能力。若所有工作都集中到一台專用 Mac,雖然邊界清楚,卻可能形成交付單點;若所有工作都丟進共享池,則可能因排隊或殘留風險影響發布。

GitLab Runner fleet 規劃指南可用於補充節點編排與容量規劃。對企業而言,最穩妥的結構通常是常態共享建置池、敏感發布池,以及按發布窗口臨時增加的隔離容量,而不是追求單一節點承擔全部任務。

以放行清單完成部署驗收

以下清單適合在採購 Mac、租用遠端 Mac 或把既有主機加入 GitLab Runner 前使用。每一項都應保留設定、測試或日誌證據,而不是只由負責人勾選口頭確認。

  • [ ] 已按原始碼敏感度、提交權限、外部貢獻方式和發布權限建立信任域矩陣。
  • [ ] 已把普通編譯、敏感建置與正式發布分成清楚的任務類型。
  • [ ] 已確認每個 Runner 的專案、群組或執行個體範圍,並記錄管理責任人。
  • [ ] 已停用敏感 Runner 的未標籤工作入口。
  • [ ] 已設定受保護 Runner,並只允許受保護分支或發布標籤路由進入。
  • [ ] 已完成普通工作進入發布 Runner 的負向測試,結果為拒絕。
  • [ ] 已完成未授權專案讀取簽名資產的負向測試,結果為拒絕。
  • [ ] 已把 Runner token、CI/CD 變數、Keychain 和 App Store Connect 憑據分層管理。
  • [ ] 已記錄 Keychain 的建立、使用與刪除或重置流程。
  • [ ] 已掃描原始碼、DerivedData、快取、產物、日誌和臨時憑據的任務後殘留。
  • [ ] 已用第二個專案回放建置,確認無法讀取第一個專案的殘留資料。
  • [ ] 已按 Apple 官方系統要求驗證 macOS、晶片與 Xcode 27 工具鏈條件。
  • [ ] 已以真實專案記錄隊列、持續時間、重試和發布窗口,而非採用猜測的固定並發值。
  • [ ] 已測試專用發布節點故障時的備援、撤銷憑據和恢復流程。
  • [ ] 所有未通過項目均已整改、改用更窄隔離邊界,或暫緩接入正式建置池。

企業若需要先驗證遠端 Mac 的連線、Runner 管理與節點交付流程,可先查看 KuzCloud 遠端主機控制台 和 KuzCloud 使用說明。這些內容應放在技術驗收之後,不應取代信任域、負向測試或憑據審核。

FAQ:部署前需要先回答的四個問題

GitLab macOS Runner 可以讓多個專案共用嗎?

可以,但必須限定在同一信任域,並且沒有不同的發布權限、外部不可信提交或高敏感簽名資產。普通編譯可以進入共享池;正式簽名、商店發佈和高敏感專案則應進入受保護的專用 Runner。共享前還要完成殘留掃描與越權測試。

GitLab Shell executor 如何避免專案讀取彼此檔案?

Shell executor 使用 Runner 主機上的使用者權限執行工作,因此不能只靠標籤或工作目錄命名防止讀取。可先縮小 Runner 範圍,再配合任務後清理、帳號拆分、專用主機與殘留回放測試。若無法證明清理有效,應停止跨信任域共享。

iOS 簽名任務是否需要獨立 GitLab Runner?

正式 iOS 簽名任務通常需要獨立或高度限制的 Runner,因為風險包含私鑰、Keychain、Profile、日誌和暫存檔,不只是 CI/CD 變數。該節點應只接受受保護流水線,並在任務後重置或清除簽名環境,普通編譯工作不應共用。

GitLab Runner 標籤和受保護分支能取代主機隔離嗎?

不能。標籤只決定工作路由,受保護分支限制部分觸發來源;兩者都不會清理主機檔案,也不會自動隔離 Shell 工作可見的 Keychain 和快取。它們必須與較窄的 Runner 範圍、專用節點、憑據分層及負向測試共同使用。

由驗收結果決定購買、租賃或混合配置

如果現行方案是所有團隊共用一台本地 Mac 或單一 Shell Runner,常見缺點是跨專案殘留難以證明已清除、正式簽名資產與普通建置共處,以及節點故障或發布高峰時缺乏備援。直接購買更多設備可以增加容量,卻會同步帶來硬體折舊、維護、交付和閒置成本。

對仍在驗證 GitLab Runner、Xcode 27、簽名流程與故障恢復的企業,租用一台隔離的遠端 Mac 往往比立即採購整批設備更容易先取得真實隊列和發布資料;完成回放後,再決定哪些工作留在共享池、哪些工作擴展為獨立發布池。若需求是長期穩定的高負載、必須接觸特定實體周邊,或企業要求完全掌控硬體,直接購買仍可能更合適。

因此,較穩妥的落地順序是:先完成信任域和任務路由矩陣,再以一台隔離的遠端 Mac 驗證 GitLab Runner、Xcode 27、簽名和恢復流程;只有當負向測試、環境基線與容量紀錄均達標後,才擴展共享建置池與獨立發布池。需要臨時算力或測試環境時,可從 KuzCloud 的遠端 Mac 方案開始核對交付條件,再按實際建置資料作出採購決策。

為 macOS CI/CD 建立清晰的隔離邊界

KuzCloud 提供專用 Mac 資源,協助企業按團隊、專案及信任域分隔 Runner 執行環境。

透過遠端 Mac 與彈性租用方案,您可快速配置符合測試、建置及簽名流程需求的 macOS 工作環境。