デプロイプロジェクト管理プロジェクトの移行

プロジェクトの移行

プロジェクトの移行は、本質的にプロジェクトのコピー + データの同期です。Zeabur のプロジェクトのコピー機能を使用すると、プロジェクト全体(サービス設定、環境変数、ボリュームデータを含む)をワンクリックで別のリージョンに複製できます。バックアップとリストアと組み合わせることで、リージョン間やアカウント間の完全な移行を実行できます。

リージョン間の移行

プロジェクトをあるリージョンから別のリージョンに移動する場合(例:東京からサンフランシスコへ)、最も簡単な方法はプロジェクトのコピー機能を使用することです:

  1. 移行したいプロジェクトを開き、プロジェクト設定に移動します。
  2. プロジェクトをコピー」ボタンをクリックし、ターゲットリージョンを選択します。
  3. コピーが完了するまで待ちます(ボリュームのないプロジェクトはダウンタイムなし、ボリュームのあるプロジェクトはデータサイズに応じて時間がかかります)。
  4. コピー完了後、カスタムドメインを新しいプロジェクトに再バインドします。
  5. 新しいプロジェクトが正常に動作していることを確認したら、古いプロジェクトを削除します。

プロジェクトのコピーはすべてのサービス設定、環境変数、ボリュームデータを引き継ぎますが、元のプロジェクトのドメイン設定は自動的に継承されません。手動で再バインドする必要があります。

詳細な手順については、プロジェクトのコピーのドキュメントをご覧ください。

アカウント間の移行

プロジェクトを別の Zeabur アカウントに移行する場合(例:個人アカウントからチームアカウントへ)、手動で移行を実行する必要があります:

  1. プロジェクト設定をエクスポートプロジェクトのエクスポート機能を使用して、プロジェクトの YAML 設定をダウンロードします。
  2. データをバックアップ — すべてのステートフルサービスのバックアップを作成します:
    • データベース:バックアップとリストアのオンラインバックアップ機能を使用します。
    • 永続ストレージ:オフラインバックアップを使用するか、ファイル管理から手動でダウンロードします。
  3. ターゲットアカウントで新しいプロジェクトを作成 — ターゲットアカウントにサインインし、目的のリージョンに新しいプロジェクトを作成します。
  4. サービスを再デプロイ — エクスポートした YAML 設定に基づいて、新しいプロジェクトに対応するサービスを作成します。
  5. データを復元 — 手順 2 のバックアップを新しいサービスに復元します。
  6. DNS を切り替え — カスタムドメインの DNS レコードを新しいプロジェクトのサービスドメインに向けます。
  7. 確認 — すべてのサービスが正常に動作していることを確認したら、古いアカウントのリソースをクリーンアップします。

重要な注意事項

  • DNS の切り替え — 移行前に DNS の TTL 値を下げて、切り替え後の DNS 伝播を高速化してください。
  • 環境変数 — プロジェクトのコピーでは環境変数が自動的に引き継がれます。アカウント間の移行では手動で再設定が必要です。特にシークレットを含む変数にご注意ください。
  • データバックアップ — 移行前にすべてのデータベースと永続ストレージが完全にバックアップされていることを必ず確認してください。データの不整合を避けるため、移行中は古いプロジェクトへの書き込みを一時停止することを検討してください。
  • Git 連携 — サービスが GitHub リポジトリにリンクされている場合、アカウント間の移行後に新しいアカウントで GitHub 連携を再設定する必要があります。

移行中に問題が発生した場合は、コミュニティフォーラムでお問い合わせください。