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 Implementación de 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, ejecute 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 desea utilizar en su 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
La CLI de Atlas admite la implementación de las versiones 7 y 8 de MongoDB. Para poder implementar cualquiera de las versiones desde el registro mediante la CLI de Atlas, debe repetir este paso para 7.0 las 8.0 etiquetas y. Para ver la lista de etiquetas disponibles, consulte el repositorio de Docker Hub.
Envíe la imagen de su máquina a su registro de contenedores.
Ejecute el siguiente comando después de reemplazar los siguientes valores de marcador de posición para enviar la imagen a su registro de contenedor:
<tag>La etiqueta, que especifica la versión de MongoDB, que desea utilizar en su 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.
Verifique que la imagen se haya cargado exitosamente.
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 establece la variable de entorno para la sesión de terminal actual. Para que esta configuración se mantenga en todas las sesiones de terminal, configure esta variable de entorno en su perfil, almacenado en el archivo de configuración.
Verifique 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.Complete la implementación seleccionando la configuración adecuada cuando se le solicite.
Para aprender más, consulta Crear una implementación local de Atlas.