El cuadro de diálogo Connect para un clúster proporciona los detalles para conectarse a un clúster a través del shell de MongoDB, mongosh.
Requisitos previos
mongosh
Debe tener mongosh instalado en su máquina para seguir este tutorial. Para obtener instrucciones, consulte Instalar mongosh.
TLS
Los clientes deben ser compatibles con TLS para conectarse a un clúster de Atlas.
Los clientes deben admitir la SNI extensión TLS para conectarse a un clúster de Atlas Free (anteriormente conocido como M0) o a un clúster Flex. MongoDB shell admite la extensión SNI TLS.
Lista de acceso IP
Para acceder a un clúster, debes conectarte desde una dirección IP que esté en la lista de acceso IP del proyecto de Atlas. Si necesitas añadir una dirección IP a la lista de acceso IP, puedes hacerlo en el cuadro de diálogo Connect. También puedes agregar la dirección IP desde la pestaña Acceso a la red.
Usuario de base de datos
Para acceder a un clúster, debe tener 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í.
Puede crear un usuario de base de datos para acceder a su clúster de Atlas en el cuadro de diálogo Connect. También puede añadir el usuario de base de datos desde la vista del clúster. Atlas crea un usuario de base de datos cuando crea su primer clúster.
Conéctate a tu clúster
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.
Haz clic Connecten.
Haz clic en Connect para el clúster al que deseas conectarte.
Elija la seguridad de su conexión.
Choose Connection Type del conjunto de botones disponibles.
Nota
Mostrar opciones si la característica está activada
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.
Utilice este tipo de conexión para las direcciones IP públicas autorizadas.
Utilizar este tipo de conexión si se ha habilitado el emparejamiento:
Para Google Cloud o Azure y se están conectando con {{connChoice}} desde una red de emparejamiento, o
Para AWS y se conectan con {{connChoice}} desde una red de emparejamiento que utiliza un servicio DNS personalizado.
Si ninguno de estos se aplica, agregue su dirección IP a su lista de acceso IP y utilice la cadena de conexión estándar. Si se conecta directamente a Atlas desde una oficina o una red doméstica, esta podría ser la opción de preferencia.
Nota
El emparejamiento debe estar disponible
No se puede seleccionar esta opción a menos que uno de los pares esté marcado como AVAILABLE. Para aprender cómo verificar el estado de los pares, consulta Ver conexiones peering de red de 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:
Utiliza la cadena de conexión para el punto final de interfaz adecuado si te conectas con {{connChoice}} mediante una conexión de Endpoint privado, ya sea porque {{connChoice}}:
Se ejecuta dentro de la red de su proveedor de nube, o
Tiene acceso transitivo a la red del proveedor de nube.
Debe usarse una cadena de conexión optimizada.
Si ninguno de estos se aplica, se debe agregar la dirección IP a la lista de acceso IP y usar la cadena de conexión estándar. Si se realiza la conexión directamente a Atlas desde una oficina o una red doméstica, esta podría ser la opción preferida.
Nota
No puede seleccionar esta opción a menos que su conexión PrivateLink configurada esté lista para usar. Para aprender cómo verificar el estado de su AWS PrivateLink, consulte Solucionar problemas de conexión de nodos privados.
Elija cómo desea limitar las conexiones a tu clúster.
Add a Connection IP Address
Importante
Omite este paso si Atlas indica en el paso Setup connection security que ya se ha configurado una entrada de la lista de acceso IP en el clúster. Para gestionar la lista de acceso IP, se debe consultar Agregar entradas a la lista de acceso.
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 de API, que restringe el acceso de la API a direcciones IP o CIDR específicas.
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 añadir una sola dirección IP o un rango de direcciones con notación CIDR.
Proporciona 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 Agregar entradas a 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 de API, que restringe el acceso de la API a direcciones IP o CIDR específicas.
Si la lista de acceso IP está vacía, Atlas solicita añadir una dirección IP a la lista de acceso IP del proyecto. Se debe hacer clic Add a Different IP Address para añadir una sola dirección IP o un rango de direcciones con notación CIDR.
Proporciona 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, necesitas un usuario de MongoDB con acceso a la base de datos o las bases de datos deseadas en el clúster de tu proyecto. Si tu proyecto no tiene usuarios de MongoDB, Atlas te invita a crear un usuario nuevo con el rol de Atlas Admin.
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.
Conectate a tu clúster de Atlas con mongosh.
Seleccione Shell.
Se debe seleccionar
mongoshen el menú desplegable. Recomendamos que se actualice a la versión más reciente del shell. Para comprobar la versión instalada demongosh, se debe ejecutar:mongosh --version El paso 2 del modal de Atlas muestra una cadena de conexión que se puede copiar e incluye el nombre del usuario de MongoDB que puede autenticarse con el clúster. Copia esta string. Para conectarse como un usuario diferente de MongoDB, cambia la opción --username.
Se debe pegar el comando
mongoshy la cadena de conexión en un terminal. Se debe ejecutar el comando. El shell pide la contraseña.
Solución de problemas
En caso de problemas para conectarse al clúster, consultar Solucionar problemas de conexión.