Instale o desinstale MongoDB Search en Community en un contenedor Docker

Extrae la imagen de Docker mongot.

Para obtener la imagen de Docker mongot, ejecuta el siguiente comando:

docker pull mongodb/mongodb-community-search:latest

Para verificar que la imagen está en su Docker Desktop, ejecute el siguiente comando:

docker image ls mongodb/mongodb-community-search

Crea una red de Docker.

Para crear una red de Docker para la comunicación entre contenedores de la base de datos y los contenedores de búsqueda, ejecute el siguiente comando:

docker network create search-community

Descargue la imagen de Docker de MongoDB.

Para descargar la imagen de Docker de MongoDB, ejecute el siguiente comando:

docker pull mongodb/mongodb-community-server:latest

Para obtener detalles adicionales sobre la instalación de MongoDB con Docker, consulte Instalar MongoDB Community con Docker.

Cree un archivo de contraseña de usuario de sincronizar 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"

Cree su archivo de configuración de mongod.

Para crear el archivo de configuración, se debe guardar el siguiente código en mongod.conf o en la ubicación de preferencia.

# 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

Inicie su mongod.

Para comenzar el mongod:

• Reemplace </path/to/data/db> con la ruta al directorio local para el volumen montado.

• Reemplace </path/to/mongod.conf> con la ruta al archivo de configuración que creó anteriormente.

• 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

En un nuevo shell, comience mongosh.

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

docker exec -it mongod mongosh --port 27017

Cree un usuario para el proceso mongot en su implementación de MongoDB.

mongot debe poder conectarse a la implementación de MongoDB a través de un usuario con el rol de searchCoordinator.

Ejecute el siguiente comando para conectarse a la base de datos admin:

use admin

Para crear un usuario con el rol searchCoordinator:

• Reemplace <mongot_username> por un nombre de usuario para su usuario mongot.

• Se debe reemplazar <mongot_password> con la contraseña que se especificó en el passwordFile en el paso 4.

• Ejecuta el siguiente comando:

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

Para obtener más información sobre la creación de usuarios, consulte Crear un usuario en implementaciones autogestionadas.

Especifique sus opciones de configuración de búsqueda.

Puedes configurar mongot con un archivo de configuración YAML. Debes especificar el nombre de usuario que especificaste en el paso anterior como el syncSource.replicaSet.scramAuth.username. También debes especificar el passwordFile que creaste en el paso anterior como el syncSource.replicaSet.scramAuth.passwordFile.

Para obtener más información sobre las opciones de configuración de mongot, consulte Opciones de mongot.

Por ejemplo, se puede adaptar la configuración al entorno local como se muestra a continuación:

# 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

Guarde su archivo en mongot.config o en la ubicación que prefiera.

Ambos contenedores se ejecutan en la misma red Docker search-community.

Inicie el proceso de 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

Este comando:

• Monta el volumen.

• Monta un archivo de configuración desde un volumen local.

• Especifica el rango de puertos.

• Expone el puerto de métricas.

• Inicia el contenedor en la red Docker search-community con un contenedor llamado mongot-community.

Verifica el estado del proceso mongot.

Para verificar, envíe una solicitud utilizando un cliente HTTP o curl al /health endpoint. Por ejemplo, envíe una solicitud curl similar a la siguiente solicitud de muestra:

curl localhost:8080/health

El endpoint devuelve uno de los siguientes en la respuesta:

• SERVING, si el proceso mongot se está ejecutando

  mongot es posible que no sirva queries, ya que no verifica el estado de los índices, que deben estar en estado Ready para servir queries.

• NOT_SERVING, si el proceso mongot no está en ejecución

Para obtener más información, consulta Verificar la conexión de mongot.