YAML ("YAML Ain't Markup Language") é um formato de dados legível por humanos, muito usado em arquivos de configuração: Docker Compose, Kubernetes, GitHub Actions e Ansible.
Sintaxe
- A estrutura é dada pela indentação com espaços (nunca tabs).
- Pares
chave: valor. - Listas com hífen.
- Comentários com
#.
# configuração de exemplo
nome: loja
versao: 1.2
ativo: true
portas:
- 80
- 443
banco:
host: localhost
porta: 3306
Exemplo: Docker Compose
services:
web:
image: nginx:stable
ports:
- "8080:80"
YAML x JSON
| YAML | JSON | |
|---|---|---|
| Legibilidade | Mais limpa | Mais verboso |
| Comentários | Sim | Não |
| Delimitadores | Indentação | Chaves e colchetes |
| Uso | Configuração | APIs e troca de dados |
O YAML é um superconjunto prático do JSON: um JSON válido é, em geral, YAML válido.
Erros comuns
- Misturar tabs e espaços.
- Indentação inconsistente.
- Textos com
:sem aspas. - Valores como
noouoninterpretados como booleanos; use aspas.
Veja também JSON.
