Join us at MongoDB.local London on 7 May to unlock new possibilities for your data. Use WEB50 to save 50%.
Register now >
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 conjunto de réplicas del servidor de configuración y dos conjuntos de réplicas de fragmentos.

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 conjunto 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 conjunto_idal nombre del conjunto de réplicas especificado en la opciónreplication.replSetNameo --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 de producción, utilice un conjunto de réplicas con al menos tres miembros. Para realizar pruebas, puede crear un conjunto de réplicas con un solo miembro.

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 utiliza parámetros de línea de comandos, inicie mongos --configdby--bind_ip especifique, 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.

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 a, continúe con el siguiente procedimiento para agregar fragmentos al mongosh mongosclú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 único conjunto de réplicas de fragmentos 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 todos los fragmentos deseados.

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, debe crear un índice compatible con la clave de fragmentación antes de fragmentarla. Si la colección está vacía, MongoDB crea el índice como parte sh.shardCollection() de.

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, ... } )

La selección de la clave de fragmentación afecta la eficiencia de la fragmentación, así como su capacidad para aprovechar ciertas funciones, como las zonas. Para saber cómo elegir una clave de fragmentación eficaz, consulte Elegir una clave de fragmentació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