Programação

O que é YAML?

YAML: o que é, sintaxe (chaves, listas, indentação), exemplos em Docker Compose e CI, diferença para JSON e erros comuns.

Capa: O que é YAML?

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

YAMLJSON
LegibilidadeMais limpaMais verboso
ComentáriosSimNão
DelimitadoresIndentaçãoChaves e colchetes
UsoConfiguraçãoAPIs 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 no ou on interpretados como booleanos; use aspas.

Veja também JSON.

Mais artigos