La Atlas CLI extrae una imagen de Docker y crea un contenedor para implementar el clúster local. Por defecto, Atlas CLI extrae desde Docker Hub público repositorio
mongodb/mongodb-atlas-local. Puedes configurarlo para que obtenga una imagen específica de un registro interno, normalmente privado.
Esta página explica cómo extraer y volver a etiquetar la imagen del contenedor mongodb-atlas-local, cargarla en un registro privado y luego configurar la Atlas CLI para utilizar las imágenes privadas para implementando clústeres locales.
Requisitos previos
Antes de comenzar, asegúrate de tener lo siguiente:
Herramientas de línea de comandos de Docker
Registro de contenedor privado para el cual tiene permiso de escritura
Un terminal
Atlas CLI
Procedimiento
Extrae y vuelve a etiquetar la imagen local de MongoDB para la implementación local.
Para extraer y volver a etiquetar, ejecuta el siguiente comando después de reemplazar los siguientes valores de marcador de posición:
| La etiqueta que especifica la versión de MongoDB que se desea utilizar en la implementación. |
| La ruta completa y el nombre del namespace del registro de contenedores para el que tienes permisos de escritura. |
docker tag mongodb/mongodb-atlas-local:<tag> <container-registry-namespace>/mongodb-atlas-local:<tag>
Nota
Atlas CLI admite la implementación de la versión 7 y 8 de MongoDB. Para admitir la implementación de cualquiera de las versiones desde tu registro usando la Atlas CLI, debes repetir este paso para las etiquetas 7.0 y 8.0. Para obtener la lista de etiquetas disponibles, consulte el repositorio de Docker Hub.
Sube la imagen que tienes en tu máquina a tu registro de contenedores.
Ejecuta el siguiente comando después de reemplazar los siguientes valores de marcador de posición para subir la imagen a tu registro de contenedores:
<tag>La etiqueta que especifica la versión de MongoDB que se desea utilizar en la implementación.
<container-registry-namespace>La ruta completa y el nombre del namespace del registro de contenedores para el que tienes permisos de escritura.
docker push <container-registry-namespace>/mongodb-atlas-local:<tag> Esta operación puede demorar unos minutos en completarse.
Nota
Atlas CLI admite la implementación de las versiones 7 y 8 de MongoDB. Para admitir el despliegue de cualquier versión desde tu registro mediante Atlas CLI, debes repetir este paso para las etiquetas 7.0 y 8.0.
Verifica que se haya subido la imagen correctamente.
Puede verificarlo de las siguientes maneras:
Inicia sesión en tu registro de contenedores y comprueba que la imagen se haya cargado correctamente.
Ejecute el comando
docker pullpara extraer la imagen de su registro a su máquina.
Configura Atlas CLI para usar la imagen en el registro.
Establezca la variable de entorno
MONGODB_ATLAS_LOCAL_DEPLOYMENT_IMAGEdespués de reemplazar<container-registry-namespace>por la ruta y nombre completamente calificados del espacio de nombres del registro de contenedor que creó en el paso 2.export MONGODB_ATLAS_LOCAL_DEPLOYMENT_IMAGE=<container-registry-namespace>/mongodb-atlas-local Nota
Este método solo configura la variable de entorno para la sesión actual del terminal. Para mantener esta configuración en las sesiones del terminal, establece esta variable de entorno en tu perfil almacenado en el archivo de configuración.
Verifica que la variable de entorno esté configurada correctamente.
echo $MONGODB_ATLAS_LOCAL_DEPLOYMENT_IMAGE
Después de establecer la variable de entorno, Atlas CLI utiliza el valor de la variable en lugar de la ubicación por defecto para todas las implementaciones.
Implementa Atlas con tu imagen.
Ejecute el siguiente comando para iniciar la implementación después de reemplazar el
<deploymentName>con un nombre para la implementación.atlas deployments setup <deploymentName> Introduzca
localcuando se le solicite especificar el tipo de implementación.Completa la implementación seleccionando la configuración adecuada cuando se te solicite.
Para aprender más, consulta Crear una implementación local de Atlas.