Cloud Managerによって監視されているクラスターの Atlas へのライブ移行（プッシュ）

In Atlas で、プロジェクトの Migration Hub に移動します。

1. まだ表示されていない場合は、プロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。

2. まだ表示されていない場合は、ナビゲーション バーの Projects メニューからプロジェクトを選択します。

3. サイドバーで、 Services見出しの下のMigrationをクリックします。

移行ハブが表示されます。

移行プロセスを開始します。

1. [Migrate from a Self-Managed MongoDB Database] をクリックします。

   注意

   UIラベルにはMongoDB Ops Managerが含まれていますが、この手順では、 MongoDB 6.0 以降を実行中クラスターのみをCloud Manager が監視する Atlas に移行できます。

2. [I'm Ready to Start] をクリックします。

Atlas には、プロセスの進め方を示すライブ移行ウィザードが表示されます。 このプロセスは、ソースクラスターのデータを新しい宛先クラスターにプッシュします。 ウィザードの手順を完了したら、お使いのアプリケーションが新しいクラスターに向くよう設定できます。

Atlas とのリンク。

1. [Generate Link-Token をクリックします。Atlas に、 トークンリンクを生成するためのページが表示されます。

2. 生成されたトークンリンクを含むページを表示するには、 Nextをクリックします。

3. トークンリンクをコピーし、安全な場所に保存します。 Atlas はトークンリンクの内容を表示しません。 また、Atlas はトークンリンクを生成した後、そのトークンを表示しません。 公開共有しないでください。

   注意

   1 つのCloud Manager組織内のすべてのプロジェクトを Atlas にライブ移行するには、1 つの固有のトークンリンクを使用します。

4. [Done] をクリックします。

トークンリンクを Cloud Manager に貼り付けます。

1. Cloud Manager で組織にアクセスします。

   Cloud Manager を開き、Atlas にライブ移行するプロジェクトのクラスターが属する組織に移動します。

2. 左側のナビゲーションパネルで [Settings] をクリックします。

3. Live Migration: Connect to Atlasセクションで、 Connect to Atlasをクリックします。 Connect to Atlasダイアログ ボックスが開きます。

4. ライブ移行ウィザードの前のステップで生成したトークンリンクを貼り付け、 Connect to Atlasをクリックします。 Cloud Manager は Atlas への接続を確立します。 必要に応じて、 Refreshボタンを使用して更新内容を Atlas に送信します。

宛先 Atlas クラスターを作成します。

If you haven't already, create a destination cluster in Atlas. See Required Access.

宛先クラスターから移行を開始します。

1. [Select Target Cluster from Projects] をクリックします。

2. GoAtlas宛先の クラスターのプロジェクトに し、宛先クラスターを見つけます。

3. をクリックします移行を開始するには、ドロップダウン リストから [ Migrate Data to this Clusterを選択します。 Migrate Data to This Clusterページが開きます。

4. [Migrate from a Self-Managed MongoDB Database] をクリックします。

   注意

   UIラベルにはMongoDB Ops Managerが含まれていますが、この手順では、 MongoDB 6.0 以降を実行中Atlas クラスターからCloud Manager が監視する Atlas への移行のみが可能です。

   次のように フィールドに入力します。

   • Cloud Manager でソース プロジェクトを選択します（まだ選択していない場合）。

   • ドロップダウンからソースクラスターを選択します。

   • レプリカセットをシャーディングされたクラスターに移行する場合、次の手順に従います。

     • コレクションをシャーディングする場合は、Include sharding parameters のチェックマークをクリックし、シャーディングの例を使用してシャーディング構成 JSON をテキストボックスに貼り付けます。後で参照する場合に備えて、この構成を外部ファイルに保存します。

       The sharding configuration JSON defines the shardingEntries array, which specifies the collections to shard, and the keys to use for sharding. MongoDB shards only those collections that you include into this array. To learn more, see Sharding.

       シャーディング構成の指定を省略する場合は、クラスターを Atlas に移行した後に、宛先クラスターでコレクションをシャードできます。

     • シャーディング構成に加えて、指定されたシャーディングキーの互換性のあるインデックスがサービス内の宛先クラスターに存在する必要があります。

       Create supporting indexesのチェックマークをクリックすると、MongoDB が Atlas の宛先クラスターにサポートするシャードキー インデックスを自動的に作成するようになります。

   • 移行を処理するための移行ホストを選択します。

   • プライベートエンドポイントを使用していない場合は、IP アドレス アクセス リストを確認し、移行ホストの外部 IP アドレスがこのリストに含まれていることを確認します。 追加されていない場合は、ここで追加します。

     • クリック Set Network Access for Host

     • クリック + Add IP Address

     • ライブ移行ウィザードに戻ります。 ドロップダウンからソースクラスタを選択し、 の下でMigrate data to this clusterを選択します。 。

   • ドロップダウンからソースクラスターを選択します。

   • ソースクラスターが認証を強制する場合は、表示されたテキストボックスにユーザー名とパスワードを入力します。

     Atlas ライブ移行に必要なユーザー権限に関するガイダンスについては、 「移行元のクラスターのセキュリティ」 を参照してください。

   • If you suspend the source cluster from automation in Cloud Manager, but continue to monitor the source cluster with the Monitoring Agent, the Username and Password display. If your deployment requires user authentication, provide the user name and password in these fields. The database user whose credentials you provide must have at least the backup role on the admin database and must be authenticated using both SCRAM-SHA-1 and SCRAM-SHA-256.

   • ソースクラスターが TLS を使用している場合は、Is encryption in transit enabled? ボタンを切り替えます。

   • ソースクラスターがカスタム ルート認証局 (CA) でTLSを使用する場合は、移行ホストからCA ファイルへのパスをコピーし、このパスを指定されたテキストボックスに貼り付けます。ファイルは移行ホストに配置されている必要があります。移行ホストが証明書を読み取れるようにするためです。Atlas は、証明書が存在しており、読み取り可能であることを確認します。

   • 宛先クラスターに保持したいデータがある場合は、 Clear any existing data on your destination clusterオプションはオフのままにします。 ライブ移行サービスは検証中にドキュメントのサンプルをチェックし、重複する名前空間が見つかった場合は警告を発します。 既存のデータを削除する場合は、このオプションをオンにして、宛先クラスターの名前を入力します。

   • クラスターに接続するための接続を選択します。 Standard connectionは UI に常に使用可能なものとして表示されます。 ただし、他の接続オプションは、以前にクラスターの VPC ピアリング接続またはプライベートエンドポイントを設定した場合にのみ有効になります。 Atlas が VPC 接続またはプライベートエンドポイントが設定されていないことを検出した場合、これらのオプションはグレー表示されます。

     • VPC ピアリングまたはプライベートエンドポイントを使用していない場合は、 Standard connectionをクリックして、このステップのValidationステージに進みます。

     • If you configured a VPC peering connection between the migration host and the Atlas replica set, the VPC Peering option is active. Click VPC Peering to connect using VPC peering for live migration. If the VPC Peering option is grayed out, configure a VPC peering connection before starting this procedure. To learn more, see Support for VPC Peering and Private Endpoints.

     • If you configured a private endpoint between the migration host and the Atlas cluster, the Private Endpoint option is active. Click Private Endpoint to connect with a private endpoint, and then select a previously-configured private endpoint from the dropdown. Only private endpoints that are in AVAILABLE state are valid. If the Private Endpoint option is grayed out, configure a private endpoint before starting this procedure. To learn more, see Support for VPC Peering and Private Endpoints.

       注意

       プッシュ ライブ移行の場合、プライベートエンドポイントは 1 つのクラウドプロバイダーと 1 つのリージョン内に配置されたクラスターでのみサポートされます。

   • [ Validateをクリックします。 検証プロセスでは、移行ホストがアクセス可能であることを確認し、次の検証チェックを実行して、Atlas へのライブ移行を開始できることを確認します。

     次の検証チェックを利用するには、Cloud Manager の MongoDB Agent を最新バージョンにアップグレードします。 ライブ移行中に次の検証チェックが実行されます。

     • 移行ホストは宛先クラスターに接続できます。

     • ソースクラスターがカスタム ルート認証局（CA）でTLSを使用する場合、移行ホストはTLSを使用してソースクラスターにアクセスできます。

     • データベースユーザーの認証情報が有効です。 この検証チェックは、Cloud Manager でソースクラスターのオートメーションを一時停止しているが、モニタリングエージェントでソースクラスターを引き続き監視している場合にのみ実行されます。

     • 移行プロセスでは、圧縮データのストレージ サイズに基づいて、宛先クラスターに十分なディスク領域があることを検証します。 データとストレージ サイズの詳細については、 dbStats を参照してください。

   • 検証に失敗した場合は、移行ホスト、外部IPアドレスまたは CIDR ブロックの有効性、およびリンク トークン を確認します。また、データベースユーザーの認証情報、TLS 証明書、宛先クラスターのディスクストレージサイズの量も確認します。

   • 検証に成功した場合は、[ Next ] をクリックします。

移行を開始します。

1. ライブ移行プロセスで使用される移行ホスト、プロジェクト、クラスター、移行ホストが記載されているレポートを確認します。

2. [Start the Migration] をクリックします。

   移行プロセスが開始されると、Atlas UI に、宛先 Atlas クラスターの Migrating Data ウォークスルー画面が表示されます。 ウォークスルー画面は、宛先クラスターの移行プロセスが進行すると更新されます。移行プロセスには、次のものが含まれます。

   • ソースクラスター データへの新しい書込みを宛先クラスター データに適用します。

   • ソースクラスターから宛先クラスターへのデータのコピー。

   • 宛先クラスターで移行を終了します。

   移行プロセスの最終フェーズでは、ソースクラスターと宛先クラスター間の現在のラグを表すラグ タイム値が表示されます。

   ラグタイマーが 0 に近く、移行プロセスが追いつくと、Atlas はCutover to your destination clusterボタンをアクティブ化し、ソースクラスターと宛先クラスターが同期していることを示します。 次の手順に進みます。

カットオーバーを実行します。

カットオーバーは、アプリケーションの読み取りと書込みをソースクラスターから宛先クラスターに指示する 3 ステップのプロセスです。

Atlas は、ソースクラスターと宛先クラスターがほぼ同期していることを検出すると、延長可能な120時間（ 5日）のタイマーを開始してライブ移行手順のカットオーバーのステージを開始します。 120時間が経過すると、Atlas はソースクラスターとの同期を停止します。

移行プロセスのこのステージでは、カットオーバーに進むか、同期期間を延長してから、カットオーバーに進むことができます。

• I'm ready to cutoverをクリックすると、Atlas はカットオーバー プロセスを開始します。

• Extend Syncをクリックし、拡張同期が正常に完了すると、Atlas はソースクラスターと宛先クラスターが同期していることを確認します。 カットオーバー プロセスに進みます。 同期時間が経過した場合は、移行を再試行できます。

  移行の有効期限が迫っている場合、Atlas は次の例のようなメールを送信します。

  A migration to your Atlas cluster will expire in <number> hours!
  Navigate to your destination cluster to start the cutover process. If
  you don't take any action within <number> hours, the migration will be
  cancelled and you will need to start again. You can also extend the
  migration process if you need more time.

1. [ I'm ready to cutoverをクリックします。 アプリケーションのダウンタイムを最小限に抑えるために、3 ステップのカットオーバー プロセスを迅速に処理します。

2. [ Proceed to cutoverをクリックします。 3 ステップのカットオーバー プロセスが開始されます。

   1. ソースクラスターへの書き込みを停止します。 [ I confirm that I've stopped writes to my source clusterをクリックします。 続行するにはFinalize migrationをクリックします。

   2. Atlas が移行を完了するまで、数分待ちます。 Atlas は、プロセスを完了するために次のアクションを実行します。

      • MongoDB ライブ移行サーバーのサブネットを宛先クラスターの IP アクセスリストから削除する。

      • ライブ移行で宛先クラスターへのデータのインポートに使用したデータベースユーザーを削除します。

      カットオーバー プロセスが少なくとも12時間進行している場合、Atlas は移行プロセスを確認するか、サポートに連絡することを提案するメールを送信します。

   3. 移行が成功すると、 You have successfully migrated to Atlasページが表示されます。 Atlas には、同期された変更のステータス、アプリケーションのダウンタイム、移行プロセスの期間、コピーされた初期データの量、コピーされたコレクションの数が表示されます。

      • ドキュメント数を比較し、ハッシュを実行中、データが宛先クラスターに転送されていることを確認します。詳しくは、Mongosync: データ転送の検証を参照してください。

      • [ Connect to your new clusterをクリックします。 Atlas は接続方法を選択できるConnect to Atlasページにリダイレクトします。

      • クラスターに接続したら、宛先クラスターへの書込みを再開します。