Instalar o desinstalar mongot en un contenedor de Docker

Extraiga la mongot imagen de Docker.

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.

Crea un archivo de contraseña de usuario de sincronización mongot.

Crea un archivo de contraseñas para que mongot se conecte a mongod. Seleccione su sistema operativo y ejecute el 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"

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.

• En Windows, reemplace la barra invertida (\) al final de cada línea con el carácter de continuación de línea para su shell. El símbolo del sistema utiliza un acento circunflejo (^) y PowerShell utiliza un 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

En un nuevo shell, comienza mongosh.

Ejecute el siguiente comando para conectarse a la instancia mongod que inició en el puerto 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.

Para iniciar el binario Search in Community (mongot), seleccione su sistema operativo y ejecute el 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 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.

Verifique el estado del proceso mongot.

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

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.