雲端 Mac 發生問題，分層排查，不靠猜

1. 01

   核對執行個體與本機環境

   先確認執行個體處於正常執行狀態，並將控制台顯示的主機位址與使用者名稱分別寫入本機環境變數。不要將密碼、私鑰或完整認證資料寫入儲存庫、聊天記錄或自動化日誌。

   export MAC_HOST="控制台顯示的主機位址"
   export MAC_USER="控制台顯示的使用者名稱"
   test -n "$MAC_HOST" && test -n "$MAC_USER" && echo "connection variables ready"

2. 02

   首次連線並核對主機指紋

   執行連線後，核對終端顯示的指紋與控制台資訊。若主機位址變更、重新安裝後指紋變更，或本機保存了舊記錄，不要直接忽略警告，應先確認執行個體是否仍為同一台裝置。

   ssh -v "$MAC_USER@$MAC_HOST"
   ssh-keygen -F "$MAC_HOST"

3. 03

   產生並安裝獨立金鑰

   建議為雲端 Mac 個別產生 Ed25519 金鑰，方便輪替與撤銷。安裝公開金鑰後保留目前工作階段，再開啟第二個終端驗證金鑰登入成功，確認無誤後再結束原工作階段。

   ssh-keygen -t ed25519 -a 64 -f "$HOME/.ssh/macrents_build"
   cat "$HOME/.ssh/macrents_build.pub" | ssh "$MAC_USER@$MAC_HOST" 'umask 077; mkdir -p ~/.ssh; cat >> ~/.ssh/authorized_keys'
   ssh -i "$HOME/.ssh/macrents_build" "$MAC_USER@$MAC_HOST"

4. 04

   固定用戶端設定並執行基準檢查

   為該執行個體設定獨立別名、金鑰路徑與保活參數。登入系統後記錄 macOS 版本、可用磁碟空間、目前使用者與系統時間，之後建置失敗時即可快速判斷環境是否發生變化。

   sw_vers
   whoami
   date
   df -h /
   uptime

xcode-select -p
xcodebuild -version
xcodebuild -showsdks
xcrun simctl list devices available
xcrun --find swift
swift --version
security list-keychains -d user
security find-identity -v -p codesigning

set -o pipefail
xcodebuild -workspace Project.xcworkspace -scheme Project -configuration Release -destination 'generic/platform=macOS' clean build | tee "$HOME/logs/xcode-build.log"
printf 'exit_code=%s\n' "$?"