Format Atlas

Guías

Elegir un formato de configuración

Comprueba primero qué formatos acepta la herramienta. Si admite varios, elige uno que el equipo pueda validar y mantener con seguridad.

¿Qué formato deberías elegir?

Elige según la función de cada archivo en tu flujo de trabajo.

  • API e intercambio de datos web → JSON
  • Configuración jerárquica legible → YAML
  • Configuración de claves y valores → TOML
  • La herramienta exige uno → seguir su especificación

Prioriza la compatibilidad de herramientas

El formato depende de la aplicación, biblioteca, sistema CI y alojamiento. Comprueba los formatos y versiones de especificación admitidos.

Automatiza la validación de sintaxis

JSON, YAML y TOML pueden fallar por errores de sintaxis o tipos. Valida al guardar o en CI y evita guardar credenciales en archivos de configuración del repositorio.

Formatos a considerar

JSON

Adecuado para: API o ajustes que aceptan JSON

Menos adecuado para: Configuración manual que necesita comentarios

YAML

Adecuado para: Configuración jerárquica mantenida por personas

Menos adecuado para: Intercambio sencillo donde preocupan errores de sangría

TOML

Adecuado para: Configuración organizada en claves y valores

Menos adecuado para: Herramientas que exigen JSON o YAML

Antes de exportar

  • Comprueba formato y versión admitidos por la herramienta.
  • No guardes credenciales ni claves privadas en el repositorio.

Comparaciones relacionadas

JSON vs TOMLJSON se usa ampliamente en API e intercambio de datos entre programas. TOML está pensado para configuración de aplicaciones editada por personas, con claves, valores, tablas y listas legibles.YAML vs TOMLYAML y TOML son formatos de texto usados para configuración editada por personas. YAML admite jerarquías flexibles; TOML prioriza ajustes explícitos y legibles mediante claves y tablas. Elige según la herramienta y la estructura.JSON vs YAMLJSON es un formato de texto estricto muy usado en API e intercambio de datos entre programas. YAML ofrece una sintaxis adecuada para configuración y datos estructurados editados por personas. Elige según el ecosistema y el flujo.YAML vs XMLYAML y XML representan datos estructurados. YAML suele resultar práctico en configuraciones mantenidas por personas; XML es habitual en integraciones que dependen de elementos, atributos, esquemas o espacios de nombres.

Guías

Elegir un formato de intercambio de datosEmpieza por las especificaciones del receptor. Usa JSON para datos estructurados de API, XML si la integración exige su esquema y CSV para una sola tabla.Elegir formatos de datos y configuración webConsidera JSON para intercambios entre máquinas como API, YAML para configuración editada por personas y XML para integraciones existentes basadas en esquemas.Dónde guardar la configuración y los secretosSepara la configuración común de las credenciales y elige dónde guardarlas en desarrollo local, CI y producción según quién necesite acceder a ellas.

Referencias y especificaciones