Docker y contenedores

validador de Docker Compose

Revisa un documento Compose, sus relaciones declaradas y las referencias pendientes.

validador de Docker Compose

Entrada YAML de Compose

Resultados del análisis

El YAML permanece en este navegador. No se ejecuta Docker ni se leen archivos de entorno o realizan peticiones de red.

Opciones de revisión

La entrada es visible. Revelar la salida permite exportar YAML con sus valores originales, incluidos secretos.

Comprobación estática: esquema Compose fee041b (01-09-2026). Sin interpolación, lectura de archivos, perfiles ni ejecución.

Hasta 200.000 unidades UTF-16, 100 servicios y 500 relaciones. Se muestran tandas de 50.

La entrada o las opciones han cambiado. Analiza de nuevo antes de exportar.

El validador de Docker Compose ayuda a revisar cambios en una pila de servicios. Un YAML bien indentado aún puede publicar dos servicios en el mismo puerto o mencionar un volumen sin declarar. Los diagnósticos apuntan al origen y el formato se genera aparte, de modo que puedes comparar sin sobrescribir la entrada.

Por qué usar este validador de Docker Compose

Seguir las conexiones declaradas

El validador de Docker Compose reúne dependencias, montajes y puertos. La flecha sale del servicio dependiente hacia su destino. También conserva la condición de depends_on en formato largo y las relaciones entre espacios de nombres. El diagrama no afirma que la base de datos esté lista ni que la conexión funcione.

Tres servicios conectados en cadena, con un volumen unido debajo de la base de datos.

Diferenciar un conflicto de una posibilidad

Dos destinos internos distintos pueden competir por el mismo puerto del host. TCP y UDP se comparan por separado. Los rangos de asignación, comodines IPv4/IPv6 y perfiles reciben advertencias prudentes cuando la asignación final o el conjunto activo todavía se desconoce.

Dos servicios apuntan al mismo socket del host, resaltado para revisión.

De la ubicación del error a la exportación

01

Resuelve primero la estructura

Para validar compose.yaml, consulta la línea y columna de los errores de YAML y la ruta de los campos incompatibles. Las vistas de relaciones requieren una estructura reconocida. version no cambia el motor a un esquema histórico.

02

Compara el lado del host

Dos contenedores pueden escuchar en su propio puerto 80. Revisa la dirección del host, el puerto published y el protocolo. Las variables y asignaciones automáticas quedan sin resolver; no se sustituyen por números inventados para aparentar un resultado completo.

03

Muestra los valores antes de exportar

La entrada sigue visible, pero la salida completa se oculta inicialmente. Mostrarla habilita el YAML con sus valores originales. Desactiva el análisis automático para usar el botón o Ctrl/Cmd + Enter. Cualquier edición inhabilita de inmediato las exportaciones anteriores.

Una configuración, varias formas de inspeccionarla

Esquema oficial y reglas concretas

Se utiliza la instantánea oficial del 01-09-2026 junto con comprobaciones de fuentes de servicio, referencias, ciclos y sintaxis de puertos. Los campos desconocidos se señalan, no se borran. El formateo conserva comentarios y anclas sin ordenar claves ni modificar el texto de entrada.

Dependencias y orígenes de los montajes

Las dos formas de depends_on, espacios de nombres de servicio, links y volumes_from aparecen como relaciones. Los volúmenes con nombre se comparan con las declaraciones superiores. Las rutas bind se muestran sin abrir archivos; los volúmenes anónimos se distinguen de los declarados.

Variables de entorno sin copiar valores

Se recorren los valores de texto con $VAR, expresiones entre llaves y alternativas anidadas. $$ escapa el dólar. Las entradas environment sin valor representan el paso desde el shell. La plantilla ordena nombres únicos y genera NAME=, sin valores por defecto ni contraseñas.

Resultados completos dentro del límite

El YAML conserva valores y expresiones. El informe JSON excluye el documento íntegro y los valores por defecto, pero conserva diagnósticos, rutas y relaciones. Las listas muestran 50 registros por tanda; los archivos exportados incluyen todos los registros admitidos.

Límites de una revisión estática

No ejecuta contenedores
No inicia Docker, descarga imágenes, prueba healthchecks ni escanea puertos ocupados por otros programas. Una estructura válida no garantiza permisos, conectividad o compatibilidad con tu versión. La comprobación final debe hacerse en el entorno de destino.
No resuelve archivos externos
Solo admite un documento YAML 1.2. Rechaza claves duplicadas, alias cíclicos y etiquetas no compatibles. include y extends bloquean la exportación de configuración. No fusiona overrides ni lee .env o env_file; resuelve ese contexto localmente antes de pegarlo.
No activa perfiles ni asigna puertos
Participan todos los servicios declarados. Los solapamientos con perfiles o rangos se consideran posibles conflictos, aunque una selección concreta no los ejecute juntos. Las variables y los puertos automáticos permanecen indeterminados, y otros proyectos en ejecución quedan fuera del análisis.
Ocultar no elimina secretos
El origen permanece visible. Una vez revelada la salida, el YAML descargado puede contener credenciales y solo se permite si no hay errores. La plantilla ENV siempre deja los valores vacíos. Poder descargar un informe de errores no significa que la configuración haya sido aprobada.
Tamaño y especificación definidos
Se aceptan hasta 200.000 unidades UTF-16, 100 servicios y 500 relaciones. La expansión de anclas y claves de mezcla se limita a 20.000 nodos y profundidad 40. El commit del esquema empieza por fee041b; los campos añadidos después requieren actualizar la instantánea.
Montajes y disponibilidad limitados
Se inspeccionan principalmente bind, volúmenes con nombre y tmpfs. Otros tipos permitidos por el esquema se marcan para revisión manual. No se comprueba la existencia de rutas ni se simula el momento en que una aplicación estará lista. Las flechas solo describen declaraciones.

Preguntas sobre el validador de Docker Compose

¿Qué diferencia hay con docker compose config?

Compose en tu equipo puede resolver archivos y variables para construir la configuración del proyecto. Esta página analiza un documento pegado con un esquema fijo y ciertas reglas estáticas. No sustituye la resolución de overrides ni conoce el estado del daemon o del sistema de archivos.

¿Detecta erratas en los nombres de las claves?

Sí, el esquema identifica campos que no pertenecen a la estructura admitida. Se conserva el texto y se muestra la ruta del problema. No se corrige automáticamente una clave parecida, porque elegir otra podría cambiar la intención de la configuración.

¿Se sube mi archivo a algún servidor?

El análisis se ejecuta en un worker del navegador. No se abren las URL escritas en el documento ni se leen archivos externos. La copia y las descargas se realizan al pulsar sus controles, sin enviar la configuración para ejecutarla.

¿Contra qué versión de Compose valida?

Contra la instantánea de Compose Specification del 1 de septiembre de 2026, identificada por el commit fee041b. El campo version se conserva como compatibilidad y produce una advertencia; no selecciona los antiguos esquemas 2 o 3.

¿Por qué marca una línea que parece correcta?

El error puede depender de la indentación anterior, una clave duplicada o un tipo de dato no admitido. Además de la posición, consulta la ruta de diagnóstico. En valores heredados mediante anclas, la ubicación más cercana puede ser la declaración que permite resolver ese valor.

¿Necesitas una explicación más precisa para una declaración?

Contrasta las declaraciones antes de iniciar

Vuelve al validador de Docker Compose, corrige las rutas indicadas y revisa los puertos del host antes de mostrar y exportar los valores necesarios.