遷移

將服務從一個節點遷移到另一個節點，同時保持資料完整性。遷移任務協調跨來源和目標節點的備份、停止、還原、啟動和 DNS 更新步驟。

設定

遷移期間攜帶的資料項目必須在 data_protect 中同時具有 backup 和 restore 操作。在 migrate 中宣告它們：

name: my-app
nodes:
  - main

data_protect:
  data:
    - name: uploads
      backup:
        strategy: files.copy
        include:
          - ./data/uploads
      restore:
        strategy: files.copy
        include:
          - ./data/uploads

migrate:
  data:
    - name: uploads

執行遷移

Web UI：

1. 開啟服務詳細頁面。
2. 使用遷移控制項選擇來源和目標節點。
3. 點擊 遷移。

CLI：

composia service my-app migrate --source main --target edge-1 --wait --follow --timeout 30m

遷移步驟

1. 匯出資料 — 在來源節點上為每個已設定的資料項目執行備份任務。
2. 停止來源執行實例 — 執行 docker compose down，移除 Caddy 設定。
3. 在來源端重新載入 Caddy — 從來源 Caddy 執行實例中移除代理項目。
4. 在目標端還原資料 — 在目標節點上為每個資料項目執行還原任務。
5. 在目標端部署 — 執行 docker compose up -d，同步 Caddy 設定。
6. 在目標端重新載入 Caddy — 在目標 Caddy 執行實例上套用代理項目。
7. 更新 DNS — 更新 DNS 記錄以指向目標節點。
8. 寫入設定 — 更新 composia-meta.yaml 中的 nodes，提交到 Git。

注意事項

• 服務必須部署在來源節點上，且目標節點必須在線。
• 遷移會造成短暫停機。請在離峰時段執行。
• 為確保一致性，資料傳輸前會先停止來源執行實例。
• 對於資料庫，使用匯出策略（database.pgdumpall / database.pgimport）。

回復

狀態回復目前僅在 Web UI 中提供。開啟遷移任務詳細資料，選擇與失敗步驟相符的復原操作，然後啟動回復。

CLI 目前還沒有 task rollback 命令，但仍可透過以下命令檢查並追蹤遷移任務：

composia task wait --follow --timeout 30m <task-id>

參見

• 備份 — Rustic 設定與備份設定。
• 服務設定 — data_protect 和 migrate 欄位參考。