Comprobador de indentación y sintaxis YAML con líneas

Este comprobador de indentación y sintaxis YAML detecta los pequeños errores estructurales que vuelven poco fiables los archivos de configuración: tabulaciones ocultas al inicio, cambios inesperados en la profundidad de indentación y claves repetidas dentro del mismo mapa. Cada hallazgo incluye la línea de origen para que usted pueda ir directamente al ajuste defectuoso. Además, rechaza el texto que no puede interpretarse como YAML, diferenciando una entrada mal formada de un documento válido que solo contiene advertencias de análisis.

Consulte un informe específico en vez de descifrar mensajes del analizador

Pegue el documento YAML completo en el campo de texto y ejecute la comprobación. El resultado indica si el documento pasó, muestra la cantidad de hallazgos y enumera cada problema con un número de línea comenzando en uno, un tipo estable y una explicación. Este formato compacto sirve tanto para revisar un archivo de despliegue como para comprobar mediante un script una configuración generada.

El comprobador se centra en tres riesgos estructurales frecuentes: detecta tabulaciones en el espacio inicial, pues distintos editores pueden mostrarlas con anchuras diferentes; identifica cambios de indentación que no respetan la estructura establecida por los nodos superiores; y registra las claves por ámbito, de modo que una clave puede aparecer en objetos distintos, pero se informa si se repite dentro del mismo objeto. Los comentarios y las líneas vacías no alteran las referencias.

Una respuesta limpia incluye una lista de errores vacía, sin valores de relleno, lo cual facilita usarla como control satisfactorio en compilaciones o flujos previos a una confirmación de cambios.

Distinga entre advertencias de análisis y entradas no válidas

Una advertencia describe texto que todavía puede examinarse con utilidad aunque su estructura resulte arriesgada. Por ejemplo, una tabulación en la indentación o una clave duplicada produce un resultado normal con la línea pertinente. Un fallo de análisis es diferente: el documento está tan incompleto o mal formado que no puede continuar un análisis estructural fiable.

Las comillas sin cerrar, los delimitadores de colecciones de flujo sin pareja, las claves vacías o una línea simple donde se requiere un mapa o una secuencia provocan un error de entrada no válida. Separar ambos resultados resulta práctico en la automatización. Su integración puede mostrar de una vez todos los hallazgos recuperables, mientras que un fallo de análisis puede detener el proceso y solicitar que se repare el origen.

La comprobación es determinista y no reescribe el documento, no elige un valor duplicado ni adivina la anidación pretendida. En configuración, modificar silenciosamente el significado suele ser peor que rechazar el archivo. Corrija primero el fallo de análisis más temprano, vuelva a ejecutar la comprobación y resuelva después las advertencias numeradas restantes.

Utilice el comprobador con seguridad en editores y procesos de entrega

El servicio está pensado para comprobaciones rápidas antes de que YAML llegue a una herramienta de despliegue, un publicador de paquetes, una tarea de integración continua o el arranque de una aplicación. Envíe el texto fuente exacto y no un objeto ya analizado, porque muchos analizadores eliminan la indentación y las claves duplicadas al convertir YAML en datos comunes. Conserve los finales de línea y los comentarios si desea que las posiciones coincidan con su editor.

Un proceso práctico puede ejecutar esta revisión después de aplicar plantillas y antes de insertar secretos, y fallar si valid es false o si la solicitud devuelve un error de entrada no válida. La respuesta es estable para texto idéntico: no usa red, azar, reloj ni estado del entorno. También aplica límites de tamaño y líneas para evitar trabajo ilimitado.

Se trata de un análisis estructural básico, no de un validador de esquemas. No sabe si un campo de Kubernetes, una propiedad de flujo o una opción está permitida. Combínelo con el validador específico de su sistema cuando importe la semántica.