title: "移行" date: '2026-05-26T00:00:00+08:00' weight: 45 #

データの整合性を保ったまま、あるノードから別のノードにサービスを移行します。移行タスクはソースノードとターゲットノード間でバックアップ、停止、リストア、起動、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 migrate my-app --to edge-1

移行手順 #

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 からロールバックタスクをトリガーします。ロールバックタスクは以下の復旧アクションをサポートします:

失敗したステップに一致するアクションを選択します。例えば、ターゲットがデプロイされた後に移行が失敗したが DNS がまだ更新されていない場合、stop_target と deploy_source だけが必要になるかもしれません。

CLI:

composia task rollback <task-id> --deploy-source --stop-target --rollback-dns

必要のないアクションのフラグは省略します。

関連項目 #

• バックアップ — Rustic のセットアップとバックアップ設定。
• サービス設定 — data_protect と migrate フィールドリファレンス。