Make the MongoDB docs better! We value your opinion. Share your feedback for a chance to win $100.
Click here >
Docs Menu
Docs Home
/ /
Implementaciones locales y en la nube
Docs Home
/ /
Gestionar Atlas
/
Implementaciones locales y en la nube
Docs Home
/
Herramientas
/
Atlas CLI
/
Gestionar Atlas
/
Implementaciones locales y en la nube

Crear una implementación local de Atlas

Importante

La atlas deployments Los comandos están obsoletos a partir de la versión 1.52.0 de Atlas CLI. Utiliza los comandos atlas local en su lugar. Actualizamos este tutorial para usar el comando atlas local.

Este tutorial muestra cómo usar el comando atlas local para crear una implementación local de Atlas. En este tutorial, implementaremos un set de réplicas de un solo nodo en tu ordenador local. Luego, puedes administrar tu implementación y usar MongoDB Search y MongoDB Vector Search.

Sistemas operativos compatibles para las implementaciones locales de Atlas

Sistema operativo
Versión del sistema operativo
Arquitectura
Número mínimo de núcleos de CPU
RAM libre mínima (GB)

macOS

13.2 y versiones posteriores

x86-64, ARM

2

2

Red Hat Enterprise Linux / CentOS

8, 9

x86-64, ARM

2

2

Ubuntu

22.04, 24.04

x86-64, ARM

2

2

Debian

11, 12

x86-64, ARM

2

2

Amazon Linux

2023

x86-64, ARM

2

2

Windows

10, 11

x86

2

2

Completar los requisitos previos

Antes de comenzar, completa los siguientes requisitos previos:

Importante

Para obtener información sobre la compatibilidad de cada producto en la lista de dependencias, consulte la documentación de instalación del producto.

1

Instala las dependencias.

  1. Instala el Atlas CLI.

    Si usas Homebrewpuedes ejecutar el siguiente comando en tu terminal:

    brew install mongodb-atlas-cli

    Para obtener instrucciones de instalación en otros sistemas operativos, consulte Instalar o actualizar el Atlas CLI.

  2. Instalar Docker.

    Docker requiere una conexión de red para descargar y almacenar en caché las imágenes de MongoDB.

  3. (Opcional) Instala la versión mongosh 2.0 o posterior.

    brew install mongosh

    Para obtener instrucciones de instalación en otros sistemas operativos, consulta Instalar mongosh.

  4. (Opcional) Instala la versión de Compass 1.39.4 o posterior.

    brew install mongodb-compass

    Para las instrucciones de instalación en otros sistemas operativos, consulta Descargar e instalar Compass.

  5. (Opcional) Instala Visual Studio Code y la extensión de MongoDB for VS Code.

    Para obtener más información, consulta Instalar la extensión MongoDB for VS Code.

2

Crea una cuenta de Atlas.

Si aún no se dispone de una cuenta de Atlas existente, se debe ejecutar atlas setup en el terminal o crear una cuenta nueva.

Crear una implementación local de Atlas

Utiliza el comando atlas local para crear una implementación local de Atlas.

Puede ejecutar este comando de las siguientes maneras:

  • Modo interactivo (por defecto): el comando solicita la configuración de implementación y proporciona los valores por defecto.

  • Modo Interactivo (personalizado): el comando solicita la configuración de la implementación y permite proporcionar valores personalizados.

  • Modo no interactivo: ejecutas el comando con las opciones especificadas. El comando no le pide que proporcione más valores. Para aprender todas las acciones que atlas local admite, consulta atlas-local.

Se debe hacer clic en una de las siguientes pestañas para ver el comando de la moda preferida.

1

Ejecuta el comando atlas local en modo interactivo.

atlas local setup

Para cargar datos de muestra de MongoDB durante la configuración:

  1. Ejecuta el siguiente comando:

    atlas local setup --loadSampleData true

Para inicializar la implementación local de Atlas con sus propios datos e índices:

  1. Copie el siguiente comando:

    atlas local setup --initdb {folder}

  2. Reemplaza el marcador de posición {folder} con el directorio que contiene los archivos .js y .sh para ejecutar dentro del contenedor local en orden alfanumérico.

  3. Ejecuta el comando.

2

Especifique qué implementar.

Ejemplo:

Especifica local - Local Database y pulsa Enter..

? What would you like to deploy?  [Use arrows to move, type to filter, ? for more help]
> local - Local Database
  atlas - Atlas Database
[Default Settings]
Deployment Name   local50
MongoDB Version   7.0
Port              27017
3

Se debe especificar cómo configurar la base de datos local de Atlas.

Ejemplo:

Especifica default - With default settings y presiona Enter.

? How do you want to setup your local MongoDB database?  [Use arrows to move, type to filter]
> default - With default settings
  custom - With custom settings
  cancel - Cancel set up
Creating your deployment local50 [this might take several minutes]
1/4: Downloading and completing configuration...
2/4: Starting your local environment...
3/4: Downloading MongoDB binaries to your local environment...
4/4: Creating your deployment local50...
Deployment created!
Connection string: mongodb://localhost:27017/?directConnection=true
1

