依急迫程度,挑最快的那條路
自助文件最快,工單最全,電子郵件適合留存紀錄,狀態頁能先幫你排除「是不是平台端的問題」。
拿到憑證後的前十分鐘
開通後 2 分鐘,你會在控制台與信箱收到 SSH/VNC 憑證,照下面三步走,十分鐘內就能進到桌面開始動工。
1. 首次 SSH 登入
憑證裡的主機名稱形如 jp1-1024.hirevps.com,用系統內建終端機即可連線:
# replace host and user with your credentials
ssh omac@jp1-1024.hirevps.com
# first login: change your password
passwd建議登入後立即改密碼,並在控制台上傳 SSH 公鑰、關閉密碼登入,更安全也更省事。
2. 開啟 VNC / 螢幕共享
交機時螢幕共享預設是開啟的;若你手動關閉過,SSH 進去下一條指令即可重新打開:
# enable macOS remote management (screen sharing)
sudo /System/Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/Resources/kickstart \
-activate -configure -access -on -restart -agentMac 上用「螢幕共享」App,Windows/Linux 用任何 VNC 用戶端,位址填主機名稱、埠號 5900。
3. 開發環境自查清單
- 交機映像已預裝 Homebrew、Git 與 Xcode Command Line Tools,終端機跑一次
xcodebuild -version與brew --version確認版本。 - CI/CD 場景先跑一次完整建置當基準:記錄冷啟動與增量耗時,之後排查效能問題有得對照。
- 憑證與金鑰建議放進獨立的 keychain,並在建置腳本裡明確解鎖,避免圖形工作階段鎖定畫面後導致簽章失敗。
- 退租前記得把程式碼與產出物同步回你的儲存庫或物件儲存——清除後資料無法復原(詳見服務條款的資料邊界說明)。
重裝、換版本、搬資料,控制台點幾下就好
這三件事全都能自助完成,不必開工單;重裝與換版本免費、不限次數。
重裝 macOS
控制台 → 你的執行個體 → 「重裝系統」,選好版本後確認,全程約 15~25 分鐘(以實際情況為準)。
重裝會清空整顆 SSD,請先把程式碼推到遠端儲存庫、把產出物拷貝走,再點確認。
更換系統版本
可選目前正式版與上一個大版本(如 Sequoia / Sonoma),部分節點提供 beta 映像,以控制台清單為準。
換版本走的也是重裝流程,同樣會清空硬碟;要做多版本相容性測試時,更推薦按天再開一台,測完就退租。
快照與資料轉移
重裝前可先用 APFS 本機快照保底,跨機轉移推薦用 rsync:
# create a local snapshot before risky changes
tmutil localsnapshot
# sync your workspace to the new machine
rsync -avz ~/work/ omac@new-host:~/work/我們不會讀取、也不會備份你機器裡的資料(詳見隱私權政策),所以重要資料請自行定期同步到遠端儲存庫或物件儲存——本機快照在重裝後同樣會被清除。
把這台 Mac 變成你的建置節點
獨享實體機 + root 權限,串接主流 CI 就是標準官方流程,沒有任何私有魔改。選你在用的那套:
串接 self-hosted runner
在儲存庫或組織的 Actions 設定頁選擇「新增 self-hosted runner(macOS / ARM64)」,把頁面提供的下載與設定指令貼到雲端 Mac 終端機執行:
# run these on your cloud Mac (values come from your Actions settings page)
./config.sh --url <your-repo-url> --token <runner-token> \
--labels macos,arm64,hirevps
# install as a service so it survives reboots
./svc.sh install && ./svc.sh start工作流程裡把 runs-on 改成 [self-hosted, macos, arm64] 即可。M4 實體機跑 xcodebuild 通常比雲端代管 runner 快不少,具體差距以你的專案實測為準。
串接 Jenkins 節點
在 Jenkins 「節點管理」新增一個 agent(啟動方式選 inbound),然後在雲端 Mac 上啟動 agent 程序:
# download agent.jar from your Jenkins controller first
java -jar agent.jar \
-url <your-jenkins-url> \
-name hirevps-m4 \
-secret <agent-secret> \
-workDir ~/jenkins-agent建議用 launchd 把 agent 註冊成開機自動啟動的服務,並幫節點打上 macos-arm64 標籤,方便流水線按標籤排程。需要範例 plist 的話,開個工單我們直接發給你。
三個高頻問題,先照清單自查
開工單前花兩分鐘走一遍對應清單——超過一半的報障在第 2 步就解決了。
連不上機器(SSH 逾時 / VNC 黑畫面)
- 打開狀態頁確認你所在節點是否正常——正常就代表問題大概率在你這一端。
- 本機 ping 主機名稱看是否可達;換手機熱點再試一次,排除公司網路或電信業者對 22/5900 埠的封鎖。
- 登入控制台看執行個體狀態:若顯示「運作中」,先用控制台裡的「遠端重新啟動」;若卡在啟動階段,等 3 分鐘再重新整理。
- 檢查是否改過 SSH 埠或防火牆規則(pfctl)——這是自己把自己鎖在門外最常見的原因,控制台的「救援終端機」可以繞過網路直接進系統改回來。
- 以上都試過仍連不上,直接開工單並勾選「無法連線」,我們按 P1 處理。
建置變慢(xcodebuild 耗時明顯拉長)
- 先確認不是任務本身變了:相依套件升級、Xcode 大版本更新後第一次建置要重建索引與快取,慢一次屬於正常現象。
- top -o cpu 看有沒有失控的程序;Spotlight 第一次建立索引會吃滿 CPU,可用 mdutil -a -i off 關閉。
- 檢查 DerivedData 是否被 CI 每次清空——保留快取目錄通常能把增量建置時間大幅縮短。
- df -h 看磁碟剩餘空間:SSD 占用超過 90% 時寫入效能會下降,先清空再對比看看。
- 你的機器是獨享實體機,不存在鄰居搶資源的問題;若排除以上因素仍持續變慢,開工單附上前後兩次建置日誌,我們幫你查硬體層面。
磁碟空間不足(No space left on device)
- 先找出占用大戶:du -sh ~/Library/Developer/*——Xcode 的 DerivedData、舊模擬器執行環境和 Archives 通常占最多空間。
- 安全清理:rm -rf ~/Library/Developer/Xcode/DerivedData;刪除不用的模擬器執行環境用 xcrun simctl runtime delete。
- APFS 本機快照也占空間:tmutil listlocalsnapshots / 查看,tmutil deletelocalsnapshots 刪除舊快照。
- CI 機器建議在流水線裡加入定期清理步驟,別等到滿了才處理。
- 清完還是很緊繃?代表該升級規格了——升級 SSD 只需補差額,資料轉移方法見上方手冊,或直接到方案頁選更大的檔位。
白紙黑字的回應承諾
工單依影響範圍分三級,分級由你提單時選擇、我們複核確認;承諾只寫我們做得到的。
| 等級 | 典型情境 | 首次回應 | 服務時段 |
|---|---|---|---|
| P1 緊急 | 機器無法連線、硬體故障、節點無法使用 | ≤ 30 分鐘 | 7×24 全年無休 |
| P2 受影響 | 效能異常、重裝卡住、網路間歇性斷斷續續 | ≤ 4 小時 | 7×24 全年無休 |
| P3 一般 | 使用諮詢、帳單疑問、配置建議 | ≤ 12 小時 | 工作日 |
可用性與賠付規則
- 單一執行個體月度可用性承諾 99.9%,所有節點全年 365 天持續運作,沒有計畫性的停機時段。
- 實測可用性每低於承諾 0.1%,賠付當月費用 5% 的等額代金券,單月賠付上限為當月該執行個體費用的 100%。
- 賠付在控制台提交申請,附上故障時間段即可,我們會對照監控資料核算,7 個工作日內入帳。
- 因不可抗力或你自身操作(如誤刪系統檔案、改壞網路設定)導致的無法使用,不計入賠付範圍——但我們照樣會幫你修復。
服務狀態與公告,一頁看全
新加坡、東京、韓國、香港、美西五個節點的即時可用性、歷史數據和事件公告都公開在狀態頁;若有任何影響服務的事件,進展也會在同一頁面持續更新。報障之前先看一眼,能幫你立刻分清「是平台端的問題」還是「是本地端的問題」。
-
JP 東京即時可用性與歷史曲線見狀態頁
-
SG 新加坡即時可用性與歷史曲線見狀態頁
-
US-W 美西即時可用性與歷史曲線見狀態頁