Ejecutar MongoDB en Docker: Una guía completa con ejemplos

¿Quieres alojar MongoDB tú mismo o empezar a probarlo en un entorno local? Si no deseas empezar directamente con MongoDB Atlas, tienes varias opciones para dar los primeros pasos, una de ellas son los contenedores con Docker. 

El uso de Docker es una opción sólida para gestionar tu instancia de MongoDB, ya que no lleva más de un minuto y es fácil de mantener y trasladar entre ordenadores host.

En este artículo, veremos algunos enfoques para implementar MongoDB con Docker y exploraremos algunos consejos y trucos a lo largo del camino.

Requisitos previos

Para seguir este tutorial, necesitarás tener instalado Docker Engine en tu ordenador. Esto podría ser en macOS, Windows o Linux. No es necesario instalar Docker Desktop explícitamente, pero puede facilitarte el uso de Docker dependiendo del sistema operativo que utilices. 

Estoy utilizando Docker Engine a través de Rancher Desktop en macOS, por ejemplo, y funciona correctamente.

Para refrescar tus conocimientos sobre Docker, te recomendamos que eches un vistazo a Docker para principiantes: Guía práctica sobre contenedores para ponerte al día con los conceptos básicos.

Descarga de una imagen Docker de MongoDB

Antes de poder empezar a ejecutar MongoDB en un contenedor Docker, primero debes descargar una imagen que se adapte a tus necesidades. Desde la línea de comandos, ejecuta lo siguiente:

docker pull mongodb/mongodb-community-server:latest

El comando anterior descargará la imagen oficial de MongoDB Community Edition (CE) con la etiqueta «latest». 

Es importante tener en cuenta que mongodb/mongodb-community-server y mongodb/mongodb-enterprise-server son imágenes oficiales de Docker mantenidas por MongoDB. Todas las demás imágenes son mantenidas por la comunidad externa y pueden darte resultados diferentes o inesperados.

Una vez descargada la imagen, podemos ver las opciones de implementación.

Ejecutar MongoDB como un contenedor aislado con el comando Docker Run

La forma más rápida de implementar MongoDB con Docker es simplemente utilizar el comando « docker run » con unos pocos parámetros de configuración. Por ejemplo, puedes ejecutar lo siguiente desde la línea de comandos:

docker run -d -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=nraboy -e MONGO_INITDB_ROOT_PASSWORD=password1234 --name mongodb mongodb/mongodb-community-server:latest

El comando anterior tomará nuestra imagen y la implementará como un contenedor denominado «MongoDB». El contenedor se asignará al puerto, lo que significa que el host podrá interactuar con él en el puerto «27017». La información de autenticación raíz también se configura en este ejemplo, pero dependiendo de tus necesidades de implementación, puedes utilizar Docker Secrets u otro método protegido para transmitir información confidencial.

En el ejemplo anterior, todos los datos se almacenan dentro del contenedor. Los datos de MongoDB, que incluyen bases de datos, colecciones e incluso documentos, solo se conservarán mientras exista ese contenedor en particular. Puede que sea adecuado para realizar pruebas, pero en muchas ocasiones querrás que los datos de MongoDB se mantengan de forma fiable en Docker. Para solucionarlo, debes crear un volumen Docker con el siguiente comando:

docker volume create mongodb

Para indicar al contenedor que utilice ese volumen, puedes cambiar el comando de implementación para que tenga un aspecto similar al siguiente:

docker run -d -p 27017:27017 -e MONGO_INITDB_ROOT_USERNAME=nraboy -e MONGO_INITDB_ROOT_PASSWORD=password1234 -v mongodb:/data/db --name mongodb mongodb/mongodb-community-server:latest

Observa que, en esta ocasión, estamos especificando el volumen que se va a utilizar. Cuando utilizas un volumen, puedes estar seguro de que tus datos seguirán existiendo incluso después de cerrar o actualizar tu contenedor.

Con MongoDB ejecutándose desde un contenedor Docker, puedes conectarte a él utilizando mongodb://nraboy:password1234@localhost:27017 como cadena de conexión desde la herramienta que prefieras.

Incluir MongoDB en tu pila o proyecto con Docker Compose

Si tienes pensado utilizar MongoDB con un proyecto concreto, también gestionado con Docker, probablemente tenga sentido gestionar MongoDB con una configuración de Docker Compose. Estas configuraciones se utilizan a menudo para crear entornos aislados para tus proyectos, lo que se conoce como «pilas».

Crea un archivo llamado « docker-compose.yml » en cualquier lugar de tu ordenador con el siguiente contenido:

services:
    mongodb:
        image: mongodb/mongodb-community-server:latest
        container_name: mongodb
        restart: unless-stopped
        ports:
            - "27017:27017"
        volumes:
            - mongodb:/data/db
        environment:
            MONGO_INITDB_ROOT_USERNAME: nraboy
            MONGO_INITDB_ROOT_PASSWORD: password1234

volumes:
    mongodb:
        external: true

La configuración anterior utiliza información que ya hemos visto en el comando de línea de comandos singular. Al igual que con el otro método, se espera que ya hayas creado un volumen mongodb para que lo gestione Docker. Una vez más, si necesitas hacer esto, ejecuta el siguiente comando:

docker volume create mongodb

Por supuesto, puedes gestionar tus volúmenes de Docker como mejor te parezca. Crear un volumen es solo una de las muchas posibilidades.

Con la línea de comandos configurada en el mismo directorio de trabajo que el archivo docker-compose.yml, ejecuta el siguiente comando:

docker compose up -d

El comando anterior inicia la pila en modo separado. 

Puedes comprobar que todo funciona correctamente intentando conectarte a tu instancia con una herramienta como MongoDB Compass, uno de los controladores de lenguaje como Node.js o a través del terminal de MongoDB. 

Si sigues el ejemplo al pie de la letra, tu cadena de conexión será mongodb://nraboy:password1234@localhost:27017, pero dependiendo de cómo hayas seguido los pasos, podría ser diferente.

Para cerrar tu instancia de MongoDB, ejecuta lo siguiente desde la línea de comandos con tu configuración YAML en el mismo directorio de trabajo:

docker compose down

Como estamos utilizando un volumen externo, la próxima vez que inicies el contenedor, todo seguirá intacto.

Conclusión

Docker facilita el trabajo con MongoDB en un entorno autohospedado o local. No tienes que preocuparte por las configuraciones generales del sistema operativo ni por la experiencia que tendrás al pasar de un ordenador a otro. Disfrutarás de una experiencia consistente en todo momento. 

Para dar un paso más, vale la pena aprender a crear una base de datos en MongoDB.