rs.initiate()（mongoshメソッド）

説明

rs.initiate(configuration)

レプリカセットを開始します。オプションで、このメソッドはレプリカセットの構成を保持するドキュメントの形式で引数を取ることができます。

重要

mongosh メソッド

This page documents a mongosh method. This is not the documentation for database commands or language-specific drivers, such as Node.js.

データベースコマンドについては、replSetInitiate コマンドを参照してください。

MongoDB API ドライバーについては、各言語の「MongoDB ドライバーのドキュメント」を参照してください。

The rs.initiate() method has the following parameter:

Parameter	タイプ	説明
`configuration`	ドキュメント	任意。新しいレプリカセットの構成を指定するドキュメント。構成が指定されていない場合、MongoDB はデフォルトのレプリカセット構成を使用します。

互換性

このメソッドは、次の環境でホストされている配置で使用できます。

MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン
MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

IP バインディング

警告

インスタンスをパブリックにアクセス可能な 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 アドレスのリストを指定します。

警告

Starting in MongDB 5.0, split horizon DNS nodes that are only configured with an IP address fail startup validation and report an error. See disableSplitHorizonIPCheck.

たとえば、次の 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

レプリカセットの構成

レプリカセット構成ドキュメントの詳細については、「レプリカセット構成ドキュメントの例」を参照してください。

重要

IP アドレスの変更による構成の更新を防ぐには、IP アドレスの代わりに DNS ホスト名を使用します。レプリカセットノードまたはシャーディングされたクラスターノードを設定するときは、IP アドレスではなく DNS ホスト名を使用することが特に重要です。

分裂されたネットワークホライズン全体でクラスターを構成するには、IP アドレスの代わりにホスト名を使用します。 MongoDB 5.0以降、IP アドレスのみが設定されているノードは起動時の検証に失敗し、起動しません。

例

次の例では、3 つのノードがある新しいレプリカセットを開始します。

3 つの mongod インスタンスは、レプリカセットの他のノードとクライアントが接続できるように、--replSet コマンドラインオプション（または構成ファイルを使用している場合は replication.replSetName）を myReplSet に設定し、--bind_ip（または構成ファイルを使用している場合は net.bindIp）を適切に設定して起動する必要があります。

警告

Connect mongosh to one of the mongod instances and run rs.initiate().

注意

Run rs.initiate() on just one and only one mongod instance for the replica set.

重要

rs.initiate(
   {
      _id: "myReplSet",
      version: 1,
      members: [
         { _id: 0, host : "mongodb0.example.net:27017" },
         { _id: 1, host : "mongodb1.example.net:27017" },
         { _id: 2, host : "mongodb2.example.net:27017" }
      ]
   }
)

レプリカセット構成の詳細については、「レプリカセット構成フィールド」を参照してください。

レプリカセットの配置の詳細については、「自己管理型レプリカセットを配置する」を参照してください。

Tip

自己管理型ノード構成のチュートリアル

戻る

rs.help

rs.printReplicationInfo