Generador de Docker Compose

La especificación moderna de Compose

Compose V2 (el complemento incluido con Docker Desktop y el motor Docker moderno) sigue la Especificación de Compose. La clave version: está obsoleta; el generador la omite. Las claves de nivel superior son services, networks, volumes, configs y secrets.

Anatomía del servicio

Un servicio orientado a producción se ve así:

services:
  web:
    image: nginx:1.27-alpine
    restart: unless-stopped
    ports:
      - "80:80"
    volumes:
      - ./public:/usr/share/nginx/html:ro
    depends_on:
      app:
        condition: service_healthy
    networks:
      - frontend
      - backend
    healthcheck:
      test: ["CMD", "wget", "--spider", "-q", "http://localhost/health"]
      interval: 30s
      timeout: 5s
      retries: 3

Volúmenes: montaje por enlace vs nombrado

• Montaje por enlace (./app:/var/www) vincula el contenedor a una ruta en el host; excelente para el desarrollo local porque los cambios se reflejan de inmediato.
• Volumen nombrado (pgdata:/var/lib/postgresql/data) es gestionado por Docker y persiste independientemente de cualquier ruta del host; la elección correcta para bases de datos y cualquier cosa que no quieras eliminar accidentalmente con rm -rf.
• Volumen anónimo - evitar. Sobrevive a los reinicios pero desaparece en docker compose down -v sin advertencia.

Redes

Por defecto, Compose crea una red nombrada según el proyecto y conecta cada servicio a ella. Declarar redes explícitas es útil cuando:

• Quieres aislar una base de datos de un servicio expuesto al público.
• Necesitas un puente con una subred personalizada para alinearte con la infraestructura existente.
• Quieres adjuntar contenedores a una red externa preexistente (external: true).

Errores comunes que conviene evitar

• Conflictos de clave de versión. version: "3.8" en la parte superior impide que funciones más nuevas como start_interval de healthcheck funcionen en Compose antiguo; el generador omite la clave de versión.
• Citas de puertos. 8080:80 se analiza como YAML base-60 en algunos casos extremos; el generador siempre pone entre comillas los mapeos de puertos.
• Secretos codificados. Los secretos escritos directamente en compose.yml acaban comprometidos en git. Guárdalos en un env_file o en el gestor de secretos de la plataforma.
• depends_on sin condición. depends_on: [db] simple espera a que el contenedor se inicie, no a que el servicio esté listo. Usa condition: service_healthy y añade un healthcheck a la dependencia.