Compatibilidad entre YAML 1.2 y JSON en infraestructura como código (IaC)
Desde la especificación YAML 1.2, YAML se define formalmente como un superconjunto estricto de JSON. Mientras que YAML es el formato preferido para archivos de configuración editados por humanos —como manifiestos de Kubernetes, flujos de trabajo de GitHub Actions, Docker Compose y plantillas de Helm/Ansible— las APIs REST, motores de políticas (OPA) y clientes CLI requieren cargas útiles en formato JSON.
Este convertidor utiliza el esquema seguro de YAML 1.2
(DEFAULT_SCHEMA), resolviendo automáticamente bloques de texto
multilínea (| y >), comentarios, anclas
(&) y alias (*) con detección exacta de fila
y columna ante errores de indentación.
Soporte para flujos multidocumento (---) y protección contra Billion Laughs
En entornos reales de Kubernetes es habitual concatenar múltiples recursos
(por ejemplo, un Deployment y un Service) en un
solo archivo separado por ---. A diferencia de los
convertidores básicos que fallan al encontrar más de un documento:
- Documento único vs. flujo múltiple: Un archivo YAML con un único documento se convierte en un objeto JSON raíz, mientras que un flujo multidocumento se serializa limpiamente como un arreglo JSON de documentos.
-
Seguridad en el cliente: Incluye límites de tamaño
(
512 KB) y conteo máximo de alias para prevenir ataques de expansión exponencial de entidades (YAML Billion Laughs).
Casos de Uso Prácticos en el Mundo Real
-
Conversión de manifiestos de Kubernetes para APIs REST:
Transforme manifiestos YAML multidocumento (
Deployment+Service) en cargas útiles JSON para la API HTTP de Kubernetes o motores de validación como Open Policy Agent (OPA). -
Inspección de anclas (
&) y alias (*) en CI/CD: Expanda configuraciones reutilizadas en flujos de GitHub Actions o Docker Compose hacia JSON explícito para verificar los valores finales resueltos. - Migración de configuraciones JSON a YAML limpio: Convierta respuestas JSON extensas en archivos YAML legibles con claves ordenadas alfabéticamente para revisiones de código en Git junto con nuestro Comparador Semántico JSON.
Ordenación determinista de claves e indentación configurable
Alterne entre indentación de 2 o 4 espacios para
adaptarse a las guías de estilo de su repositorio y compare configuraciones
complejas sin enviar secretos ni variables de entorno a servidores
externos.
Preguntas Frecuentes (FAQ)
¿Soporta este convertidor archivos YAML multidocumento de Kubernetes separados por ---?
Sí. Un archivo YAML de un solo documento se convierte directamente en un objeto JSON raíz, mientras que múltiples documentos separados por --- se serializan como un arreglo JSON.
¿Cómo se procesan las anclas (&), los alias (*) y los errores de indentación en YAML?
El motor YAML 1.2 resuelve automáticamente anclas y alias e informa la línea y columna exactas cuando detecta un error de sintaxis o tabulación.