Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
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

Los comandos atlas deployments 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 utilizar 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 se usa Homebrew, se puede ejecutar el siguiente comando en el 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 pulsa 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 pulsa 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 pulsa 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 pulsa Enter.

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

Especifique una versión de MongoDB.

Ejemplo:

Especifica 7.0 y pulsa Enter.

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

Especifica un puerto.

Ejemplo:

Especifica 37018 y pulsa 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.

Alternativa en Python: Crear una implementación local de Atlas

Como alternativa a la CLI de Atlas, puede usar la biblioteca de Python atlas-local-lib-py para crear y administrar programáticamente implementaciones locales de bases de datos de Atlas. Este enfoque es útil para flujos de trabajo basados ​​en Python, pruebas automatizadas e integración con aplicaciones de Python.

Requisitos previos

Antes de comenzar, asegúrate de tener lo siguiente:

  • Python 3.10 o posterior

  • Docker Desktop o Docker Engine instalados y en funcionamiento

Instalar la biblioteca

Instala atlas-local-lib-py usando pip:

pip install atlas-local-lib-py

Crear o reutilizar una implementación

Utilice el siguiente código Python para crear una nueva implementación de base de datos local o reutilizar una existente con la misma configuración:

from atlas_local import LocalDeployment
# Create or reuse a deployment named "my-local-deployment"
deployment = LocalDeployment.get_or_create(
    name="my-local-deployment"
)
# Get the connection string
connection_string = deployment.connection_string()
print(f"Connection string: {connection_string}")

El método get_or_create():

  • Crea una nueva implementación si no existe ninguna con el nombre especificado.

  • Reutiliza una implementación existente si ya existe una con el nombre especificado.

  • Devuelve un objeto LocalDeployment que puede utilizar para gestionar la implementación.

  • Gestiona automáticamente el ciclo de vida del contenedor Docker.

Cargar datos de muestra

Utilice el siguiente método de Python para cargar datos de ejemplo de MongoDB en su implementación:

from atlas_local import LocalDeployment
deployment = LocalDeployment.get_or_create(
    name="my-local-deployment"
)
# Load sample data
deployment.load_sample_data()

Para obtener más información sobre la biblioteca de Python, consulte el repositorio atlas-local-lib-py.

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 de tu implementación ejecutando el siguiente comando y seleccionando tu implementación:

    atlas local connect --connectWith connectionString

    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. Obtén el número de puerto para tu implementación:

    1. Copie el siguiente comando:

      atlas local connect <deployment name> --connectWith connectionString

    2. Sustituye <deployment name> por el nombre de tu 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.

  4. 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 quieres conectarse y pulsa 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. Especifique la implementación que desea pausar y presione Enter.

5

Inicia una implementación.

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

    atlas local start

  2. Especifique la implementación que desea iniciar y presione 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. Especifique la implementación para la que desea devolver los registros y pulse Enter.

Borrar una implementación de Atlas

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

    atlas local delete

  2. Especifique la implementación que desea borrar y presione 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.

Próximos pasos

Después de crear y verificar su implementación local de Atlas, puede:

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