2026年短週期突發建置：GitLab CI 自託管 macOS Runner 接雲 Mac 的 Shell Executor、快取鍵與標籤策略——和 GitHub Actions 混用時的決策矩陣與可執行參數 FAQ

短週期「突發」建置最怕兩件事：佇列把釋出視窗擠掉、快取把環境悄悄弄髒。把 GitLab Runner 註冊到雲端 Mac 並選用 shell 執行器，可直接複用你在機器上已驗證過的 Xcode、Ruby／CocoaPods 與簽章鑰匙圈，省去 Docker on Mac 或 SSH 遠端腳本多一層抽象；代價是同一使用者家目錄下的全域狀態，得靠標籤與快取鍵自己管住。以下依我們線上常用參數撰寫，可直接改倉庫裡的 .gitlab-ci.yml 試跑；若還在評估「第二條 macOS 流水線或把 Job 拆到 Linux」，可先讀 2026年短週期衝刺：加開第二條 macOS CI 流水線還是把 Job 拆到 Linux 代理？排隊成本與金鑰隔離決策矩陣與 FAQ。

Shell Executor：何時值得接雲 Mac

當 Job 主要是 xcodebuild、Archive、notary 或依賴本機鑰匙圈的腳本時，shell 比容器執行器省事：路徑、權限與（若需要的）GUI 工作階段都和人工登入除錯一致。建議為 Runner 另建系統使用者或至少獨立 Home，避免與人工桌面共用 DerivedData；並發大於 1 時務必評估磁碟 IO 與 codesign 鎖競爭，否則 wall time 會被尾延遲拖長。Controller 與 Agent 分層的 Jenkins 場景可對照 2026年Jenkins混合拓撲：Controller駐輕量VPS與雲Mac Agent的JNLP回連及企業資源池落地清單，概念可平移到 GitLab 與雲端 Runner 池。

快取鍵：讓「快」不犧牲「準」

GitLab 的 cache:key:files 建議至少納入 Gemfile.lock、Podfile.lock、Package.resolved 等與編譯相關的鎖檔；Xcode 大版本升級時另拼一段 MACOS_CI_IMAGE_ID 變數，避免舊 DerivedData 混進新工具鏈。policy 用 pull-push 適合主幹高頻分支，僅對發布分支或 nightly 開啟全量 push，可減輕物件儲存寫放大。

cache:
  key:
    files:
      - Gemfile.lock
      - Podfile.lock
      - YourApp.xcworkspace/xcshareddata/swiftpm/Package.resolved
    prefix: "${CI_COMMIT_REF_SLUG}-xcode${XCODE_VERSION}"
  paths:
    - .cocoapods/
    - ~/Library/Developer/Xcode/DerivedData/
  policy: pull-push

標籤策略：burst、steady 與「只跑雲 Mac」

以 tags 把 Runner 分成 mac-burst（彈性雲節點，允許搶占與較短逾時）與 mac-steady（合約內固定配額，跑簽章與上架）。預設流水線只打 burst；需鑰匙圈解鎖或人工值守的步驟另開 job 並打 steady，避免突發任務擠占關鍵路徑。機型維度可選 mac-m4 等標籤，與企業資源池買租與地域策略一併看：2026年企業遠端 Mac Runner 資源池買還是租：M4 與 M4 Pro、六地域延遲與併發標籤維運決策矩陣。

與 GitHub Actions 混用：決策矩陣（簡版）

雙平台常見動機是：開源側仍在 GitHub，私有制品與內網依賴在 GitLab。原則是「誰離程式碼與金鑰最近，誰跑重 Job」。若 GitHub 已有成熟的 macOS workflow，可把輕量檢查留在 Actions，把需要內網快取或 GitLab Registry 的步驟遷到自託管 Runner；反之亦然。兩邊都開快取時，請用不同 bucket 前綴與 key，避免同名互相覆寫。

ios_burst:
  stage: build
  tags: [mac-burst]
  rules:
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
  variables:
    GIT_STRATEGY: fetch
    FASTLANE_OPT_OUT_USAGE: "1"
  script:
    - xcodebuild -version
    - bundle exec fastlane ci_unit