rs.initiate()

項目一覧

説明

互換性
IP バインディング
レプリカセットの構成
例

MongoDB5.0 は 10 月2024 をもってサポートを終了します。このバージョンのドキュメントはサポート対象外になりました。配置をアップグレードするには、 MongoDB を参照してください。5.0 60アップグレード手順。

説明

rs.initiate(configuration)

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

重要

mongosh メソッド

このページでは、mongosh メソッドについて記載しています。ただし、データベースコマンドや Node.js などの言語固有のドライバーのドキュメントには該当しません。

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

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

rs.initiate()メソッドには次のパラメーターがあります。

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

互換性

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

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

IP バインディング

警告

非ローカルホスト（例: （一般にアクセス可能な）IP アドレスを使用して、クラスターを不正アクセスから保護していることを確認します。セキュリティ推奨事項の完全なリストについては、「自己管理型配置のセキュリティチェックリスト」を参照してください。最低限、認証を有効化し、ネットワークインフラストラクチャの強化を検討してください。

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

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

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

警告

MongDB5.0 以降、スプリットホライズンDNS IP アドレスのみが設定されているノードは起動時の検証に失敗し、エラーを報告します。詳しくは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）を適切に設定して起動する必要があります。

警告

mongosh を mongod インスタンスの 1 つに接続し、rs.initiate() を実行します。

注意

rs.initiate() をレプリカセット用の mongod の 1 つのインスタンスのみで実行します。

重要

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