En esta guía, aprenderá a crear una implementación de MongoDB Atlas localmente o en la nube. Luego, aprenderá a crear una aplicación que se conecte a su implementación. Para saber cómo instalar las ediciones MongoDB Community o MongoDB Enterprise en su propia infraestructura, consulte Guía deinstalación de MongoDB.
Cree una implementación de MongoDB Atlas
Esta sección muestra cómo configurar una implementación local o en la nube de MongoDB Atlas y conectarse a la implementación mediante el MongoDB Shell.
Instale las dependencias
Antes de comenzar este tutorial, debe instalar las siguientes dependencias en su entorno de desarrollo:
Atlas CLI: Interfaz de línea de comandos que permite gestionar las implementaciones desde la terminal
MongoDB Shell: Herramienta interactiva que se conecta a una implementación y proporciona soporte para operaciones de bases de datos
Docker: plataforma que permite ejecutar software en contenedores, incluidas las implementaciones locales de MongoDB
Selecciona la pestaña correspondiente al sistema operativo para ver los comandos que instalan estas herramientas de desarrollo necesarias.
Ejecute los siguientes comandos para instalar las dependencias mediante el administrador de paquetes de Homebrew. Si no tiene Homebrew, puede instalarlo siguiendo las instrucciones del sitio web de Homebrew.
brew install mongodb-atlas brew install --cask docker
Ejecutar los siguientes comandos para instalar las dependencias usando el administrador de paquetes Chocolatey. Si Chocolatey no está instalado, se puede instalar siguiendo las instrucciones en el sitio web de Chocolatey.
choco install mongodb-atlas choco install docker-desktop
Para conocer otras formas de instalar Atlas CLI, consulta la página de instalación de Atlas CLI.
Nota
Docker Desktop
Los comandos anteriores instalan la aplicación Docker Desktop. Una vez que se complete la instalación, se debe crear una cuenta de Docker e iniciar la aplicación.
Configura una implementación con funciones completas
Ejecuta el siguiente comando y sigue las indicaciones en el shell para implementar un clúster. Si no existe una cuenta de Atlas, el siguiente comando solicitará que se cree una.
Este comando crea un set de réplicas de un solo nodo en un contenedor que se ejecuta en tu máquina local.
atlas deployments setup myDeployment --type local \ --mdbVersion 8.0 --port <port number> --connectWith skip
Nota
Reemplazar el <port number> Marcador de posición con el puerto que desea usar. El puerto predeterminado es 27017, pero puede especificar otro puerto si 27017 no está disponible.
El comando muestra la siguiente información:
Deployment created! Connection string: "<connection string URI>"
Guardar el URI de la cadena de conexión para usarlo en un paso futuro.
Este comando crea un clúster de nivel gratuito en MongoDB Atlas.
atlas deployments setup myDeployment --type atlas \ --provider AWS -r us-east-1 --skipSampleData \ --username <database username> --password <database user password> \ --connectWith skip --force
Nota
Reemplazar los siguientes valores de marcador de posición para crear un nuevo usuario de base de datos con privilegios de atlasAdmin en la implementación:
<database username>: Especificar un nombre de usuario para el nuevo usuario de base de datos<database user password>: Especifique una contraseña para su nuevo usuario de base de datos
El comando muestra la siguiente información:
Cluster created. Your connection string: "<connection string URI>"
Guardar el URI de la cadena de conexión para usarlo en un paso futuro.
Conéctese a su implementación
Puede conectarse a su implementación con el MongoDB Shell (mongosh) ejecutando el siguiente comando:
atlas deployments connect myDeployment --connectWith mongosh
atlas deployments connect myDeployment --username <database username> \ --password <database user password> --connectWith mongosh
Nota
Reemplazar los marcadores de posición <database username> y <database user password> por el nombre de usuario y la contraseña que se creó para el usuario de base de datos.
Después de conectarse, puede ejecutar el siguiente comando para probar su conexión:
show dbs
El comando devuelve una lista de bases de datos en su implementación.
¡Felicitaciones! Se configuró con éxito la implementación de MongoDB Atlas y se estableció una conexión. Para aprender más sobre cómo interactuar con la implementación usando MongoDB Shell, se debe consultar la documentación de MongoDB Shell.
En la siguiente sección, enseñaremos cómo crear una aplicación que se conecte a la implementación e interactúe con los datos.
Cree su primera aplicación de MongoDB
Para realizar la conexión a la implementación de MongoDB Atlas en una aplicación, se puede utilizar una de las librerías de clientes oficiales de MongoDB.
Se debe seleccionar el lenguaje de programación preferido en el siguiente menú desplegable para aprender cómo realizar la conexión a la implementación de MongoDB Atlas en ese lenguaje.
Tip
Antes de ejecutar los pasos de esta sección, se debe salir de MongoDB Shell ejecutando el comando exit.