工程操作指南

讓雲端 Mac 從交付就緒到穩定重複執行

不必從概念開始。先核對訂單與節點資訊,再設定存取憑證、Xcode、持續整合與 MLX 推論環境。每個章節都列出檢查順序、完成條件,以及應保留的診斷資訊。

服務類型
獨享實體機,非虛擬機
啟用時間
約 4 分鐘
運作狀態
全年 365 天穩定運作
節點狀態清單 首次啟用指南
4 項檢查
01
訂單與節點 機型、區域、租期與加購項目一致
核對
02
存取憑證 首次連線後立即更新並妥善保管
更新
03
開發工具鏈 確認 macOS、Xcode 與命令列工具版本
驗證
04
網路與工作目錄 檢查連線、剩餘空間與工作目錄權限
就緒
完成條件 可連線、可建置、可重現
首次啟用

4 分鐘啟用清單

從確認訂單後開始計時。實際可用狀態以控制台即時回報為準;若任何步驟的資料不完整,請勿跳過並繼續設定。

  1. 01
    核對訂單 約 45 秒

    確認機型、節點區域、租期與加購項目符合需求。基本方案為 M4、16GB、256GB;高記憶體方案為 M4 Pro、64GB、2TB。若配置不符,請先停止後續操作並提交服務單。

    • 記下訂單編號與節點區域。
    • 確認 SSD 擴充與 Thunderbolt 5 設備串接需求。
  2. 02
    取得節點資訊 約 2 分鐘

    等待自動指派與系統檢查完成,再從控制台查看節點位址與連線資訊。請勿將連線資訊轉傳至公開頻道,也不要在程式碼儲存庫中保存未加密的憑證。

    • 確認位址與訂單所列區域相符。
    • 將初始資訊存放在團隊核可的憑證管理工具中。
  3. 03
    更新存取憑證 約 1 分鐘

    首次連線後立即更新憑證,並為自動化工作設定專用金鑰。互動式帳戶與 CI 執行帳戶應分開,避免指令碼取得不必要的系統權限。

    • 更新初始密碼,並確認新憑證可正常使用。
    • 為命令列連線準備金鑰,並核對主機指紋。
  4. 04
    驗證系統與網路 約 15 秒

    記錄 macOS 與 Xcode 版本,檢查預設路由、網域名稱解析、可用磁碟空間及工作目錄的寫入權限。完成後執行小型建置或推論請求,確認環境能產生可驗證的結果。

開發環境

先固定 Xcode 與簽署環境基準

可重複建置需要明確的版本、可存取的鑰匙圈,以及一致的命令列工具。不要以「圖形介面能開啟專案」取代命令列驗收。

設定順序

  1. 01
    確認 Xcode 版本

    記錄完整版本號與建置編號,確認專案所需的 SDK、模擬器執行環境與最低系統版本均已備妥。

  2. 02
    匯入憑證與描述檔

    只匯入目前專案所需的資料,命名時註明專案與用途,避免多人交接後無法辨識來源。

  3. 03
    檢查鑰匙圈權限

    使用目標執行帳戶確認可讀取私密金鑰。自動化建置應先完成非互動式簽署測試,避免佇列卡在權限確認畫面。

  4. 04
    選擇命令列工具

    確認目前選用的是預期的 Xcode,並將結果記錄在專案環境文件中。切換版本後,務必重新檢查相依套件與簽署設定。

  5. 05
    完成首次建置驗證

    先清除舊產物,再執行測試、封存與簽署驗證。保留命令、結束代碼、記錄檔路徑及最終產物的校驗值。

持續整合

將執行器視為固定資源,而非暫存目錄

獨享實體機提供固定硬體資源,但工作仍可能因快取污染、並行過多或記錄不足而失敗。串接前請先定義目錄與清理責任。

01

安裝自架執行器

為執行器建立專用系統帳戶與服務目錄,只授予建置所需的權限。完成註冊後,先執行不含簽署的小型工作,驗證佇列、網路與結束狀態。

完成條件:重新啟動後可自動恢復接收工作
02

規劃工作目錄

將原始碼檢出、相依套件快取、暫存建置、封存產物與長期記錄分開。工作結束時只清理暫存目錄,避免誤刪後續工作需要的共用快取。

完成條件:目錄擁有者與清理規則明確
03

限制並行數量

先以單一工作建立記憶體、磁碟與耗時基準,再逐步增加並行數。Xcode 建置與 MLX 推論同時執行時,應分別監控記憶體峰值與磁碟寫入量。

完成條件:尖峰時不發生交換空間或磁碟空間耗盡
04

保留失敗記錄

失敗的工作至少保留工作編號、提交版本、執行器版本、開始時間、結束代碼、關鍵記錄與產物路徑。上傳前請移除記錄中的權杖與簽署資料。

完成條件:其他團隊成員可獨立重現問題
快取清理範圍

優先依專案、分支與工具版本建立快取鍵。不要用定時清除整顆磁碟取代容量管理;清理前先確認沒有建置或封存工作正在執行。

AI 與 MLX

推論服務必須可測試、可監控、可復原

先讓單一請求順利完成,再增加上下文長度與並行數。模型目錄、執行環境與服務記錄必須分開,避免更新相依套件時同時破壞模型檔案。

