Docker para Bases de Datos

Bienvenido

En las guías anteriores escribiste SQL contra un PostgreSQL que vivía dentro de tu navegador. Sirve para aprender, pero un proyecto real necesita un servidor de base de datos que arranque, guarde datos en disco y acepte conexiones desde tu aplicación. Docker te da eso sin instalar el motor directamente en tu sistema operativo.

Imágenes y contenedores

Instalar PostgreSQL directamente en tu sistema tiene costos escondidos: una sola versión a la vez, servicios que arrancan solos, y una desinstalación que casi nunca deja todo limpio. Un contenedor evita todo eso.

docker run con PostgreSQL

Este es el comando mínimo para tener un PostgreSQL real escuchando en tu máquina:

docker run -d --name pg-uab \
  -e POSTGRES_PASSWORD=cambiame123 \
  -p 5432:5432 \
  postgres:16

La primera vez, Docker descarga la imagen (puede tardar un par de minutos). Después crea el contenedor y lo deja corriendo. Cada parte del comando cumple un rol:

Para comprobar que está vivo y entrar a un psql dentro del contenedor:

docker ps                        # contenedores en ejecución
docker logs pg-uab               # mensajes del motor al arrancar
docker exec -it pg-uab psql -U postgres

Dentro de psql ya podés correr CREATE TABLE, INSERT y todo lo que practicaste en las guías anteriores, pero ahora sobre un PostgreSQL de verdad. Salís con \q.

Variables de entorno

Las imágenes oficiales no traen un archivo de configuración para editar: se configuran con variables de entorno que definís con -e. Estas son las de PostgreSQL:

docker run -d --name pg-uab \
  -e POSTGRES_USER=roy \
  -e POSTGRES_PASSWORD=cambiame123 \
  -e POSTGRES_DB=tienda \
  -p 5432:5432 \
  postgres:16

Volúmenes: que los datos sobrevivan

Un contenedor es desechable por diseño. Todo lo que escribe dentro de su propio sistema de archivos desaparece con él. Para una base de datos eso es un desastre, salvo que guardes los datos en un volumen.

docker run -d --name pg-uab \
  -e POSTGRES_PASSWORD=cambiame123 \
  -p 5432:5432 \
  -v pgdata:/var/lib/postgresql/data \
  postgres:16

-v pgdata:/var/lib/postgresql/data significa: "guardá lo que el contenedor escribe en /var/lib/postgresql/data (el directorio de datos de PostgreSQL) dentro del volumen llamado pgdata". Si borrás el contenedor y creás otro con el mismo -v, la base de datos reaparece intacta.

Para administrar volúmenes:

docker volume ls                 # lista los volúmenes
docker volume inspect pgdata     # dónde vive y desde cuándo existe
docker volume rm pgdata          # BORRA los datos para siempre

Puertos y conexión

Un contenedor tiene su propia red aislada. PostgreSQL escucha en el puerto 5432 adentro, pero tu máquina no lo ve hasta que lo publicás con -p.

-p PUERTO_DE_TU_MAQUINA:PUERTO_DEL_CONTENEDOR

El puerto de la derecha lo fija el motor: 5432 para PostgreSQL, 27017 para MongoDB. El de la izquierda lo elegís vos. Si ya tenés otro PostgreSQL instalado en tu máquina usando el 5432, Docker se queja con port is already allocated. La solución es cambiar solo el lado izquierdo:

docker run -d --name pg-uab \
  -e POSTGRES_PASSWORD=cambiame123 \
  -p 5433:5432 \
  -v pgdata:/var/lib/postgresql/data \
  postgres:16

# desde tu máquina ahora te conectás al 5433
psql -h localhost -p 5433 -U postgres

Una aplicación o herramienta (DBeaver, tu backend) usa una cadena de conexión con esos mismos datos:

postgresql://postgres:cambiame123@localhost:5433/postgres
mongodb://admin:cambiame123@localhost:27017/?authSource=admin

MongoDB en un contenedor

MongoDB sigue exactamente el mismo patrón: imagen oficial, variables de entorno para el usuario administrador, un puerto y un volumen. Lo único que cambia son los nombres.

docker run -d --name mongo-uab \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD=cambiame123 \
  -p 27017:27017 \
  -v mongodata:/data/db \
  mongo:7

docker exec -it mongo-uab mongosh -u admin -p cambiame123 --authenticationDatabase admin

Con esto ya tenés el entorno listo para las próximas guías: JSON en PostgreSQL y, después, MongoDB de verdad. Y para el proyecto integrador vas a necesitar los dos motores corriendo a la vez, que es justo lo que resuelve la siguiente sección.

docker-compose: los dos motores juntos

Dos motores con sus puertos, variables y volúmenes son dos comandos largos que nadie quiere recordar. Docker Compose describe todo en un archivo docker-compose.yml y lo levanta con un solo comando. Además queda dentro del repositorio: quien clone el proyecto tiene el mismo entorno.

services:
  postgres:
    image: postgres:16
    container_name: pg-uab
    environment:
      POSTGRES_USER: roy
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
      POSTGRES_DB: tienda
    ports:
      - "5432:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U roy -d tienda"]
      interval: 5s
      retries: 5

  mongo:
    image: mongo:7
    container_name: mongo-uab
    environment:
      MONGO_INITDB_ROOT_USERNAME: admin
      MONGO_INITDB_ROOT_PASSWORD: ${MONGO_PASSWORD}
    ports:
      - "27017:27017"
    volumes:
      - mongodata:/data/db

volumes:
  pgdata:
  mongodata:

POSTGRES_PASSWORD=cambiame123
MONGO_PASSWORD=otra-clave-distinta-456

Compose lee el .env automáticamente y reemplaza cada ${...}. La estructura es la misma que ya conocés, ahora en YAML: image, environment (los -e), ports (los -p) y volumes (los -v). Los volúmenes con nombre se declaran además al final, en el bloque volumes: de nivel superior.

Armador de comandos

Elegí los motores y las opciones, y mirá cómo cambian al instante el comando docker run y el docker-compose.yml. Los avisos de abajo te dicen qué riesgo introduce cada decisión.

Cuando algo falla

Casi todos los problemas con bases de datos en Docker caen en un puñado de errores. Reconocerlos por su mensaje te ahorra horas.

Actividades de repaso

Un repaso integrador de todo el módulo. Cada actividad se corrige al instante; tu progreso se guarda automáticamente en este navegador.

Cheat Sheet

¿Sabías que...?