Docker y Docker Compose

Durante el curso vamos a necesitar tres gestores de bases de datos distintos: MariaDB (UD3), PostgreSQL con PostGIS (UD5) y MongoDB (UD6). Instalarlos nativamente en tu equipo significaría tres instaladores, tres servicios arrancando al iniciar el sistema, tres configuraciones que ajustar y una desinstalación complicada al terminar el curso.

Con Docker se resuelve con un fichero de texto y un comando.

Qué es un contenedor​

Un contenedor es un proceso aislado que se ejecuta sobre el núcleo del sistema anfitrión, con su propio sistema de ficheros, su propia red y sus propios límites de recursos.

Vocabulario mínimo​

Instalación​

• Windows / macOS: Docker Desktop. En Windows requiere WSL 2 y virtualización habilitada en la BIOS.
• Linux: Docker Engine desde el repositorio oficial, y añadir tu usuario al grupo docker.

Verificación:

docker --version
docker compose version
docker run --rm hello-world

::: warning[docker compose con espacio]

La versión antigua era docker-compose (con guion, un binario aparte). La actual es docker compose (subcomando, plugin v2). Usa siempre la segunda; la sintaxis del fichero es la misma pero los mensajes de error y algunas opciones difieren.

:::

Comandos que vas a usar​

docker ps                      # contenedores en ejecución
docker ps -a                   # incluidos los parados
docker images                  # imágenes descargadas
docker logs -f multagal-mariadb    # ver la salida de un contenedor
docker exec -it multagal-mariadb bash   # abrir una shell dentro
docker volume ls               # volúmenes
docker stats                   # consumo de recursos en vivo

Con Compose, situado en la carpeta del compose.yaml:

docker compose up -d           # levanta todos los servicios en segundo plano
docker compose up -d postgres  # levanta sólo uno
docker compose ps              # estado de los servicios
docker compose logs -f mongo   # sigue el log de un servicio
docker compose stop            # para sin destruir
docker compose down            # para y destruye contenedores (conserva volúmenes)
docker compose down -v         # ⚠️ destruye TAMBIÉN los volúmenes: borra los datos

El compose.yaml del curso​

Este fichero va en la raíz del repositorio del proyecto y define los tres servicios de datos. Créalo ahora, aunque hasta la UD3 sólo uses uno.

name: multagal

services:

  # ─── UD3: base de datos relacional ────────────────────────────────
  mariadb:
    image: mariadb:11
    container_name: multagal-mariadb
    restart: unless-stopped
    environment:
      MARIADB_ROOT_PASSWORD: ${MARIADB_ROOT_PASSWORD}
      MARIADB_DATABASE: multagal
      MARIADB_USER: ${MARIADB_USER}
      MARIADB_PASSWORD: ${MARIADB_PASSWORD}
    ports:
      - "3306:3306"
    volumes:
      - mariadb-data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      interval: 10s
      timeout: 5s
      retries: 5

  # ─── UD5: base de datos objeto-relacional + geoespacial ───────────
  postgres:
    image: postgis/postgis:16-3.4
    container_name: multagal-postgres
    restart: unless-stopped
    environment:
      POSTGRES_DB: multagal
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d multagal"]
      interval: 10s
      timeout: 5s
      retries: 5

  # ─── UD6: base de datos documental ────────────────────────────────
  mongo:
    image: mongo:7
    container_name: multagal-mongo
    restart: unless-stopped
    environment:
      MONGO_INITDB_ROOT_USERNAME: ${MONGO_USER}
      MONGO_INITDB_ROOT_PASSWORD: ${MONGO_PASSWORD}
      MONGO_INITDB_DATABASE: multagal
    ports:
      - "27017:27017"
    volumes:
      - mongo-data:/data/db
    healthcheck:
      test: ["CMD", "mongosh", "--eval", "db.adminCommand('ping')"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  mariadb-data:
  postgres-data:
  mongo-data:

Lectura del fichero, línea a línea​

Credenciales: el fichero .env​

Observa que en el compose.yaml no hay ni una sola contraseña escrita. Todas son ${VARIABLE}, que Compose lee de un fichero .env situado junto a él.

.env — este fichero NO se sube al repositorio:

MARIADB_ROOT_PASSWORD=cambiaEstaClaveRoot
MARIADB_USER=multagal
MARIADB_PASSWORD=cambiaEstaClave

POSTGRES_USER=multagal
POSTGRES_PASSWORD=cambiaEstaClave

MONGO_USER=multagal
MONGO_PASSWORD=cambiaEstaClave

.env.example — este sí se sube, con valores de relleno, para que quien clone el repositorio sepa qué variables necesita:

MARIADB_ROOT_PASSWORD=
MARIADB_USER=multagal
MARIADB_PASSWORD=
POSTGRES_USER=multagal
POSTGRES_PASSWORD=
MONGO_USER=multagal
MONGO_PASSWORD=

Y en .gitignore:

.env

Comprobación de que funciona​

docker compose up -d
docker compose ps

Los tres servicios deben aparecer como running (healthy). Si alguno queda en starting más de un minuto o pasa a unhealthy, mira su log:

docker compose logs mariadb

Conexión directa a cada uno para confirmar:

# MariaDB
docker exec -it multagal-mariadb mariadb -u multagal -p multagal

# PostgreSQL — comprobando además que PostGIS está disponible
docker exec -it multagal-postgres psql -U multagal -d multagal \
  -c "CREATE EXTENSION IF NOT EXISTS postgis; SELECT postgis_version();"

# MongoDB
docker exec -it multagal-mongo mongosh -u multagal -p

Problemas frecuentes​

docker compose down -v && docker compose up -d

[wsl2]
memory=6GB
processors=4

Lo que viene después​

En la UD7 daremos la vuelta al planteamiento: en lugar de contenerizar sólo las bases de datos, contenerizaremos también la aplicación, y el compose.yaml levantará el sistema completo. De momento, tu aplicación corre en tu máquina y sólo las bases están en contenedores.