Converte um documento YAML (yml) em JSON para você ver a estrutura que a indentação esconde e o tipo real com que cada valor foi lido. Anchors e aliases são expandidos em valores reais, e vários documentos separados por --- são reunidos num array.
É especialmente útil para pegar erros clássicos de YAML: um valor preso ao pai errado por causa de um espaço a menos, ou version: 1.10 virando silenciosamente o número 1.1.
YAML, ou solte o arquivo nela.Resultado para ver se cada valor virou string, número ou booleano, e copie se precisar.name: ci
on:
push:
branches: [main]
defaults: &node
runs-on: ubuntu-latest
timeout-minutes: 10
jobs:
test: *node
{
"name": "ci",
"on": {
"push": {
"branches": [
"main"
]
}
},
"defaults": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
},
"jobs": {
"test": {
"runs-on": "ubuntu-latest",
"timeout-minutes": 10
}
}
}A chave on: do GitHub Actions continua sendo a chave string "on", porque esta ferramenta faz o parse com as regras do YAML 1.2. O bloco definido com o anchor &node é expandido no lugar de *node.
yes, on e off continuam strings, e só true/True/false viram booleanos.~ e valores vazios viram null; hexadecimal 0x1F e octal 0o17 viram números.&anchors e *aliases são resolvidos para os valores referenciados.| e dobrados > viram strings com as regras de quebra de linha do YAML aplicadas.--- viram um array JSON; um documento único sai como o seu próprio valor.Se o env dentro de containers está indentado um nível a menos, ele se prende silenciosamente a outro campo e você só descobre na hora do apply. Em JSON, as chaves mostram exatamente a qual objeto ele pertence.
Para um script ou um bundle front-end em que adicionar um parser YAML é exagero, converta a configuração uma vez e use como import config from './config.json'.
Um documento OpenAPI escrito em YAML fica mais fácil de consultar com JSONPath ou jq depois de convertido, por exemplo para extrair o schema de um path específico.
<<: *defaults) são aplicadas: as chaves do mapping com anchor são copiadas, e as chaves escritas ao lado do << as sobrescrevem. Um parser só YAML 1.2 manteria << como chave comum, então os resultados podem diferir dessas ferramentas.2024-01-01 continuam strings em vez de virarem valores Date..inf e .nan não têm representação em JSON e viram null.on e yes como true, então resultados vindos do Python podem diferir.on do GitHub Actions aparece como "on" e não como true?No YAML 1.2, os únicos booleanos são true e false, então on é uma string comum, que é também como o GitHub Actions lê a chave. O PyYAML do Python segue o 1.1 e a transforma numa chave True, então tome cuidado ao fazer parse de workflows em scripts.
version: 1.10 sai como 1.1.1.10 sem aspas é um número em YAML, e 1.10 é igual a 1.1. Para manter uma string de versão, coloque aspas no YAML de origem: "1.10".
Cada documento separado por --- vira um elemento do array, em ordem, então um arquivo com vários recursos usado com kubectl apply -f gera um array de recursos.