Importante
La atlas deployments Los comandos están obsoletos desde la versión 1.52.0 de Atlas CLI. Utilice los comandos atlas local para implementaciones locales y los comandos atlas clusters para implementaciones en la nube. Hemos actualizado esta guía para usar los nuevos comandos.
En esta guía, aprenderás cómo crear una implementación de MongoDB Atlas localmente o en la nube. Luego, aprenderás a crear una aplicación que se conecte a tu implementación. Para aprender cómo instalar las ediciones MongoDB Community o MongoDB Enterprise en tu propia infraestructura, consulta la Guía para instalar 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.
Ejecuta los siguientes comandos para instalar las dependencias con el administrador de paquetes Homebrew. Si no tienes Homebrew, puedes instalarlo siguiendo las instrucciones en el 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 local setup myDeployment \ --mdbVersion 8.0 --port <port number> --connectWith connectionString
Nota
Sustituye el marcador <port number> por el puerto que quieras usar. El puerto por defecto es 27017, pero puedes especificar un puerto diferente 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 setup --clusterName myDeployment \ --provider AWS --region us-east-1 --skipSampleData \ --username <database username> --password <database user password> \ --connectWith skip --force
Nota
Reemplace los siguientes valores de los marcadores de posición para crear un nuevo usuario de base de datos con atlasAdmin privilegios en su 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 local connect myDeployment --connectWith mongosh
atlas clusters 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.