Guia completo: Como validar e formatar arquivos YAML com segurança
O YAML (YAML Ain't Markup Language) é um formato de serialização de dados amplamente utilizado em arquivos de configuração de microsserviços, pipelines de CI/CD (GitHub Actions, GitLab CI), Kubernetes e Docker Compose.
1. Principais regras de sintaxe do padrão YAML
- Indentação por Espaços: O YAML proíbe estritamente o uso de tabulações (Tab) para indentar blocos. Use 2 espaços por nível.
- Pares Chave-Valor: A chave deve ser seguida de dois pontos e um espaço obrigatório antes do valor.
- Listas e Sequências: Elementos de lista iniciam com hífen seguido de espaço.
- Tipagem Automática: Valores como true/false, números e strings são tipados automaticamente pelo parser.
Como usar esta ferramenta
- Cole o YAML ou envie um arquivo .yaml/.yml.
- Escolha o perfil de regras: Default (mais rígido) ou Relaxed (mais tolerante).
- Veja a lista de problemas com linha, coluna e a regra violada.
Perguntas Frequentes (FAQ)
- O YAML é enviado para algum servidor?
- Não. Toda a validação acontece no seu navegador; nada é enviado ou armazenado.
- Quais regras de estilo são checadas?
- As mesmas que o yamllint habilita por padrão: indentação, chaves duplicadas, espaçamento em : e -, comentários, linhas muito longas, espaços no fim da linha e mais.
- Qual a diferença entre os perfis default e relaxed?
- O relaxed desliga as regras document-start, comments, comments-indentation e line-length, ficando mais tolerante com YAMLs informais.
