Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Docs Menu
Docs Home
/

Implemente un clúster particionado autogestionado

Este tutorial consiste en crear un nuevo clúster compartimentado que conste de un mongos, el set de réplicas del servidor de configuración y dos sets de réplicas de particiones.

Cada nodo de un clúster compartido debe poder conectarse a todos los demás nodos del clúster. Esto incluye todas las particiones y servidores de configuración. Asegúrate de que los sistemas de red y seguridad, incluidas todas las interfaces y firewalls, permitan estas conexiones.

Importante

Para evitar actualizaciones de configuración debido a cambios en las direcciones IP, utilice nombres de host DNS en lugar de direcciones IP. Es particularmente importante usar un nombre de host DNS en lugar de una dirección IP al configurar miembros de set de réplicas o miembros de clústeres particionados.

Utiliza nombres de host en lugar de direcciones IP para configurar clústeres en un horizonte de red dividido. A partir de MongoDB 5.0, los nodos que solo están configurados con una dirección IP no pasan la validación de inicio y no se inician.

Si utilizas localhost o su dirección IP como la parte del nombre de host de cualquier identificador de host, debes utilizar ese identificador como la configuración de host para cualquier otro componente de MongoDB en el clúster.

Por ejemplo, el método sh.addShard() requiere un parámetro host para el hostname de la partición de destino. Si configuras host en localhost, entonces debes usar localhost como el host para todas las demás particiones en el clúster.

Este tutorial no incluye los pasos requeridos para configurar Autenticación interna/de miembros autogestionada o Control de acceso basado en roles en implementaciones autogestionadas.

En los entornos de producción, los clústeres fragmentados deben emplear al menos seguridad x.509 para la autenticación interna y el acceso de clientes.

A partir de MongoDB 8.0, se puede utilizar el rol directShardOperations para realizar operaciones de mantenimiento que requieren ejecutar comandos directamente contra un fragmento.

Advertencia

Ejecutar comandos usando el rol directShardOperations puede hacer que su clúster deje de funcionar correctamente y puede causar corrupción de datos. Utiliza el rol directShardOperations únicamente con fines de mantenimiento o bajo la orientación del soporte de MongoDB. Deja de usar el rol directShardOperations cuando termines de realizar operaciones de mantenimiento.

Los siguientes pasos implementan un conjunto de réplicas de servidor de configuración.

Para una implementación en producción, implemente un set de réplicas de servidores de configuración con al menos tres nodos. Para fines de prueba, puedes crear un set de réplicas de un solo nodo.

Nota

El set de réplicas del servidor de configuración no debe usar el mismo nombre que ninguno de los set de réplicas de las particiones.

Para este tutorial, los miembros del set de réplicas del servidor de configuración están asociados con los siguientes hosts:

Miembro del servidor de configuración set de réplicas
Nombre del host

Miembro 0

cfg1.example.net

Miembro 1

cfg2.example.net

Miembro 2

cfg3.example.net

1

Al iniciar cada mongod, especifica la configuración de mongod ya sea mediante un archivo de configuración o desde la línea de comandos.

Si utiliza un archivo de configuración, configure:

sharding:
clusterRole: configsvr
replication:
replSetName: <replica set name>
net:
bindIp: localhost,<hostname(s)|ip address(es)>

Inicie el mongod con la opción --config configurada en la ruta del archivo de configuración.

mongod --config <path-to-config-file>

Si utiliza las opciones de línea de comandos, inicie el mongod con las opciones --configsvr, --replSet, --bind_ip y otras opciones según corresponda a su implementación. Por ejemplo:

Advertencia

Antes de vincular la instancia a una dirección IP de acceso público, se debe asegurar el clúster contra accesos no autorizados. Para obtener una lista completa de recomendaciones de seguridad, se debe consultar Checklist de seguridad para implementaciones autogestionadas. Como mínimo, se debe considerar habilitar la autenticación y reforzar la infraestructura de red.

mongod --configsvr --replSet <replica set name> --dbpath <path> --bind_ip localhost,<hostname(s)|ip address(es)>

Para obtener más información sobre los parámetros de inicio, consulte la página de referencia mongod.

2

Conectar mongosh a uno de los nodos del servidor de configuración.

mongosh --host <hostname> --port <port>
3

Desde mongosh, ejecuta el método rs.initiate().

rs.initiate() puede tomar un documento de configuración de Set de réplicas opcional. En el documento de configuración del Set de réplicas, incluya:

  • El _id se establece en el nombre del set de réplicas especificado tanto en el replication.replSetName como en la opción --replSet.

  • El configsvr campo está establecido en true para el set de réplicas del servidor de configuración.

  • El members arreglo con un documento por cada nodo del set de réplicas.

Importante

Se debe ejecutar rs.initiate() en una sola instancia mongod para el set de réplicas.

rs.initiate(
{
_id: "myReplSet",
configsvr: true,
members: [
{ _id : 0, host : "cfg1.example.net:27019" },
{ _id : 1, host : "cfg2.example.net:27019" },
{ _id : 2, host : "cfg3.example.net:27019" }
]
}
)

Consulta Configuración de set de réplicas autogestionada para obtener más información sobre los documentos de configuración del set de réplicas.

Una vez iniciado y en funcionamiento el set de réplicas del servidor de configuración (CSRS), procede a crear los sets de réplicas de las particiones.

Para una implementación en producción, usa un set de réplicas con al menos tres nodos. Para fines de prueba, puedes crear un set de réplicas de un solo nodo.

Nota

Los sets de réplicas de particiones no deben usar el mismo nombre que el set de réplicas del servidor de configuración.

Para cada partición, utiliza los siguientes pasos para crear el set de réplicas de la partición:

1

