Transforma JSON em YAML baseado em indentação. As chaves e a maior parte das aspas somem, o que deixa o resultado mais fácil de manter à mão como arquivo de configuração, e a ordem das chaves fica exatamente como no JSON de origem.
Ajuda quando você leva para um manifest um recurso obtido com kubectl get -o json, ou cola configurações recebidas de uma API num docker-compose.yml, num application.yml ou num workflow do GitHub Actions.
JSON. Sintaxe inválida mostra JSON parsing failed no resultado; se precisar, passe antes pelo validador de JSON.Resultado. A indentação é de dois espaços.{
"services": {
"web": {
"image": "nginx:1.27",
"ports": ["8080:80"],
"environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
}
}
}services:
web:
image: nginx:1.27
ports:
- 8080:80
environment:
FEATURE_FLAG: "on"
GREETING: |-
hello
world
A string "on" mantém as aspas: escrita sem aspas como on, um parser YAML 1.1 a leria como o booleano true. GREETING tem uma quebra de linha, então é emitido como um bloco |- que mostra cada linha como foi escrita.
yes, no, on, off, y, n, ~, null e parecidas como "0777", "1.0" ou "2024-01-01" ficam entre aspas para que o PyYAML (1.1) e os parsers 1.2 modernos leiam o mesmo valor.22:22, que o YAML 1.1 pode ler como número em base 60, também ficam entre aspas, evitando um bug clássico de mapeamento de portas no docker-compose.|-.[] e {}.Converta um Deployment ou ConfigMap puxado do cluster como JSON, apague campos como status e metadata.uid, e você tem um manifest pronto para o Git.
Um bloco de propriedades recebido como JSON de um config server ou da documentação vira uma hierarquia YAML, sem você precisar indentar à mão chaves como spring.datasource.url.
&) nem aliases (*); um objeto repetido no JSON se repete no YAML.---, converta cada recurso e junte você mesmo.As aspas só são adicionadas onde um valor sem aspas seria lido como outro tipo. nginx:1.27 é string de qualquer jeito, mas on, 010 e 22:22 viram booleanos ou números em alguns parsers, então ganham aspas.
A estrutura é válida como está. Mas a saída de kubectl get -o json traz campos preenchidos pelo servidor, como status, resourceVersion e managedFields, que é melhor remover antes de aplicar.
Não há opção; é fixo em dois espaços, a convenção usada em toda a documentação do Kubernetes, do docker-compose e do GitHub Actions.