🐳 Deploy e infraestructura

Docker empaqueta tu app, dependencias y configuraciones en un contenedor. El Dockerfile define cómo construir la imagen. Claude Code genera Dockerfiles optimizados con compilaciones multietapa.

FROM python:3.12-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 8000
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

Las apps reales tienen más de un servicio: app + base de datos + caché. Docker Compose lo orquesta todo con un único docker-compose.yml. Un docker compose up sube todo junto.

Plataformas como Railway y Fly.io despliegan tu app con un comando. Conecta el repo de Git, configura las variables de entorno y cada push hace un deploy automático. Sin administrar servidores.

# Railway
railway login && railway init && railway up

# Fly.io
fly launch && fly deploy

Secrets en .env, configuraciones por entorno (dev/staging/prod), principio 12-factor. Usa pydantic-settings para cargar y validar configuraciones. Nunca hagas commit de .env en git.

Mínimo viable: endpoint /health, registro estructurado con structlog, y monitoreo externo del uptime. Sin eso, solo descubres los problemas cuando se queja el usuario.

Escalado horizontal (más réplicas) vs. vertical (máquina más grande). Para el 99% de los proyectos iniciales, una réplica con caché es suficiente. Regla de oro: no escales antes de que sea necesario. Cuando el monitoreo muestre un cuello de botella, entonces sí.