Install or Uninstall mongot 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

Baixe a imagem do MongoDB Docker.

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. Selecione seu sistema operacional e execute o comando:

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"

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:

• Substitua </path/to/data/db> pelo caminho para o diretório local do volume montado.

• Substitua </path/to/mongod.conf> pelo caminho para o arquivo de configuração que você criou acima.

• No Windows, substitua a barra invertida (\) no final de cada linha pelo caractere de continuação de linha do seu shell. O prompt de comando usa um acento circunflexo (^) e o PowerShell usa um acento grave.

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:

docker exec -it mongod mongosh --port 27017

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

mongot deve ser capaz de se conectar à sua implantação do MongoDB por meio de um usuário com a função searchCoordinator.

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

use admin

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

• Substitua <mongot_username> por um nome de usuário para o seu usuário mongot.

• Substitua <mongot_password> pela senha que você especificou em seu passwordFile na etapa 4.

• Execute o seguinte comando:

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

Para obter mais informações sobre como criar usuários, consulte Criar um usuário em implantações autogerenciadas.

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.scramAuth.username. Você também deve especificar o passwordFile que criou na etapa anterior como syncSource.replicaSet.scramAuth.passwordFile.

Para mais informações sobre as opções de configuração do mongot, consulte Opções do mongot.

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 Search in Community (mongot), selecione seu sistema operacional e execute o comando:

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

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, se o processo mongot estiver em execução

  mongot pode não servir queries, pois não verifica o status dos índices, que devem estar no estado Ready para servir queries.

• NOT_SERVING, se o processo mongot não estiver em execução

Para obter mais informações, consulte Verifique sua conexão mongot.