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

Este tutorial le muestra cómo utilizar el atlas deployments Comando para crear una implementación local de Atlas. En este tutorial, implementaremos un conjunto de réplicas de un solo nodo en su equipo local. Después, podrá administrar su implementación y usar Atlas Search y Atlas 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 utilizas Homebrew, puedes 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 deployments 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: se ejecuta el comando con las opciones especificadas. El comando no solicita valores adicionales. Para conocer todas las acciones que atlas deployments admite,atlas-deployments consulte.

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

1

Ejecute el atlas deployments comando en modo interactivo.

atlas deployments setup

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

  1. Copie el siguiente comando:

    atlas deployments 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:

Especifique local - Local Database y presione 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

Ejecute el atlas deployments comando en modo interactivo.

atlas deployments setup

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

  1. Copie el siguiente comando:

    atlas deployments 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

Ejecute el atlas deployments comando con las opciones.

Ejemplo:

atlas deployments setup myLocalRs1 --type local --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 deployments setup myLocalRs1 --type local --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

Usa el comando atlas deployments para gestionar una implementación local de Atlas. Puedes usar los siguientes comandos para las implementaciones de Atlas locales y en la nube. Puedes usar --type local o --type atlas para ejecutar el comando para las implementaciones locales o en la nube respectivamente.

1

Menciona la implementación disponible.

Ejemplo:

atlas deployments 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

Descargue y cargue los datos de muestra.

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

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

  2. 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 deployments 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 deployments pause

  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 deployments 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 deployments 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 deployments 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 deployments setup --type atlas
2

Crea una implementación local de Atlas.

atlas deployments setup --type local

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

  1. Copie el siguiente comando:

    atlas deployments setup --type local --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 deployments connect --type atlas --connectWith connectionString
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 deployments delete --type local

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 deployments setup --type local

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

  1. Copie el siguiente comando:

    atlas deployments setup --type local --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 deployments connect --type local --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 deployments delete --type local

Utilice Atlas Search con una implementación local de Atlas

Utiliza el comando atlas deployments search indexes create para crear un índice de búsqueda de Atlas Search. A continuación, puedes ejecutar consultas de búsqueda de Atlas. Para obtener más información, consulta Atlas Search.

Puedes ejecutar este comando con implementaciones de Atlas locales y en la nube. Para conocer los pasos detallados, consulta Crear un índice de búsqueda de Atlas y ejecutar un query.

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

Usa el comando atlas deployments search indexes create para trabajar con Atlas Vector Search. Para obtener más información, consulta Cómo indexar incrustaciones vectoriales para la búsqueda vectorial.

Puedes ejecutar este comando con implementaciones locales y en la nube de Atlas. Para conocer los pasos detallados, consulta Usar Atlas Vector Search con una implementación de Atlas.

Importante

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

Acciones compatibles

Para conocer todas las acciones que admite atlas deployments, consulte atlas-deployments.

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