MLX 服務設定指南 從單一請求基準開始
Apple Silicon
環境隔離
每項服務使用獨立的 Python 環境,鎖定相依套件版本並保存安裝清單。
模型目錄
模型檔案與原始碼分開存放,記錄模型名稱、量化格式、校驗值與使用空間。
監聽範圍
預設只監聽工作所需的介面與位址,不要將偵錯端點公開給無關網路。
並行壓力測試
依序測試 1、2、4 個並行請求,記錄首個 token 延遲、總耗時、失敗率與記憶體峰值。
記憶體監控
區分模型常駐記憶體、上下文增長與請求快取,接近穩定上限前停止增加負載。
重新啟動策略
將啟動命令、工作目錄、環境變數與記錄檔路徑寫入服務設定,並確認異常結束後可復原。
儲存與設備串接

依工作集選擇儲存空間,不要憑專案名稱猜容量

先計算原始碼、相依套件、模型、建置產物、記錄檔與暫存檔的尖峰總量,再預留清理與復原空間。基本 SSD 容量依所選機型而定。

ArmMesh M4

256GB 基本 SSD

適用於程式碼檢出、一般相依套件快取、單一專案建置與短期發布工作。大型模型、多版本 Xcode 執行環境或大量影片素材,請先估算尖峰空間。

ArmMesh M4 Pro

2TB 基本 SSD

適用於大型模型儲存庫、長期建置快取、多專案並行與影音匯出。固定容量不代表不必清理,仍應設定記錄與產物的保留期限。

儲存空間與 Thunderbolt 5 加購項目價格,以美元計價
加購項目 每日 每週 每月 每季 適用情境
+1TB SSD $2.4 $6.4 $11.9 $32.4 相依套件快取、建置封存檔或中型模型超出基本容量時適用。
+2TB SSD $4.8 $12.8 $23.8 $64.8 大型模型、長期保留產物或影音工作流程需要更大工作集時適用。
Thunderbolt 5 設備串接(每台) $1.2 $3.2 $5.9 $16 多台設備協作前,先確認工作拆分、資料同步、失敗復原與結果彙整方式。

多台設備串接前的五項檢查

  • 工作能否拆分為彼此獨立且可重試的單位?
  • 輸入資料是否有唯一來源?是否可能被多台設備同時寫入?
  • 模型、相依套件與工具版本能否保持一致?
  • 故障節點上的工作能否安全移轉,且不會重複產生結果?
  • 輸出產物是否有統一的命名、校驗方式與彙整位置?
故障排查

先縮小問題範圍,再調整設定

每次只變更一項條件,並記錄變更前後的結果。反覆重裝、清除快取或同時修改網路與工具鏈,會讓真正原因更難判斷。

無法連線

從本機網路一路檢查到節點狀態

  1. 確認本機網路正常,且未遭代理伺服器或防火牆阻擋。
  2. 重新確認節點位址、連接埠與主機指紋。
  3. 檢查憑證是否已更新,以及複製時是否帶入空格。
  4. 在控制台確認節點狀態,再記下用戶端版本與完整錯誤訊息。
速度異常

分辨延遲、頻寬與節點負載

  1. 在固定網路環境中重複測試,排除無線網路波動。
  2. 分別比較互動延遲與檔案傳輸速度,不要混為一談。
  3. 檢查是否有建置、同步或推論工作正在占用資源。
  4. 記錄存取位置、節點區域、時段與連續測試結果。
建置失敗

先判斷是程式碼問題還是環境問題

  1. 固定提交版本,並重新執行相同的建置命令。
  2. 記錄 Xcode、SDK、相依套件與命令列工具版本。
  3. 檢查簽署資料、鑰匙圈權限與工作目錄權限。
  4. 清除目前專案的暫存產物後重試,不要清除整顆磁碟。
磁碟空間不足

先找出空間增加的來源,再決定是否擴充

  1. 分別統計模型、相依套件快取、封存檔、記錄檔與暫存目錄。
  2. 確認是否有重複模型、舊封存檔或未完成工作留下的檔案。
  3. 依保留規則清除可重新產生的內容,再重新記錄尖峰用量。
  4. 若尖峰用量仍超出安全餘裕,再選擇 +1TB 或 +2TB SSD。
推論程序結束

比較請求規模與記憶體峰值

  1. 確認程序是在啟動、載入模型或處理請求時結束。
  2. 檢查模型格式、上下文長度與並行數是否有變更。
  3. 查看結束前的記憶體、磁碟與服務記錄。
  4. 先以單一請求恢復基準,再逐步增加負載。
憑證失效

停止重試,先確認變更來源

  1. 確認使用的是互動式帳戶還是自動化帳戶。
  2. 確認近期是否更新密碼、金鑰或存取成員。
  3. 移除指令碼與快取中的舊憑證,再測試新憑證。
  4. 若無法確認變更來源,請透過控制台提交服務單。
服務請求

提供足夠資訊,讓服務單能直接開始排查

技術問題建議優先透過控制台提交服務單,方便關聯訂單與節點。若無法登入控制台,可寄送電子郵件至 support@armmesh.com。

提交前請準備以下六項資訊

01 訂單編號

提供發生問題的訂單編號;若多個節點受影響,請分別列出,不要只填團隊名稱。

02 節點區域

註明實際使用區域,並說明問題只發生在單一節點還是多個節點。

03 macOS 版本

附上完整版本與建置編號;若涉及建置問題,也請提供 Xcode 與命令列工具版本。

04 發生時間

註明時區、首次與最近一次發生時間,以及問題是否能穩定重現。

05 重現步驟

從正常狀態開始,逐步列出操作、輸入、預期結果與實際結果。

06 去識別化記錄

保留時間戳記、錯誤碼與上下文,移除密碼、金鑰、權杖、簽署資料與專案機密。

下一步

先選擇實體節點,再依清單完成驗收

兩種機型皆為獨享實體機,非虛擬機,提供日租、週租、月租與季租。節點實際可用狀態以控制台即時回報為準。