rs.add()

定義

rs.add(host, arbiterOnly)

レプリカセットにノードを追加します。メソッドを実行するには、レプリカセットのプライマリに接続する必要があります。

Parameter	タイプ	説明
host	文字列またはドキュメント	レプリカセットに追加する新しいノード。文字列または構成ドキュメントとして指定します。 ドキュメントの場合は、members 配列にあるレプリカセット ノード構成ドキュメントを指定します。ノード構成ドキュメントで host フィールドを指定する必要があります。 { _id: <int>, host: <string>, // required arbiterOnly: <boolean>, buildIndexes: <boolean>, hidden: <boolean>, priority: <number>, tags: <document>, secondaryDelaySecs: <int>, votes: <number> } 構成フィールドの説明については、members を参照してください。 文字列の場合は、新しいノードのホスト名と、オプションでポート番号を指定します。
arbiterOnly	ブール値	任意。<host> 値が文字列の場合にのみ適用されます。true の場合、追加されたホストはアービタです。

rs.add()は、 replSetReconfigデータベースコマンドと対応するmongoshヘルパーrs.reconfig()の一部の機能を呼び出すラッパーを提供します。 すべてのレプリカセット構成オプションを網羅したドキュメントについては、自己管理型レプリカセット構成のドキュメントを参照してください。

IP バインディング

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

デフォルトでは、localhost にバインドされている mongod と mongos は、同じコンピューター上で実行中のクライアントによる接続のみを受け入れます。このバインディング動作には、mongosh や、レプリカセットやシャーディングされたクラスターのノードなどが含まれます。リモート クライアントは、ローカルホストのみにバインドされているバイナリには接続できません。

デフォルトのバインドをオーバーライドして、他の 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

動作

rs.add()は、場合によってはプライマリの選挙をtriggerして、 shellを切断することができます（現在のプライマリよりも優先順位の高い新しいノードを追加するなど）。 このような場合、操作が成功しても、 mongoshにエラーが表示されることがあります。

例

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

rs.add( { host: "mongodbd4.example.net:27017", priority: 0 } )