Al iniciar cada mongod, especifica la configuración de mongod ya sea mediante un archivo de configuración o desde la línea de comandos.

Si utiliza un archivo de configuración, configure:

sharding:
clusterRole: shardsvr
replication:
replSetName: <replSetName>
net:
bindIp: localhost,<ip address>

Inicie el mongod con la opción --config configurada en la ruta del archivo de configuración.

mongod --config <path-to-config-file>

Si utilizas la opción de línea de comandos, inicia el mongod con las opciones --replSet, --shardsvr, --bind_ip y otras opciones que correspondan a tu implementación. Por ejemplo:

mongod --shardsvr --replSet <replSetname> --dbpath <path> --bind_ip localhost,<hostname(s)|ip address(es)>

Para obtener más información sobre los parámetros de inicio, consulte la página de referencia mongod.

2

Conectar mongosh a uno del set de réplicas.

mongosh --host <hostname> --port <port>
3

Desde mongosh, ejecuta el método rs.initiate().

rs.initiate() puede tomar un documento de configuración de Set de réplicas opcional. En el documento de configuración del Set de réplicas, incluya:

  • El campo _id se establece en el nombre del Set de réplicas especificado en el replication.replSetName o en la opción --replSet.

  • El members arreglo con un documento por cada nodo del set de réplicas.

El siguiente ejemplo inicia un set de réplicas de tres nodos.

Importante

Se debe ejecutar rs.initiate() en una sola instancia mongod para el set de réplicas.

rs.initiate(
{
_id : "myReplSet",
members: [
{ _id : 0, host : "s1-mongo1.example.net:27018" },
{ _id : 1, host : "s1-mongo2.example.net:27018" },
{ _id : 2, host : "s1-mongo3.example.net:27018" }
]
}
)

Inicia un mongos usando un archivo de configuración o un parámetro de línea de comando para especificar los servidores de configuración.

Si usas un archivo de configuración, debes asignar el sharding.configDB al nombre del conjunto de réplicas del servidor de configuración y asegurar que al menos un nodo del conjunto de réplicas esté en el formato <replSetName>/<host:port>.

Advertencia

Antes de vincular la instancia a una dirección IP de acceso público, se debe asegurar el clúster contra accesos no autorizados. Para obtener una lista completa de recomendaciones de seguridad, se debe consultar Checklist de seguridad para implementaciones autogestionadas. Como mínimo, se debe considerar habilitar la autenticación y reforzar la infraestructura de red.

sharding:
configDB: <configReplSetName>/cfg1.example.net:27019,cfg2.example.net:27019
net:
bindIp: localhost,<hostname(s)|ip address(es)>

Inicie el mongos especificando la opción --config y la ruta al archivo de configuración.

mongos --config <path-to-config>

Para obtener más información sobre el archivo de configuración, consultar opciones del archivo de configuración.

Si se utilizan parámetros de línea de comandos, inicia el mongos y especifica el --configdb, --bind_ip, y otras opciones según corresponda a tu implementación. Por ejemplo:

Advertencia

Antes de vincular la instancia a una dirección IP de acceso público, se debe asegurar el clúster contra accesos no autorizados. Para obtener una lista completa de recomendaciones de seguridad, se debe consultar Checklist de seguridad para implementaciones autogestionadas. Como mínimo, se debe considerar habilitar la autenticación y reforzar la infraestructura de red.

mongos --configdb <configReplSetName>/cfg1.example.net:27019,cfg2.example.net:27019,cfg3.example.net:27019 --bind_ip localhost,<hostname(s)|ip address(es)>

Incluye cualquier otra opción que sea apropiada para tu implementación.

En este punto, tu clúster particionado consiste en el mongos y los servidores de configuración. Ahora puedes conectarte al clúster shard usando mongosh.

Conecta mongosh a la mongos. Especifica el host y el port en los que se ejecuta el mongos:

mongosh --host <hostname> --port <port>

Una vez que haya conectado mongosh al mongos, continúe con el siguiente procedimiento para agregar particiones al clúster.

En una mongosh sesión conectada al mongos, usar el método sh.addShard() para añadir cada partición al clúster.

La siguiente operación agrega un set de réplicas de particiones individuales al clúster:

sh.addShard( "<replSetName>/s1-mongo1.example.net:27018,s1-mongo2.example.net:27018,s1-mongo3.example.net:27018")

Repita estos pasos hasta que el clúster incluya todas las particiones deseadas.

Para fragmentar una colección, conecta mongosh al mongos y utiliza el método sh.shardCollection().

Nota

Particionado e índices

Si la colección ya contiene datos, debes crear un índice que admita la clave de partición antes de particionar la colección. Si la colección está vacía, MongoDB crea el índice como parte de sh.shardCollection().

MongoDB proporciona dos estrategias para particionar las colecciones:

  • Particionado encriptada utiliza un índice encriptada de un solo campo como la clave de partición para particionar los datos a través de su clúster.

    sh.shardCollection("<database>.<collection>", { <shard key field> : "hashed" } )
  • El particionamiento basado en rangos puede utilizar múltiples campos como clave de partición y dividir los datos en rangos contiguos determinados por los valores de la clave de partición.

    sh.shardCollection("<database>.<collection>", { <shard key field> : 1, ... } )

Tu elección de clave de partición afecta la eficiencia del particionado, así como tu capacidad para aprovechar ciertas funcionalidades de particionado, como las zonas. Para aprender cómo elegir una clave de partición eficaz, consulta Elegir una clave de partición.

mongosh proporciona el método convertShardKeyToHashed(). Este método utiliza la misma función encriptada que el índice encriptada y puede utilizarse para ver cuál sería el valor encriptada para una clave.

Tip

Volver

Aislamiento de cargas de trabajo

En esta página