Lição 4
Erros comuns em YAML
Indentação, tabs, tipagem e erros de colagem que quebram configs.
Falhas em YAML raramente são misteriosas quando você conhece os suspeitos habituais.
Tabs vs espaços
Muitos guias de estilo proíbem tabs na indentação. Misturar tabs e espaços parece alinhado em alguns editores, mas quebra parsers. Configure o editor para inserir espaços em YAML.
Nível de indentação errado por um
Adicionar uma chave um espaço à esquerda demais a prende ao pai errado. No Kubernetes, isso pode mover containers para fora de spec na sua cabeça — mas não para o parser.
Escalares especiais sem aspas
YAML interpreta valores como yes, no, on, off e 12345 com regras de tipagem. Quando você quer string, coloque entre aspas:
version: "01.10"
enabled: "yes"
Coleções flow quebradas
Iniciar sequências [ ou { sem fechamento correspondente produz erros no fim do arquivo. Geradores de CI às vezes emitem YAML flow meio válido — valide após colar.
Vários documentos em uma colagem
Arquivos separados por --- são YAML multi-documento válido, mas algumas ferramentas esperam um único documento. Mesclar dois manifests sem entender os limites gera erros confusos.
Conversão dupla
JSON → YAML → edição manual → JSON pode introduzir chaves duplicadas ou tipos alterados se ferramentas intermediárias reordenam ou normalizam valores. Faça diff após cada passo de conversão.