Install or Uninstall MongoDB Search on Community in a Docker Container

Pull the mongot Docker image.

Para extrair a imagem do Docker do mongot, execute o seguinte comando:

docker pull mongodb/mongodb-community-search:latest

Para verificar se a imagem está no seu desktop do Docker, execute o seguinte comando:

docker image ls mongodb/mongodb-community-search

Crie uma rede Docker.

Para criar uma rede Docker para comunicação entre contêineres entre o banco de dados e os containers de pesquisa, execute o seguinte comando:

docker network create search-community

Download the MongoDB Docker image.

Para baixar a imagem do MongoDB Docker, execute o seguinte comando:

docker pull mongodb/mongodb-community-server:latest

Para obter detalhes adicionais sobre como instalar o MongoDB com Docker, consulte Instalar o MongoDB Community com Docker.

Create a mongot sync-user password file.

Crie um arquivo de senha para mongot se conectar a mongod.

Por exemplo, selecione seu sistema operacional e substitua <mongot_password> por sua senha. Em seguida, execute o seguinte comando para criar um arquivo chamado passwordFile:

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

Crie seu arquivo de configuração mongod.

Para criar seu arquivo de configuração, salve o seguinte código em mongod.conf ou no local de sua preferência.

# 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.

Para iniciar o mongod:

• Replace <your_admin_username> with the username you want to specify for your admin user.

• Replace <your_admin_password> with the password you want to specify for your admin user.

• Replace </path/to/data/db> with the path to the local directory for the mounted volume.

• Replace </path/to/mongod.conf> with the path to the configuration file you created above.

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.

Execute o seguinte comando para se conectar à instância mongod que você iniciou na porta 27017, substituindo <your_admin_username> e <your_admin_password> pelo nome de usuário e senha que você criou para o usuário administrador.

docker exec -it mongod mongosh --port 27017

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

mongot must be able to connect to your MongoDB deployment through a user with the searchCoordinator role.

Execute o seguinte comando para conectar ao banco de dados do admin :

use admin

Para criar um usuário com a função searchCoordinator:

• Replace <your-mongot-username> with a username for your mongot user.

• Substitua <your-mongot-password> pela senha que você especificou em seu passwordFile na etapa 5.

• Execute o seguinte comando:

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

For more information on creating users, see Create a User on Self-Managed Deployments.

Especifique suas opções de configuração de pesquisa.

Você pode configurar o mongot com um arquivo de configuração YAML. Você deve especificar o nome de usuário especificado na etapa anterior como syncSource.replicaSet.username. Você também deve especificar o passwordFile que criou na etapa anterior como syncSource.replicaSet.passwordFile.

For more information on mongot configuration options, see mongot Options.

Por exemplo, você pode adaptar as configurações à sua configuração local, conforme mostrado abaixo:

# 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

Salve seu arquivo em mongot.config ou no local de arquivo de sua preferência.

Ambos os containers são executados na mesma rede search-community Docker.

Inicie o processo de mongot.

Para iniciar o binário de pesquisa na comunidade, mongot:

• Replace </path/to/data/mongot> with the path to the local directory for the mounted volume to store mongot data.

• Substitua </path/to/mongot.conf> pelo caminho para o arquivo de configuração do mongot que você criou na etapa anterior.

• Substitua </path/to/passwordFile> pelo caminho para o arquivo de senha que você criou.

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

Este comando:

• Monta o volume.

• Monta um arquivo de configuração de um volume local.

• Especifica a faixa de portas.

• Expõe a porta de métricas.

• Inicia o contêiner na rede Docker do search-community com um contêiner denominado mongot-community.

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

O endpoint retorna uma das seguintes opções na resposta:

• SERVING, if the mongot process is running

  mongot might not serve queries as it doesn't check the status of the indexes, which must be in Ready state to serve queries.

• NOT_SERVING, if the mongot process isn't running

For more information, see Verify Your mongot Connection.