#351 · Herramienta para desarrolladores

Validador de Docker Compose

Revisa un archivo Compose en el navegador y detecta problemas estructurales frecuentes antes de ejecutar `docker compose config`. Comprueba la presencia de `services`, nombres de servicio, tipos de campos habituales y referencias de puertos, volúmenes y variables de entorno que suelen provocar errores de configuración.

Datos de entrada

YAML de Docker Compose
Espacio publicitario

Cómo usar esta herramienta para desarrolladores

  1. Pega o carga la entrada indicada.
  2. Ajusta las opciones disponibles, si las hay.
  3. Pulsa el botón principal o usa Ctrl/Cmd + Enter.
  4. Revisa el resumen, la interpretación y las métricas antes de copiar o descargar.

Qué hace esta herramienta para desarrolladores

El análisis interpreta la estructura YAML común de Compose, identifica el bloque `services` y aplica reglas estáticas a cada servicio. No ejecuta Docker ni resuelve extensiones del motor.

El análisis interpreta la estructura YAML común de Compose, identifica el bloque `services` y aplica reglas estáticas a cada servicio. No ejecuta Docker ni resuelve extensiones del motor.

La validación es estática y está pensada para encontrar fallos comunes; la comprobación definitiva debe hacerse con Docker Compose en el entorno de destino.

Ejemplo

services: web: image: nginx ports: - "8080:80"

El informe indicará cuántos servicios se reconocen y listará incidencias concretas.

Casos de uso

  • Revisar cambios antes de un commit.
  • Detectar configuraciones incompletas en ejemplos de documentación.
  • Prevalidar Compose en equipos sin Docker local.

Consejos para obtener resultados fiables

  • Usa espacios, no tabuladores, para la indentación.
  • Evita depender de `version` en archivos nuevos.
  • Declara `image` o `build` en cada servicio.
  • Valida finalmente con la misma versión de Compose usada en producción.

Detalles del procesamiento

El parser local cubre mapas, listas y escalares frecuentes en archivos Compose. Después aplica reglas específicas a `services` y algunos campos superiores.

No implementa toda la especificación YAML ni ejecuta interpolación de variables, anchors complejos, `include` o extensiones del motor Docker.

Preguntas frecuentes

¿Cómo validar un docker-compose.yml sin instalar Docker?

Puedes hacer una revisión estática de la estructura y de campos comunes en el navegador; para validar interpolaciones, perfiles y extensiones del motor debes ejecutar `docker compose config` en un entorno con Docker.

¿Por qué Docker Compose indica que `version` está obsoleto?

Compose Specification ya no necesita el campo superior `version`; los clientes modernos interpretan el archivo según la especificación soportada.

¿Este validador detecta puertos duplicados entre servicios?

Marca asignaciones de host repetidas cuando puede extraerlas de la sintaxis corta de `ports`; las formas avanzadas o valores interpolados requieren revisión adicional.

¿Se validan variables como `${PORT:-8080}`?

Se conservan como texto y se señalan cuando impiden una comprobación concluyente. La expansión real depende del entorno y del archivo `.env`.

¿Puedo usar el resultado en CI?

El informe sirve como prechequeo, pero en CI conviene añadir `docker compose config --quiet` para validar con la versión exacta de Compose del proyecto.

Resumen del módulo

CampoValor
Número351
CategoríaDevOps y contenedores
Slugdocker-compose-validator