Instalar ou desinstalar o MongoDB Search no Community em um contêiner Docker

Extraia a imagem mongot do Docker.

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.

Crie um arquivo de senha de usuário de sincronização mongot.

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

Comece seu mongod.

Para iniciar o mongod:

• Substitua <your_admin_username> pelo nome de usuário que você deseja especificar para seu usuário administrador.

• Substitua <your_admin_password> pela senha que você deseja especificar para seu usuário administrador.

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

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

Em uma nova shell, inicie 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

Crie um usuário para o processo mongot em sua implantação do MongoDB.

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 <your-mongot-username> por um nome de usuário para o seu usuário mongot.

• 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" ]
   }
)

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.username. Você também deve especificar o passwordFile que criou na etapa anterior como syncSource.replicaSet.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 de pesquisa na comunidade, mongot:

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

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

Verifique a integridade do processo mongot.

Para verificar, envie uma solicitação usando um cliente HTTP ou curl para o ponto de extremidade /health. Por exemplo, envie uma solicitação curl semelhante à seguinte solicitação de amostra:

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.