Fluxo de depuração YAML

Quando kubectl, Actions ou Compose rejeita um arquivo, use um fluxo repetível em vez de edições aleatórias.

Passo 1: Capture os bytes exatos do arquivo

Copie o arquivo com falha do git — não screenshot, não trecho do Slack com aspas “inteligentes” alteradas. Caracteres invisíveis causam correções falsas.

Passo 2: Valide sem mutar

Rode primeiro o modo só validação. Você quer feedback do parser no texto atual, não numa variante auto-formatada que esconde o erro original.

Passo 3: Vá para linha e coluna

Mensagens como "line 18, column 3" apontam para um indent ou token específico. Corrija aquele ponto antes de reformatar o arquivo inteiro.

Passo 4: Formate e revise o diff

Com a sintaxe válida, formate com o padrão de indent da equipe. Leia o diff — formatação não deve mudar significado, só whitespace e opcionalmente ordem de chaves.

Passo 5: Round-trip JSON quando travar

Se o YAML veio de ferramentas JSON, converta YAML → JSON → YAML para expor surpresas estruturais. Se o JSON estiver errado, corrija o modelo de dados antes de debater indentação.

Passo 6: Reexecute a ferramenta original

Aplique com kubectl dry-run, rode o workflow de novo ou docker compose config — validadores de domínio pegam o que parsers não veem (campos desconhecidos, versões de API erradas).

Lembrete de segurança

Nunca cole segredos de produção em links compartilhados de formatador. Use amostras redigidas ao colaborar.