Ejecuta el comando atlas local en modo interactivo.

atlas local setup

Para cargar datos de muestra de MongoDB durante la configuración:

  1. Ejecuta el siguiente comando:

    atlas local setup --loadSampleData true

Para inicializar la implementación local de Atlas con sus propios datos e índices:

  1. Copie el siguiente comando:

    atlas local setup --initdb {folder}

  2. Reemplaza el marcador de posición {folder} con el directorio que contiene los archivos .js y .sh para ejecutar dentro del contenedor local en orden alfanumérico.

  3. Ejecuta el comando.

2

Especifique qué implementar.

Especifica local - Local Database y presiona Enter.

Ejemplo:

? What would you like to deploy?  [Use arrows to move, type to filter, ? for more help]
> local - Local Database
  atlas - Atlas Database
[Default Settings]
Deployment Name   local50
MongoDB Version   7.0
Port              27017
3

Se debe especificar cómo configurar la base de datos local de Atlas.

Ejemplo:

Especifica custom - With custom settings y presiona Enter.

? How do you want to setup your local MongoDB database?  [Use arrows to move, type to filter]
  default - With default settings
> custom - With custom settings
  cancel - Cancel set up
4

Especifica un nombre de implementación.

Ejemplo:

Especifica myLocalRs y presiona Enter.

