Docker コンテナ内の Community に MongoDB Search をインストールまたはアンインストールする

mongot Docker イメージをプルします。

mongot Dockerイメージをプルするには、次のコマンドを実行します。

docker pull mongodb/mongodb-community-search:latest

イメージがDockerディスク上にあることを確認するには、次のコマンドを実行します。

docker image ls mongodb/mongodb-community-search

Dockerネットワークを作成します。

データベースと検索コンテナ間のコンテナ間通信用の Docker ネットワークを作成するには、次のコマンドを実行します。

docker network create search-community

MongoDB Dockerイメージをダウンロードします。

MongoDB Dockerイメージをダウンロードするには、次のコマンドを実行します。

docker pull mongodb/mongodb-community-server:latest

Dockerを使用してMongoDBをインストールする方法の詳細については、 Dockerを使用してMongoDB Community をインストール を参照してください。

mongot 同期ユーザー パスワード ファイルを作成します。

Create a password file for mongot to connect to mongod. Select your operating system and run the command:

echo -n "<mongot_password>" > passwordFile
chmod 400 passwordFile

docker volume create mongot-secrets
docker run --rm -v mongot-secrets:/secrets busybox sh -c "echo -n '<mongot_password>' > /secrets/passwordFile && chmod 400 /secrets/passwordFile"

mongod構成ファイルを作成します。

構成ファイルを作成するには、次のコードを mongod.conf または希望する場所に保存します。

# MongoDB Configuration File
# Network configuration
   net:
      port: 27017
      bindIpAll: true  # Equivalent to --bind_ip_all
   # Replica set configuration
   replication:
      replSetName: rs0
   # Search configuration parameters
   setParameter:
      # Server parameters to advise mongod of mongot availability for search index management and querying
      searchIndexManagementHostAndPort: mongot-community.search-community:27028
      mongotHost: mongot-community.search-community:27028
      skipAuthenticationToSearchIndexManagementServer: false
      useGrpcForSearch: true
      searchTLSMode: disabled

mongod を起動します。

mongod を起動するには次の手順に従います。

• </path/to/data/db> をマウントされたボリュームのローカル ディレクトリへのパスに置き換えます。

• </path/to/mongod.conf> を、上記で作成した構成ファイルへのパスに置き換えます。

• On Windows, replace the backslash (\) at the end of each line with the line continuation character for your shell. Command Prompt uses a caret (^), and PowerShell uses a backtick.

docker run --rm \
   --name mongod \
   -v </path/to/mongod.conf>:/etc/mongod.conf:ro \
   -v </path/to/data/db>:/data/db \
   -p 27017:27017 \
   --network search-community \
   mongodb/mongodb-community-server:latest \
   --config /etc/mongod.conf \
   --replSetMember=mongod.search-community:27017

新しい shell で、mongosh を起動します。

Run the following command to connect to the mongod instance you started on port 27017:

docker exec -it mongod mongosh --port 27017

MongoDB配置で mongot プロセスのユーザーを作成します。

mongot searchCoordinator ロールを持つユーザーを介して MongoDB 配置に接続できる必要があります。

次のコマンドを実行して、adminデータベースに接続します。

use admin

searchCoordinator ロールを持つユーザーを作成するには:

• <mongot_username> を mongot ユーザーのユーザー名に置き換えます。

• <mongot_password> を、ステップ 4 の passwordFile で指定したパスワードに置き換えます。

• 次のコマンドを実行します:

db.createUser(
   {
      user: "<mongot_username>",
      pwd: "<mongot_password>",
      roles: [ "searchCoordinator" ]
   }
)

ユーザーの作成の詳細については、「自己管理型配置でユーザーを作成する」を参照してください。

検索構成オプションを指定します。

YAML構成ファイルを使用して mongot を構成できます。前の手順で指定したユーザー名をsyncSource.replicaSet.scramAuth.username として指定する必要があります。また、前の手順で作成した passwordFile を syncSource.replicaSet.scramAuth.passwordFile として指定する必要があります。

mongot 構成オプションの詳細については、mongot オプションを参照してください。

例では、以下に示すように 設定をローカル構成に合わせて調整できます。

# mongot.conf
syncSource:
   replicaSet:
      hostAndPort: "mongod.search-community:27017"
      scramAuth:
         username: "mongotUser"
         passwordFile: "/passwordFile"
         authSource: "admin"
         tls:
            enabled: false
   replicationReader:
      readPreference: "secondaryPreferred"
storage:
   dataPath: "/data/mongot"
server:
   grpc:
      address: "mongot-community.search-community:27028"
      tls:
         mode: "disabled"
metrics:
   enabled: true
   address: "mongot-community.search-community:9946"
healthCheck:
   address: "mongot-community.search-community:8080"
logging:
   verbosity: INFO

ファイルをmongot.config またはご希望のファイルロケーションに保存します。

どちらのコンテナも同じ search-community Dockerネットワークで動作します。

mongot プロセスを開始します。

To start the Search in Community binary (mongot), select your operating system and run the command:

docker run --rm \
   --name mongot-community \
   -v </path/to/data/mongot>:/data/mongot \
   -v </path/to/mongot.conf>:/mongot-community/config.default.yml \
   -v </path/to/passwordFile>:/passwordFile:ro \
   --network search-community \
   -p 8080:8080 \
   -p 9946:9946 \
   mongodb/mongodb-community-search:latest

docker run --rm ^
   --name mongot-community ^
   -v </path/to/data/mongot>:/data/mongot ^
   -v </path/to/mongot.conf>:/mongot-community/config.default.yml ^
   -v mongot-secrets:/secrets:ro ^
   --network search-community ^
   -p 8080:8080 ^
   -p 9946:9946 ^
   mongodb/mongodb-community-search:latest

このコマンド:

• ボリュームをマウントします。

• ローカル ボリュームから構成ファイルをマウントします。

• ポート範囲を指定します。

• メトリクス ポートを公開します。

• mongot-community という名前のコンテナを使用して search-community Dockerネットワーク上のコンテナを起動します。

mongot プロセスの正常性を確認します。

確認するには、HTTP クライアントまたは curl を使用して /health エンドポイントとなる接続されたデバイスにリクエストを送信します。例えば、次のサンプル リクエストと同様の curl リクエストを送信します。

curl localhost:8080/health

エンドポイントは、応答として次のいずれかを返します。

• SERVING, mongot プロセスが実行中の場合

  mongot インデックスのステータスをチェックしないため、クエリを処理できない可能性があります。クエリを処理するには、インデックスが Ready 状態である必要があります。

• NOT_SERVING, mongot プロセスが実行されていない場合

詳細については、「mongot 接続の確認」を参照してください。