Lección 4
Errores comunes de YAML
Indentación, tabulaciones, tipado y errores de pegado que rompen configs.
Los fallos de YAML rara vez son misteriosos cuando conoces los sospechosos habituales.
Tabulaciones vs espacios
Muchas guías de estilo prohíben tabulaciones para indentación. Mezclar tabulaciones y espacios parece alineado en algunos editores pero rompe parsers. Configura tu editor para insertar espacios en YAML.
Niveles de indentación desplazados
Añadir una clave un espacio demasiado a la izquierda la adjunta al padre incorrecto. En Kubernetes, eso puede mover containers fuera de spec en tu cabeza — pero no para el parser.
Scalars especiales sin comillas
YAML interpreta valores como yes, no, on, off y 12345 con reglas de tipado. Cuando quieres una cadena, pon comillas:
version: "01.10"
enabled: "yes"
Colecciones flow rotas
Iniciar secuencias con [ o { sin cierres correspondientes produce errores profundos en el archivo. Los generadores de CI a veces emiten YAML flow a medias — valida tras pegar.
Varios documentos en un pegado
Archivos separados por --- son YAML multi-documento válido, pero algunas herramientas esperan un solo documento. Fusionar dos manifiestos sin entender los límites de documento causa errores confusos.
Doble conversión
JSON → YAML → edición manual → JSON puede introducir claves duplicadas o tipos cambiados si herramientas intermedias reordenan o normalizan valores. Haz diff tras cada paso de conversión.