Formattatore YAML
Perché formattare i file YAML?
Lo YAML è estremamente sensibile al rientro — un singolo spazio in più può causare errori di parsing o corruzione silente dei dati. Strumenti come Kubernetes, Docker Compose, GitHub Actions e Ansible usano file di configurazione YAML dove gli errori di formattazione possono bloccare interi deployment. Il nostro formattatore valida la sintassi, normalizza il rientro e garantisce che il tuo YAML sia sempre corretto.
Normalizzazione del rientro
Normalizza i rientri misti in un formato consistente a 2 spazi nell'intero documento
Validazione della sintassi
Individua errori di rientro, mix di tab/spazi e problemi strutturali prima di errori in produzione
Ancore e alias
Supporto completo per le ancore (&) e gli alias (*) di YAML per il riutilizzo dei documenti e configurazioni DRY
Come formattare YAML in 3 passi
Incolla il tuo YAML
Incolla il tuo manifesto Kubernetes, il workflow di GitHub Actions o qualsiasi file di configurazione YAML
Formatta e valida
Lo strumento valida la sintassi e riformatta automaticamente con rientro consistente
Copia e distribuisci
Copia lo YAML formattato nel tuo file, pipeline CI o strumento di deployment
Casi d'uso della formattazione YAML
Manifest Kubernetes
Formatta i file YAML di Deployment, Service e ConfigMap prima di applicarli a un cluster
Pipeline CI/CD
Valida i workflow di GitHub Actions, GitLab CI e CircleCI per evitare errori nella pipeline
Playbook Ansible
Formatta e valida task, variabili e inventari di Ansible per codice infrastruttura pulito
Docker Compose
Assicurati che i file docker-compose.yml siano formattati correttamente prima di eseguire docker compose up
Best practice YAML
✓ Usa gli spazi, mai i tab
YAML vieta rigorosamente i caratteri tab per il rientro. Configura sempre il tuo editor per inserire spazi quando premi Tab nei file YAML.
✓ Usa le virgolette per i caratteri speciali
Le stringhe con : # [ ] { } o che iniziano con caratteri speciali devono essere racchiuse tra virgolette per evitare che YAML le interpreti erroneamente.
✓ Usa le ancore per ridurre le duplicazioni
Le ancore YAML (&nome) e gli alias (*nome) permettono di riutilizzare valori in un documento, riducendo la ripetizione nelle configurazioni complesse.
✓ Esegui il lint prima del commit
Esegui yamllint o usa questo formattatore nel tuo hook pre-commit per individuare i problemi di formattazione prima che raggiungano il repository.
❓ Domande frequenti
Perché YAML fallisce con i tab invece degli spazi?
La specifica YAML vieta esplicitamente i caratteri tab per il rientro, poiché editor diversi visualizzano i tab con larghezze diverse. Gli spazi forniscono un rientro coerente e inequivocabile che tutti i parser YAML possono interpretare in modo identico.
Cosa fanno le ancore (&) e gli alias (*) in YAML?
Le ancore definiscono un blocco riutilizzabile con &nome-ancora: e gli alias lo referenziano con *nome-ancora. Questo ti permette di definire valori una volta e riutilizzarli più volte, mantenendo le configurazioni DRY.
Qual è la differenza tra YAML e JSON?
YAML è un superset di JSON — ogni JSON valido è anche YAML valido. YAML aggiunge supporto per commenti, ancore, stringhe multiriga e una sintassi più leggibile. JSON è migliore per lo scambio di dati tra macchine; YAML è più adatto per la configurazione modificata dagli esseri umani.
Perché scegliere YAML invece di TOML per la configurazione?
YAML ha un supporto di strumenti più ampio (Kubernetes, Ansible, la maggior parte dei sistemi CI) e può rappresentare strutture annidate complesse in modo conciso. TOML è più semplice e meno soggetto a errori per configurazioni di base. Per la configurazione DevOps, YAML è lo standard.