自己管理型レプリカセットへのノードの追加

最大投票ノード数

レプリカセットには最大 7 つの投票ノードを含めることができます。すでに 7 つの投票ノードがあるレプリカセットにノードを追加するには、非投票ノードとして追加するか、 existing member から投票権を削除する必要があります。

init スクリプト

本番配置では、ノードのプロセスを管理する init スクリプトを設定できます。

既存ノード

これらの手順を使用して、既存のレプリカセットに新しいノードを追加できます。

以前のノードを復元する

これらの手順を使用して、削除されたノードを再度追加することができます。

削除されたノード上のデータが比較的新しい場合、ノードは復元され、他のレプリカセットと同期されます。

データファイル

既存のメンバーのバックアップまたはスナップショットがある場合は、データファイル（例えば、 dbPathディレクトリ）を新しいシステムに移動し、それらを使用して新しいノードをすばやく開始できます。ファイルは次の条件を満たす必要があります。

• 同じレプリカセットのノードからのデータファイルの有効なコピー。詳細については、ファイルシステム スナップショットを使用した自己管理型配置のバックアップドキュメントを参照してください。

  重要

  Always use filesystem snapshots to create a copy of a member of the existing replica set. Do not use mongodump and mongorestore to seed a new replica set member.

• プライマリのoplog内の最も古い操作よりも新しい操作。新しいノードは、プライマリの oplog から操作を適用して、最新の状態になることができる必要があります。

IP バインディング

MongoDB バイナリ（mongod と mongos）は、デフォルトで localhost にバインドされます。バイナリに net.ipv6 構成ファイルや --ipv6 コマンド ライン オプションが設定されている場合、バイナリはローカルホストの IPv6 アドレスに追加でバインドされます。

By default mongod and mongos that are bound to localhost only accept connections from clients that are running on the same computer. This binding behavior includes mongosh and other members of your replica set or sharded cluster. Remote clients cannot connect to binaries that are bound only to localhost.

デフォルトのバインドをオーバーライドして、他の IP アドレスにバインドするには、net.bindIp 構成ファイル設定や --bind_ip コマンド ライン オプションを使用して、ホスト名または IP アドレスのリストを指定します。

たとえば、次の mongod インスタンスは、IP アドレス 198.51.100.1 に関連付けられているローカルホストとホスト名 My-Example-Associated-Hostname の両方にバインドします。

mongod --bind_ip localhost,My-Example-Associated-Hostname

このインスタンスに接続するには、リモート クライアントはホスト名またはそれに関連付けられた IP アドレス198.51.100.1を指定する必要があります。

mongosh --host My-Example-Associated-Hostname
mongosh --host 198.51.100.1

データディレクトリの準備

既存のレプリカセットに新しいノードを追加する前に、次のいずれかの戦略を使用して新しいノードのデータディレクトリを準備します。

• 新しいノードのデータディレクトリに、データが含まれていないことを確認します。新しいノードは、既存のノードからデータをコピーします。

  新しいノードがリカバリ状態にある場合、MongoDB がレプリケーション プロセスの一環としてすべてのデータをコピーする前に、そのノードは終了してセカンダリになる必要があります。このプロセスには時間がかかりますが、管理者の介入は必要ありません。

• 既存のノードからデータディレクトリを手動でコピーします。新しいノードはセカンダリ メンバーになり、レプリカセットの現在の状態に追いつきます。データをコピーすると、新しいノードが最新になるまでの時間が短縮される可能性があります。

  データディレクトリを新しいノードにコピーし、 oplog によって許可されたウィンドウ 期間内にレプリケーションを開始できることを確認します。 それ以外の場合、新しいインスタンスで最初の同期を実行する必要があり、「 自己管理型レプリカセットのノードの再同期 」で説明されているように、データの完全な再同期が必要になります。

  rs.printReplicationInfo()を使用して、oplog に関するレプリカセット ノードの現在の状態を確認します。

レプリケーション配置パターンの背景については、「レプリカセット配置のアーキテクチャ」ドキュメントを参照してください。

既存のレプリカセットへのノードの追加

1. 新しいmongodインスタンスを起動します。データディレクトリとレプリカセット名を指定します。次の例えでは、 /srv/mongodb/db0データディレクトリとrs0レプリカセットを指定します。

   mongod --dbpath /srv/mongodb/db0 --replSet rs0  --bind_ip localhost,<hostname(s)|ip address(es)>

   警告

   インスタンスをパブリックにアクセス可能な IP アドレスにバインドする前に、クラスターを不正アクセスから保護する必要があります。 セキュリティ推奨事項の完全なリストについては、「自己管理型配置のセキュリティ チェックリスト」を参照してください。 最低限、認証を有効化し、ネットワーク インフラストラクチャの強化 を検討してください。

   設定オプションの詳細については、 mongodマニュアル ページを参照してください。

   注意

   任意

   mongod.conf構成ファイルでデータディレクトリ、レプリカセット名、および IP バインディングを指定し、次のコマンドでmongodを起動できます。

   mongod --config /etc/mongod.conf

2. レプリカセットのプライマリに接続します。

   ノードの追加は、プライマリーに接続している間のみ可能です。どのノードがプライマリであるかわからない場合は、レプリカセットの任意のノードにログインして、 db.hello()コマンドを発行します。

3. rs.add()を使用して、レプリカセットに新しいノードを追加します。member configuration documentメソッドに渡します。たとえば、ホストmongodb3.example.netにノードを追加するには、次のコマンドを発行します。

   rs.add( { host: "mongodb3.example.net:27017" } )

   警告

   MongoDB 5.0 より前では、新しく追加されたセカンダリは、データの一貫性が確保されるまでは読み取りを処理できず、プライマリにもなれませんが、投票メンバーとしてカウントされます。MongoDB バージョン 5.0 より前のバージョンを実行中で、 votesとpriorityの設定が0より大きいセカンダリを追加すると、投票ノードの過半数がオンラインであるにもかかわらずプライマリを選出できない状況が発生する可能性があります。このような状況を回避するには、最初にpriority :0とvotes :0を使用して新しいセカンダリを追加することを検討してください。次に、 rs.status()を実行して、ノードがSECONDARY状態に移行したことを確認します。最後に、 rs.reconfig()を使用して優先順位と投票をアップデートします。