自己管理型レプリカセット内のホスト名の変更

前提条件

次の手順では、local データベース内の system.replset コレクションを読み取ってアップデートします。

配置でアクセス制御を適用する場合、手順を実行するユーザーには、 system.replset コレクションに対する find および update 特権アクションが必要です。

必要な特権を提供するロールを作成するには、次に手順に従います。

1. userAdminAnyDatabaseロールを持つユーザーなど、ユーザーとロールを管理する特権を持つユーザーとしてログインします。 次の手順では、 「 自己管理型配置でアクセス制御を有効にする 」で作成されたmyUserAdminを使用します。

   mongosh --port 27017 -u myUserAdmin --authenticationDatabase 'admin' -p

2. local データベースの system.replset コレクションに必要な特権を提供するユーザー ロールを作成します。

   db.adminCommand( {
      createRole: "systemreplsetRole",
      privileges: [
         { resource: { db: "local", collection: "system.replset" }, actions: ["find","update"] }
      ],
      roles: []
   } );

3. 名前変更手順を実行するユーザーにロールを付与します。たとえば、次の例では、admin データベースにユーザー "userPerformingRename" が存在すると想定しています。

   use admin
   db.grantRolesToUser( "userPerformingRename", [ { role: "systemreplsetRole", db: "admin" } ] );

手順

1. レプリカセット内のすべてのノードを停止します。

2. --replSet ランタイム オプションを使用せずに、異なるポートで再起動します。メンテナンス中にポート番号を変更すると、メンテナンスの実行中にクライアントがこのホストに接続できなくなります。ノードの通常の --dbpath を使用します。この例では、/data/db1 です。次のようなコマンドを使用します。

   警告

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

   mongod --dbpath /data/db1/ --port 37017 --bind_ip localhost,<hostname(s)|ip address(es)>

   重要

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

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

3. レプリカセットの各ノードに対して、次の一連の操作を実行します。

   1. Connect mongosh to the mongod running on the new, temporary port. For example, for a member running on a temporary port of 37017, you would issue this command:

      mongosh --port 37017

      実行中にアクセス制御が有効な場合、適切な権限を持つユーザーとして接続します。前提条件を参照してください。

      mongosh --port 37017 -u userPerformingRename --authenticationDatabase=admin  -p

   2. レプリカセットの設定を手動で編集します。レプリカセットの構成は、local データベース内の system.replset コレクション内の唯一のドキュメントです。

      ホスト名を変更するには、レプリカセットの構成を編集して、レプリカセットのすべてのノードに新しいホスト名とポートを指定します。

      1. local データベースに切り替えます。

         use local

      2. 構成ドキュメントの JavaScript 変数を作成します。_id フィールドの値をレプリカセットに合わせて変更します。

         cfg = db.system.replset.findOne( { "_id": "rs0" } )

      3. レプリカセットの各ノードに新しいホスト名とポートを指定します。レプリカセットに合わせてホスト名とポートを変更します。

         cfg.members[0].host = "mongodb0.example.net:27017"
         cfg.members[1].host = "mongodb1.example.net:27017"
         cfg.members[2].host = "mongodb2.example.net:27017"

      4. system.replset コレクション内のホスト名とポートをアップデートします。

         db.system.replset.updateOne( { "_id": "rs0" }, { $set: cfg } )

      5. 変更を確認します。

         db.system.replset.find( {}, { "members.host": 1 } )

   3. ノード上の mongod プロセスを停止します。

4. セットのすべてのノードを再構成した後、通常の方法で各 mongod インスタンスを起動します。つまり、通常のポート番号を使用し、--replSet オプションを使用します。例:

   警告

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

   mongod --dbpath /data/db1/ --port 27017 --replSet rs0 --bind_ip localhost,<hostname(s)|ip address(es)>

5. Connect to one of the mongod instances using mongosh. For example:

   mongosh --port 27017

6. To confirm the new configuration, call rs.conf() in mongosh.

   出力は次のようになります。

   {
       "_id" : "rs0",
       "version" : 4,
       "members" : [
           {
               "_id" : 0,
               "host" : "mongodb0.example.net:27017"
           },
           {
               "_id" : 1,
               "host" : "mongodb1.example.net:27017"
           },
           {
               "_id" : 2,
               "host" : "mongodb2.example.net:27017"
           }
       ]
   }