Install or Uninstall mongot in a Docker Container

Pull the mongot Docker image.

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 をインストール を参照してください。

Create a mongot sync-user password file.

mongod に接続するための mongot 用のパスワードファイルを作成します。オペレーティング システムを選択し、コマンドを実行します。

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

Start your mongod.

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

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

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

• Windows では、各行の末尾のバックスラッシュ (\) を shell の行継続文字に置き換えます。Command Prompt はキャレット (^) を使用します。また、PowerShell はバックティックを使用します。

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

In a new shell, start mongosh.

ポート 27017 で起動した mongod インスタンスに接続するには、次のコマンドを実行します。

docker exec -it mongod mongosh --port 27017

Create a user for the mongot process on your MongoDB deployment.

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 プロセスを開始します。

Community での検索バイナリ（mongot）を開始するには、オペレーティングシステムを選択して、コマンドを実行します。

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ネットワーク上のコンテナを起動します。

Verify the health of the mongot process.

To verify, send a request by using a HTTP client or curl to the /health endpoint. For example, send a curl request similar to the following sample request:

curl localhost:8080/health

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

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

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

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

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