移行用のリソースを構成する

このページでは、移行の準備として移行用のリソースを構成する移行プロセスについて説明します。

このステージでは、次の操作を行います。

  1. 移行プロセスの後半でコマンドを実行するために必要なコマンドライン ツールをインストールします。
  2. MongoDB 互換の Firestore データベースを構成します。
  3. (省略可)MongoDB 互換のソースでオペレーション ログ(oplog)の設定を調整します。
  4. 中間データ ストレージ用の Cloud Storage バケットを作成します。

IAM 権限を構成する

アカウントには、移行プロセスで使用されるすべてのサービスで適切な IAM ロールが必要です。

コマンドライン ツールをインストールする

移行手順では、gcloud CLI を使用して移行手順を構成し、実行します。必要に応じて、gcloud CLI をインストールするの手順に沿って gcloud CLI をインストールします。

ソース固有の構成

Compute Engine 上の MongoDB

セルフマネージド クラスタの Compute Engine VM で実行される MongoDB データベースは、通常、公共のインターネットに公開されません。移行手順では、Datastream の Private Service Connect を使用して、Datastream パイプラインをソース データベースに接続します。

手順は次のとおりです。

  1. プライベート接続構成の作成に記載されている手順に沿って、Datastream プライベート接続を構成します。

  2. 作成した構成の Configuration ID パラメータをメモします。これは、後のステージで必要な環境変数を設定するために使用します。

Azure Cosmos DB

Azure CLI がパソコンにインストールされていることを確認します。

Amazon DocumentDB

Amazon DocumentDB クラスタには、Amazon VPC ネットワークの外部から直接アクセスできません。DocumentDB クラスタに接続するには、Amazon VPC ネットワーク内に EC2 インスタンスをプロビジョニングし、そのインスタンスを SSH トンネルの踏み台ホストとして使用する必要があります。

DocumentDB への外部接続用に EC2 インスタンスを設定する手順については、Amazon VPC の外部から Amazon DocumentDB クラスタに接続するデベロッパー ガイドをご覧ください。

DocumentDB クラスタへの接続を確立するには、EC2 インスタンスの秘密 SSH 鍵と、クラスタがデプロイされているリージョンの適切な証明書バンドルを取得する必要があります。AWS リージョン別の証明書バンドルのリソースページにアクセスして、適切なバンドルを PEM 形式でダウンロードします。

証明書バンドルには複数の証明書が含まれています。Datastream 接続を設定するには、単一の証明書を抽出する必要があります。有効な SSH 認証鍵とリージョン バンドルからの有効な DocumentDB 証明書の両方があることを確認するために、DocumentDB 接続を手動で検証することをおすすめします。DocumentDB のデベロッパー ガイドには、VPC の外部から直接接続を確立するためのコマンドラインの例が記載されています。

移行先の MongoDB 互換の Firestore データベースを構成する

  1. プロジェクトに、ソースの Mongo データベースからデータを移行する MongoDB 互換の Firestore データベースがあることを確認します。データベースの作成の詳細については、データベースの作成と管理をご覧ください。

  2. この移行では、SCRAM-SHA-256 認証プロトコルで使用する MongoDB 互換の Firestore データベースのユーザー名とパスワードを作成することをおすすめします。このユーザー名は、移行が完了したら安全に削除できます。また、これらの認証情報を使用して Mongo クライアントを新しい Firestore with MongoDB compatibility データベースに接続することもできます。

この Firestore with MongoDB compatibility データベースの名前とユーザー認証情報は、後の手順で使用します。

ソース データベースの oplog ウィンドウ サイズを調整する

ソースの Mongo データベースの oplog ウィンドウを、このデータベースへの書き込みトラフィックの合計 3 日分に調整することをおすすめします。書き込みトラフィックのレートが、Datastream がデータベースから変更を消費できるレートを超えている場合、この調整によりデータ損失を防ぐことができます。

トラフィックのパターンとピーク トラフィックの量に応じて、値をさらに調整する必要がある場合があります。たとえば、1 週間分のトラフィックが短期間で書き込まれると、変更が oplog ウィンドウから外れる前に、Datastream が oplog からの変更を十分に速くキャプチャできないことがあります。この場合、oplog ウィンドウのサイズを 7 日間の合計書き込みトラフィックに調整する必要がある場合があります。

Cloud Storage バケットを作成する

次の方法で新しい Cloud Storage バケットを作成します。

  1. 移行パイプラインを実行する Cloud Storage リージョンを選択します。移行先の MongoDB 互換の Firestore データベースがあるリージョンを使用することをおすすめします。

  2. このバケットの名前を選択します。例: mongo-migration-bucket。この名前は後の手順で使用します。

  3. Cloud Storage ドキュメントの バケットの作成ページの手順に沿って、選択した名前とリージョンで新しい Cloud Storage バケットを作成します。

次のステップ

環境変数を構成するに進みます。