? Deployment Name [This can't be changed later] (local3612) myLocalRs
5

Especifique una versión de MongoDB.

Ejemplo:

Especifica 7.0 y presiona Enter.

? MongoDB Version  [Use arrows to move, type to filter]
> 7.0
  6.0
6

Especifica un puerto.

Ejemplo:

Especifica 37018 y presiona Enter.

? Specify a port (49469) 37018
Creating your deployment myLocalRs
1/2: Starting your local environment...
2/2: Creating your deployment myLocalRs...
Deployment created!
Connection string: mongodb://localhost:37018/?directConnection=true
1

Ejecuta el comando atlas local con las opciones.

Ejemplo:

atlas local setup myLocalRs1 --force
[Default Settings]
Deployment Name      myLocalRs1
MongoDB Version   7.0
Port              49684
Creating your deployment myLocalRs1
1/2: Starting your local environment...
2/2: Creating your deployment myLocalRs1...
Deployment created!
Connection string: mongodb://localhost:49684/?directConnection=true
connection skipped

Para inicializar la implementación local de Atlas con sus propios datos e índices:

  1. Copie el siguiente comando:

    atlas local setup myLocalRs1 --force --initdb {folder}

  2. Reemplaza el marcador de posición {folder} con el directorio que contiene los archivos .js y .sh para ejecutar dentro del contenedor local en orden alfanumérico.

  3. Ejecuta el comando.

Gestione una implementación local de Atlas

Use el comando atlas local para administrar una implementación de Atlas local.

1

Menciona la implementación disponible.

Ejemplo:

atlas local list
NAME        TYPE    MDB VER   STATE
local50     LOCAL   7.0.1     IDLE
local62     LOCAL   7.0.1     IDLE
myLocalRs   LOCAL   7.0.1     IDLE
myLocalRs1  LOCAL   7.0.1     IDLE
2

Cargar datos de muestra.

Nota

También puedes cargar datos de muestra durante la configuración de la implementación utilizando la opción --loadSampleData true con atlas local setup. Consulta los ejemplos de configurar anteriores.

Para cargar datos de ejemplo en una implementación existente:

  1. Ejecute el siguiente comando para descargar los datos de muestra:

    curl  https://atlas-education.s3.amazonaws.com/sampledata.archive -o sampledata.archive

  2. Obtén el número de puerto para tu implementación:

    1. Copie el siguiente comando:

      atlas local connect <deployment name> --connectWith connectionString

    2. Reemplace <deployment name> con el nombre de su implementación.

    3. Ejecuta el comando.

      La cadena de conexión incluye el número de puerto. Por ejemplo, en la cadena de conexión mongodb://localhost:27017/?directConnection=true, el número de puerto es 27017.

  3. Copia y pega el siguiente comando en la terminal y sustituye {port-number} por el puerto para la implementación:

    mongorestore --archive=sampledata.archive --port={port-number}
3

Conéctate a una implementación.

  1. Ejecuta el siguiente comando para conectarte a una implementación:

    atlas local connect

  2. Especifica la implementación a la que conectarse y presiona Enter.

  3. Especifique cómo desea conectarse a la implementación y presione Enter.

    Puede recuperar la cadena de conexión o conectarse a los siguientes clientes: cadena de conexión:

4

Pausa una implementación.

  1. Ejecute el siguiente comando para pausar una implementación:

    atlas local stop

  2. Especifica la implementación que deseas pausar y presiona Enter.

5

Inicia una implementación.

  1. Ejecute el siguiente comando para iniciar una implementación:

    atlas local start

  2. Especifica la implementación que deseas iniciar y presiona Enter.

6

Devuelva los registros de la implementación.

  1. Ejecute el siguiente comando para obtener los registros de una implementación:

    atlas local logs

  2. Especifica la implementación para la que deseas devolver los registros y pulsa Enter.

Borrar una implementación de Atlas

  1. Ejecuta el siguiente comando para borrar una implementación:

    atlas local delete

  2. Especifica la implementación que deseas borrar y presiona Enter.

  3. Especifica y y presiona Enter para confirmar.

Mover una implementación local de Atlas a una implementación en la nube de Atlas

Puede usar Docker y MongoDB Database Tools para mover una implementación local de Atlas a una implementación en la nube de Atlas.

1

Crea una implementación en la nube de Atlas.

atlas setup
2

Crea una implementación local de Atlas.

atlas local setup

Para inicializar la implementación local de Atlas con sus propios datos e índices:

  1. Copie el siguiente comando:

    atlas local setup --initdb {folder}

  2. Reemplaza el marcador de posición {folder} con el directorio que contiene los archivos .js y .sh para ejecutar dentro del contenedor local en orden alfanumérico.

  3. Ejecuta el comando.

3

Crea un archivo binario de los datos.

  1. Copie el siguiente comando:

    docker exec -u root -it {local_deployment_name} sh -c "mkdir -p /data/dump && chown -R mongod:mongod /data/dump && mongodump --archive=/data/dump/dump.archive"

  2. Sustituya el marcador {local-deployment-name} por el nombre de la implementación local de Atlas.

  3. Ejecuta el comando.

4

Copia el fichero.

  1. Copie el siguiente comando:

    docker cp <local deployment name>:/data/dump/dump.archive .

  2. Sustituya el marcador {local-deployment-name} por el nombre de la implementación local de Atlas.

  3. Ejecuta el comando.

5

Devuelve la cadena de conexión.

atlas clusters connectionStrings describe
6

Restaurar desde el archivo de archivo.

  1. Copie el siguiente comando:

    mongorestore --uri={connection-string} --archive=./dump.archive

  2. Reemplace el marcador de posición {connection-string} con la cadena de conexión.

  3. Ejecuta el comando.

7

(Opcional) Borra la implementación local de Atlas.

atlas local delete

Actualizar una implementación local de Atlas

Puedes usar Docker y MongoDB Database Tools para actualizar una implementación de Atlas local a una versión más nueva de la imagen.

1

Crea una nueva implementación local de Atlas.

atlas local setup

Para inicializar la implementación local de Atlas con sus propios datos e índices:

  1. Copie el siguiente comando:

    atlas local setup --initdb {folder}

  2. Reemplaza el marcador de posición {folder} con el directorio que contiene los archivos .js y .sh para ejecutar dentro del contenedor local en orden alfanumérico.

  3. Ejecuta el comando.

2

Crea un archivo binario de los datos.

  1. Copie el siguiente comando:

    docker exec -u root -it {old-local-deployment-name} sh -c "mkdir -p /data/dump && chown -R mongod:mongod /data/dump && mongodump --archive=/data/dump/dump.archive"

  2. Sustituya el marcador {old-local-deployment-name} por el nombre de su antigua implementación local de Atlas.

  3. Ejecuta el comando.

3

Copia el fichero.

  1. Copie el siguiente comando:

    docker cp {old-local-deployment-name}:/data/dump/dump.archive .

  2. Sustituya el marcador {old-local-deployment-name} por el nombre de su antigua implementación local de Atlas.

  3. Ejecuta el comando.

4

Devuelve la nueva cadena de conexión.

atlas local connect --connectWith connectionString
5

Restaurar desde el archivo de archivo.

  1. Copie el siguiente comando:

    mongorestore --uri={connection-string} --archive=./dump.archive

  2. Reemplaza el marcador de posición {connection-string} con la cadena de conexión.

  3. Ejecuta el comando.

6

(Opcional) Borra la antigua implementación local de Atlas.

atlas local delete

Usar MongoDB Search con una implementación local de Atlas

Utiliza el comando atlas local search indexes create para crear un índice de búsqueda de MongoDB Search. Luego podrás ejecutar consultas de MongoDB Search. Para obtener más información, consulta MongoDB Search.

Para ver los pasos detallados, consulta Crear un índice de búsqueda de MongoDB y ejecutar una query.

Utilice MongoDB Vector Search con una implementación local de Atlas

Use el comando atlas local search indexes create para trabajar con MongoDB Vector Search. Para saber más, consulta Cómo indexar incrustaciones vectoriales para búsqueda vectorial.

Para obtener pasos detallados, consulte Usar la búsqueda vectorial de MongoDB con una implementación en Atlas.

Importante

Para utilizar la Atlas CLI con MongoDB Vector Search, debe crear una implementación de Atlas con MongoDB 7.0.5 o posterior. Si creaste una implementación local de Atlas con una versión anterior de MongoDB, no obtendrás la última versión de MongoDB automáticamente. Debes borrar las imágenes e implementaciones anteriores. Luego debes crear una nueva implementación de Atlas.

Acciones compatibles

Para conocer todas las operaciones que admite atlas local, consulta atlas-local.

Solución de problemas de error

Para obtener más información sobre la resolución de problemas de implementación local de Atlas, consulta Solucionar problemas de implementación local de Atlas.

Volver

Implementaciones locales y en la nube

Next

Implementar con Docker

En esta página