El Connect El cuadro de diálogo para un clúster proporciona los detalles para conectarse a un clúster mediante Brújula.
Requisitos previos
TLS
Utiliza MongoDB Compass 1.5 o posterior para conectarte a los clústeres de Atlas. Estas versiones admiten la extensión SNI TLS requerida.
MongoDB Compass
Para completar este procedimiento, realiza una de las siguientes acciones:
Instala MongoDB Compass. Consulta Instalación de Compass.
Actualiza a la última versión de MongoDB Compass descargándola desde los enlaces en el cuadro de diálogo Atlas Connect. Para acceder a estos enlaces, se debe hacer clic en Connect para el clúster al que se desea conectar y luego hacer clic en Compass.
Lista de acceso IP
Para acceder a un clúster, debe conectarse desde una dirección IP de la lista de acceso IP del proyecto Atlas. Si necesita agregar una dirección IP a la lista de acceso IP, puede hacerlo en el cuadro de diálogo Connect. También puede agregar la dirección IP desde Pestaña Acceso a red.
Usuario de base de datos
Para acceder a un clúster, debe crearse un usuario de base de datos con acceso a las bases de datos deseadas en el clúster de Atlas. Los usuarios de base de datos son distintos de los usuarios de Atlas. Los usuarios de bases de datos tienen acceso a las bases de datos de MongoDB, mientras que los usuarios de Atlas tienen acceso a la aplicación Atlas en sí.
Es posible crear un usuario de base de datos para acceder al clúster de Atlas en el cuadro de diálogo Connect. También se puede añadir el usuario de base de datos desde la vista del clúster.
Conéctate a tu clúster
Se debe usar el siguiente procedimiento para conectar MongoDB Compass 1.8 o versiones posteriores al clúster de Atlas.
En Atlas, ve a la página Clusters de tu proyecto.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.
La página de clústeres se muestra.
Elege el tipo de conexión.
Atlas muestra las opciones de tipo de conexión después de habilitar IP privada para emparejamiento, nodos privados, o ambos. Si no has habilitado ninguna de las dos características, no se mostrarán botones y Connection Type se establecerá por defecto en Standard.
En Choose Connection Type, seleccione uno de los siguientes tipos de conexión:
Utiliza este tipo de conexión para las direcciones IP públicas autorizadas. Si la conexión es directamente a Atlas desde una oficina o una red doméstica, esta podría ser la opción preferida.
Utilizar este tipo de conexión si se ha habilitado el emparejamiento:
Para Google Cloud o Azure y se conecta con Compass desde una red emparejada
Para AWS y se conecta con Compass desde una red emparejada que utiliza un servicio DNS personalizado
Nota
El emparejamiento debe estar disponible
No puedes seleccionar esta opción a menos que uno de tus compañeros esté marcado como AVAILABLEPara saber cómo comprobar el estado de sus pares, consulte Ver conexiones de intercambio de redes Atlas.
Nota
Clústeres multicloud
Si la aplicación no está alojada en el mismo proveedor de servicios de nube que el primario del clúster, la aplicación solo puede realizar lecturas secundarias.
Con clústeres multi-nube, se debe considerar agregar la opción de conexión readPreference a la cadena de conexión. Se deben usar uno de los siguientes valores:
Se puede usar la cadena de conexión para el endpoint de la interfaz adecuado si se conecta con Compass a través de una conexión de endpoint privado porque:
MongoDB Compass se ejecuta dentro de la red del proveedor de nube
MongoDB Compass tiene acceso transitivo a la red del proveedor de nube
Debe usarse una cadena de conexión optimizada.
ADVERTENCIA: No se puede seleccionar esta opción a menos que la conexión PrivateLink configurada esté lista para usarse. Para aprender cómo verificar el estado de AWS PrivateLink, consulta Resolución de problemas de conexión de nodos privados.
Elija cómo desea limitar las conexiones a tu clúster.
Add a Connection IP Address
IMPORTANTE: Omita este paso si Atlas indica en el paso Setup connection security que ya ha configurado una entrada de la lista de acceso IP en su clúster. Para gestionar la lista de acceso IP, consulte Configurar entradas de la lista de acceso IP.
Atlas permite conexiones estándar de clientes al clúster desde las entradas en la lista de acceso IP del proyecto. La lista de acceso IP del proyecto difiere de la lista de acceso a la API, que restringe el acceso a la API a direcciones IP específicas o direcciones CIDR.
Si la lista de acceso IP está vacía, Atlas le solicita añadir una dirección IP a la lista de acceso IP del proyecto. Puede hacerse:
Se debe hacer clic en Add Your Current IP Address para permitir el acceso desde tu dirección IP actual.
Haz clic en Add an IP Address para agregar una sola dirección IP o un rango de direcciones con notación CIDR.
Ingresa una descripción opcional para la dirección IP recién agregada o el rango CIDR. Haz clic en Add IP Address para agregar la dirección a la lista de acceso IP.
Add a Connection IP Address
IMPORTANTE: Omita este paso si Atlas indica en el paso Setup connection security que ya ha configurado una entrada de la lista de acceso IP en su clúster. Para gestionar la lista de acceso IP, consulte Configurar entradas de la lista de acceso IP.
Atlas permite conexiones estándar de clientes al clúster desde las entradas de la lista de acceso IP del proyecto. La lista de acceso IP del proyecto difiere de la lista de acceso a la API, que restringe el acceso a la API a direcciones IP o CIDR específicas.
Si la lista de acceso IP está vacía, Atlas solicitará agregar una dirección IP a la lista de acceso IP del proyecto. Haz clic en Add a Different IP Address para agregar una sola dirección IP o un rango de direcciones con notación CIDR.
Ingresa una descripción opcional para la dirección IP recién agregada o el rango CIDR. Haz clic en Add IP Address para agregar la dirección a la lista de acceso IP.
En Choose Connection Type, selecciona Private Endpoint.
Si se ven las opciones Private Link Type, seleccionar una de las siguientes opciones:
Optimized SRV Connection para conexiones equilibradas.
Legacy SRV Connection para conexiones no balanceadas.
Para obtener más información, consulta ¿Cómo puedo optimizar el rendimiento de la conexión para clústeres particionados mediante nodos privados?.
En Choose Private Endpoint, selecciona el endpoint que desea usar.
Cree un usuario de base de datos.
IMPORTANTE: Omita este paso si Atlas indica en el paso Setup connection security que tiene al menos un usuario de base de datos configurado en su proyecto. Para gestionar los usuarios de base de datos existentes, consulte Configurar usuarios de base de datos.
Para acceder al clúster, necesita un usuario de MongoDB con acceso a la base de datos deseada en el clúster de su proyecto. Si su proyecto no tiene usuarios de MongoDB, Atlas le solicitará que cree un nuevo usuario con el rol de administrador de Atlas.
Introducir el Username del nuevo usuario.
Introduzca un Password para este nuevo usuario o haga clic en Autogenerate Secure Password.
Hacer clic en Create Database User para guardar al usuario.
Se debe usar este usuario para realizar la conexión al clúster en el siguiente paso.
Una vez que se haya añadido una dirección IP a la lista de acceso IP y un usuario de base de datos, se debe hacer clic en Choose Your Connection Method.
Obtenga la cadena de conexión para MongoDB Compass desde Atlas.
Haga clic en I have MongoDB Compass.
Elegir la versión de MongoDB Compass en el menú desplegable. Para verificar la versión de MongoDB Compass instalada en el sistema, hacer clic en About MongoDB Compass en la aplicación.
Copia la cadena de conexión que se presenta en el cuadro de diálogo de Atlas Connect.
Abra MongoDB Compass y conéctese a Atlas.
Utilizar la cadena de conexión copiada para conectarse a MongoDB Compass si la implementación utiliza un único proveedor de nube o no utiliza ninguno de los siguientes: SSL, certificados de autenticación o un túnel SSH.
Haga clic en New Connection y pegue la cadena de conexión en el campo Paste your connection string.
(Opcional) Para guardar esta conexión y usarla en el futuro, haz clic Create Favorite y añade un nombre para esta conexión. Puedes encontrar las conexiones favoritas guardadas en Favorites en el panel izquierdo de la ventana de MongoDB Compass Connect.
Haga clic en Connect.
Completa los campos de conexión individualmente si la implementación abarca más de un proveedor de nube o si se utiliza una de las siguientes opciones: SSL, certificados de autenticación o un túnel SSH.
Haga clic en Fill in Connection Fields Individually.
En la pestaña hostname, se debe introducir el nombre de host y el puerto, y elegir el mecanismo de autenticación en el menú desplegable.
En la pestaña More options, configure lo siguiente:
Si la implementación utiliza SSL o un túnel SSH, se deben especificar opciones de túnel SSL o SSH.
Si la implementación abarca más de un proveedor de nube, se deben especificar opciones de preferencia de lectura.
Si la implementación utiliza certificados X.509, se debe agregar un certificado X.509 autogestionado o un certificado X.509 autogenerado gestionado por Atlas.
Para obtener más información, consulta Conéctate a MongoDB en la documentación de MongoDB Compass.
(Opcional) Para guardar esta conexión y usarla en el futuro, haz clic Create Favorite y añade un nombre para esta conexión. Puedes encontrar las conexiones favoritas guardadas en Favorites en el panel izquierdo de la ventana de MongoDB Compass Connect.
Haga clic en Connect.
Para MongoDB Compass 1.7 o versiones anteriores, puedes crear manualmente una nueva conexión en Compass.
Para configurar un New Connection desde MongoDB Compass a su clúster de Atlas, introduzca la siguiente información en MongoDB Compass y haga clic en Connect:
Nombre de campo | Descripción |
|---|---|
Hostname | Nombre de host del primario para un set de réplicas o el nombre de host del Para localizar el nombre de host del set de réplicas primario en la interfaz de usuario de Atlas:
Para localizar el nombre de host de un clúster en la interfaz de usuario de Atlas:
Toma nota del número de puerto del primario o |
Port | Puerto del primario para un set de réplicas o el puerto de |
Authentication | Seleccione |
Username | Usuario de MongoDB. La cadena de conexión de Atlas muestra el usuario de administración de MongoDB configurado para el clúster. Puedes conectarse con un usuario diferente de MongoDB. |
Password | Contraseña asociada con el usuario de MongoDB especificado. |
Authentication Database | Especifique |
Replica Set Name | Nombre del set de réplicas del clúster de Atlas. Para recuperar el nombre del set de réplicas:
|
Read Preference | Especificar cómo MongoDB Compass dirige las operaciones de lectura. Las opciones son |
SSL | Seleccionar |
SSH Tunnel | Seleccionar |
Favorite Name | Introducir un nombre para la conexión si desea guardarla como favorita. |
Solución de problemas
En caso de problemas para conectarse al clúster, consultar Solucionar problemas de conexión.