2026-05-19 · 1 min de leitura
YAML e JSON para arquivos de configuração
Escolha o formato que seu runtime lê; converta só quando controla ambos os lados.
YAMLJSONconfiguração
Pontos principais
- Comentários e âncoras YAML não sobrevivem a ida e volta JSON cega.
- Valide JSON após converter antes de commitar na main.
Escolhendo um formato
YAML vence para configs editadas à mão com comentários; JSON para parsers estritos e artefatos gerados.
Converta nos limites do repositório (YAML humano → JSON máquina), não a cada save local.
Fluxo de conversão seguro
Cole em YAML ⇄ JSON, inspecione o diff, depois execute JSON Validator no resultado.
Se o JSON for documento OpenAPI, siga com OpenAPI Validator.
Perguntas frequentes
A conversão muda números ou booleanos?
Sim — aspas e tipos importam. Faça diff da saída e execute o parser da app em CI.
Kubernetes usa YAML — devo armazenar JSON?
Mantenha YAML no git para humanos; gere JSON só se ferramenta downstream exigir.