首次開通
從訂單確認到首次驗收
核對所選機型、機房與租期，等待自動準備與憑證簽發。首次進入後記錄節點資訊，並分別驗證命令列、圖形介面與 Xcode 環境。
- 確認訂單狀態與到期時間
- 核對主機指紋後建立首次工作階段
- 保存驗收結果，不保存明文憑證
依工作定位問題
雲端 Mac 說明中心：從連線到建置逐項排查
先確認問題屬於開通、連線、工具鏈、流程、儲存空間或租期，再依序核對節點資訊、憑證、連接埠、磁碟與系統工作。每條路徑都提供檢查項目、可執行動作，以及提交工單所需資訊。
- 6 類工作
- 開通、連線、工具、CI/CD、儲存空間、租期
- 5 步診斷
- 從節點範圍縮小到具體工作
- 2 種支援入口
- 控制台工單與支援信箱
診斷登錄板
依序檢查
先記錄事實，再變更設定
-
01
核對訂單節點 記錄機房、主機名稱與訂單狀態
-
02
確認憑證狀態 檢查金鑰、有效期限與最近輪換時間
-
03
驗證網路路徑 區分 DNS、連接埠與本機網路問題
-
04
查看資源餘量 檢查磁碟空間、記憶體與背景工作
-
05
保留去識別化證據 收集時間、指令、結束碼與部分日誌
建議記錄
節點 · 時間 · 指令 · 結束碼
工作入口
依目前要完成的工作進入對應路徑
不必從頭讀完所有文件。先選擇最接近的工作，再依卡片中的核對順序執行。涉及訂單狀態、到期時間與憑證的事實，以控制台目前顯示為準。
遠端連線
建立 SSH 或 VNC 工作階段
SSH 適合命令列、自動化與通道工作；VNC 適合需要 macOS 圖形介面的操作。先核對節點與憑證，再檢查本機網路與連接埠。
- 首次連線必須核對主機指紋
- 斷線時先區分本機網路與節點工作階段
- 共用裝置不保留敏感連線資料
開發工具
確認 Xcode 與建置環境
使用指令記錄 Xcode 版本、目前開發者目錄與工具鏈狀態。變更版本前先保存目前輸出，避免將專案問題與環境變更混為一談。
- 記錄
xcodebuild -version輸出 - 確認專案、相依項目與快取所在磁碟
- 清理前先保存完整錯誤摘要
CI/CD
驗證 self-hosted runner
先確認 runner 上線、標籤相符與工作目錄權限，再執行最小測試工作。不要一開始就重跑整條流程，否則難以定位失敗環節。
- 核對 runner 標籤與工作條件
- 驗證工作目錄與快取目錄權限
- 保留失敗工作的結束碼與去識別化日誌
儲存空間管理
處理空間、快取與擴充需求
先區分專案檔案、相依項目快取、建置產物與日誌占用。空間持續增加時，再依實際增量選擇 +1TB SSD、+2TB SSD 或調整清理策略。
- 檢查剩餘空間與最大目錄
- 區分可重建快取與業務資料
- 擴充前完成重要資料備份
租期管理
核對續租、到期與遷出
控制台中的訂單到期時間是操作依據。續租後再次核對狀態；計畫結束租用時，提前遷出程式碼、金鑰、憑證、日誌與業務資料。
- 記錄目前到期時間與所需週期
- 續租完成後重新檢查訂單狀態
- 離場前執行備份、撤銷金鑰與清理
快速診斷器
選擇目前失敗的檢查項目
依由外到內的順序檢查。點選最早失敗的項目，登錄板會提供優先處理路徑。若前一項尚未確認，不建議跳到後續步驟直接修改系統設定。
診斷前準備
- 記錄問題發生時間與節點所在機房
- 保留原始指令、結束碼與去識別化日誌
- 一次只變更一個變數，並記錄結果
檢查順序
01—05
處理路徑
從第 01 項開始檢查
先在控制台核對訂單狀態、目標機型與機房。確認記錄一致後，再繼續檢查憑證、連接埠、磁碟與系統工作。
記錄：節點 / 時間 / 現象 / 最近變更
建置問題
先固定工具鏈，再處理專案狀態
建置失敗通常不是單一變數造成。先記錄工具版本與執行環境，再處理簽署、快取、自動化日誌與 runner 條件，避免清理動作覆蓋真正的錯誤證據。
確認 Xcode 版本
執行版本查詢並記錄目前開發者目錄。若專案指定版本與目前環境不同，先確認相容範圍，再進行切換。
xcodebuild -version
xcode-select -p
swift --version驗收：版本、路徑與專案要求一致
檢查簽署環境
確認建置工作能讀取所需憑證、描述檔與環境變數。工單與日誌中只保留名稱、時間與錯誤摘要，不提交有效金鑰。
security find-identity -v -p codesigning
env | sort驗收：目標簽署項目可見且權限正確
有界限地清理 DerivedData
先保存首次失敗輸出，再只清理目標專案相關目錄。不要將全碟清理作為第一步，否則會增加下次建置時間並遺失比對資訊。
du -sh ~/Library/Developer/Xcode/DerivedData
df -h驗收：釋放空間後錯誤可穩定重現或消失
定位 Fastlane 失敗環節
依 lane、action 與底層指令三個層次拆分日誌。記錄第一個真正錯誤、結束碼與執行目錄，不要只截取最後一行摘要。
bundle exec fastlane lane_name --verbose
echo $?驗收：能指出失敗的 action 與第一個錯誤
核對 runner 標籤與權限
確認 self-hosted runner 上線，工作標籤與 runner 標籤完全相符，並驗證執行使用者對工作目錄、快取目錄與建置目錄具備正確權限。
whoami
pwd
ls -ld .
df -h驗收：最小測試工作能夠接收並完成
租期與資源
分開管理到期時間、儲存空間增長與並聯需求
續租解決使用期限，儲存空間擴充解決容量，Thunderbolt 5 並聯解決特定多機工作流程。三者是獨立選項，操作前應分別記錄目前狀態與目標結果。
續租與到期時間
在控制台的訂單記錄中查看目前到期時間，選擇續租週期並完成結帳。續租後重新開啟訂單核對狀態與新到期時間，不以本機行事曆提醒取代訂單事實。
- 操作位置
- 控制台的訂單與租期記錄
- 操作前
- 記錄目前到期時間與所需週期
- 操作後
- 核對訂單狀態與更新後的到期時間
儲存空間擴充
先依目錄占用與增長速度判斷需求。可重建快取應優先清理；程式碼、簽署材料、建置產物與業務資料應先備份，再決定是否增加容量。
- +1TB SSD
- 持續增長的相依項目、快取與建置產物
- +2TB SSD
- 多個專案、大型資產或更長保存週期
- 操作位置
- 控制台訂單中的可用附加選項
Thunderbolt 5 並聯
適用於明確需要多台裝置協作的工作流程。下單前記錄裝置數量、連線目標、資料路徑與驗收方式；每個並聯選項獨立計價。
- 確認對象
- 參與並聯的每個物理節點
- 驗收條件
- 目標裝置可識別、連線穩定、工作可執行
- 操作位置
- 設定訂單時選擇對應附加項目
| 附加選項 | 每日 | 每週 | 每月 | 每季 |
|---|---|---|---|---|
| +1TB SSD | $2.9 | $7.9 | $14.6 | $39.7 |
| +2TB SSD | $5.8 | $15.8 | $29.2 | $79.4 |
| Thunderbolt 5 並聯（每台） | $1.1 | $2.9 | $5.3 | $14.4 |
術語小辭典
八個常見術語，以操作界線說明
術語的價值在於協助團隊對齊操作範圍。以下定義聚焦實際使用，不混淆產品名稱、連線協定與自動化角色。
- 雲端 Mac
- 透過網路遠端使用的 Mac 資源。ArmCLI 雲端 Mac 對應可遠端連線的 Apple Silicon 物理節點，可用於開發、建置、測試與實驗。
- 物理節點
- 實際交付的一台硬體裝置。節點資訊包括機房、主機名稱、連線資料與訂單狀態，排查問題時應先確認操作對象。
- 獨享
- 一張訂單對應一台獨享物理機，租戶之間不共用作業系統執行個體。使用者仍需管理自身程序、權限、金鑰與業務資料。
- 非虛擬機
- 運算工作直接執行於租用的物理節點上，而非與其他租戶共用同一個虛擬化作業系統執行個體。
- VNC
- 用於遠端查看與操作 macOS 圖形介面的連線方式。適合需要視窗、模擬器或圖形工具的工作，連線資料可從控制台訂單取得。
- SSH
- 用於命令列連線、檔案傳輸、連接埠轉送與自動化工作的協定。首次連線應核對主機指紋，並優先使用金鑰驗證。
- self-hosted runner
- 由團隊自行註冊並執行於雲端 Mac 上的流程執行器。工作能否接收取決於上線狀態、標籤條件、權限與工作目錄設定。
- 建置快取
- 為減少重複下載與編譯而保留的中間資料。快取可提升重複工作的效率，但需要容量預算、失效策略與定期檢查。
- 01 輪換金鑰 發生人員異動、裝置遺失、憑證誤傳或疑似異常登入時，撤銷舊金鑰並簽發新金鑰。
- 02 收緊權限 建置工作只取得完成工作所需的目錄、指令與環境變數權限，不以長期高權限憑證取代設定。
- 03 退出異常工作階段 檢查目前使用者、啟用中的終端機與背景程序，結束無法說明的工作階段，並記錄時間與相關工作。
- 04 去識別化日誌 保留指令、時間、結束碼與錯誤情境，刪除存取權杖、私密金鑰、憑證內容、業務資料與內部位址。
- 05 完成離場清理 遷出程式碼與業務資料，撤銷遠端金鑰，刪除暫存快取與敏感檔案，並在控制台核對租期狀態。
升級支援路徑
三步提交可重現、可核對的問題
資訊越完整，就越容易跳過重複確認。先完成工作文件中的最小檢查，再提交節點、時間、指令與去識別化日誌。
-
01
先執行對應工作文件
確認問題屬於連線、工具鏈、CI/CD、儲存空間或租期。記錄已完成的步驟與每一步結果，不要在同一次測試中同時變更多個變數。
-
02
準備最小問題資料包
包含節點與機房、發生時間、執行指令、結束碼、第一個錯誤、最近變更與已嘗試步驟。日誌必須先完成去識別化。
-
03
透過控制台提交工單
已有訂單時優先使用控制台工單，讓問題與節點及服務記錄關聯。購買前問題或無法進入控制台時，可聯絡服務團隊。
如何描述緊急問題
在主旨中寫明「無法連線」「建置受阻」或「訂單狀態異常」，正文提供節點、開始時間、受影響工作與去識別化證據。不要在公開管道傳送有效憑證。
準備開始
選定工作規模後，直接設定獨享物理 Mac
三種在售機型涵蓋新加坡、日本（東京）、韓國（首爾）、香港、美國東部五個機房。實際可用狀態以控制台即時回傳為準。