Flujo de depuración de YAML

Cuando kubectl, Actions o Compose rechazan un archivo, usa un flujo repetible en lugar de ediciones aleatorias.

Paso 1: Captura los bytes exactos del archivo

Copia el archivo fallido desde git — no una captura de pantalla, no un fragmento de Slack con comillas tipográficas cambiadas. Los caracteres ocultos causan correcciones falsas.

Paso 2: Valida sin mutar

Ejecuta primero el modo solo validación. Quieres feedback del parser sobre el texto actual, no una variante autoformateada que oculte el error original.

Paso 3: Salta a línea y columna

Mensajes del parser como «línea 18, columna 3» apuntan a una indentación o token concreto. Corrige ese punto antes de reformatear todo el archivo.

Paso 4: Formatea y revisa el diff

Cuando la sintaxis sea válida, formatea con el estándar de indentación de tu equipo. Lee el diff — el formateo no debe cambiar el significado, solo espacios en blanco y opcionalmente el orden de claves.

Paso 5: Ida y vuelta JSON cuando te atasques

Si YAML se genera desde herramientas JSON, convierte YAML → JSON → YAML para exponer sorpresas estructurales. Si JSON se ve mal, corrige el modelo de datos antes de debatir indentación.

Paso 6: Vuelve a ejecutar la herramienta original

Aplica con kubectl dry-run, re-ejecuta el workflow o docker compose config — los validadores de dominio detectan problemas que los parsers no ven (campos desconocidos, versiones de API incorrectas).

Recordatorio de seguridad

Nunca pegues secretos de producción en enlaces compartidos de formateadores. Usa muestras redactadas al colaborar.