Validatore YAML
Controlla YAML per individuare errori di sintassi, chiavi duplicate e altri problemi, indicando per ciascuno la riga e la colonna. Funziona nel browser.
Input
Output
Leggimi
Che cosa controlla il validatore YAML?
YAML è il formato di molti file di configurazione: file Docker Compose, manifest Kubernetes, flussi di lavoro di GitHub Actions e GitLab CI, playbook Ansible, specifiche OpenAPI e impostazioni di innumerevoli app. Poiché in YAML l’indentazione ha un significato, uno spazio mancante, un tab fuori posto o una chiave ripetuta possono compromettere un file in modi difficili da individuare. Il validatore legge il tuo YAML come farebbe un parser ed elenca ogni problema con la relativa riga e colonna.
Come si usa
- Incolla o scrivi YAML nell’editor.
- Il risultato appare mentre scrivi: il contenuto YAML è valido, con il numero di documenti che contiene, oppure tutti i problemi vengono elencati nell’ordine in cui compaiono nel testo.
- Ogni problema è evidenziato nell’editor: gli errori in rosso e gli avvisi in giallo. Fai clic su un problema per scorrere fino al punto corrispondente nell’editor, oppure fai clic su un’evidenziazione per trovarlo nell’elenco.
Che cosa rileva
- Errori di sintassi: virgolette e parentesi non chiuse, elementi con un’indentazione insufficiente o eccessiva, una chiave e un elemento di elenco allo stesso livello, mappe annidate su una sola riga come
a: b: c. - Chiavi ripetute: la stessa chiave due volte nella stessa mappa. La maggior parte dei parser manterrebbe una sola delle due voci senza segnalarlo, facendo perdere l’altra impostazione.
- Tab usati per l’indentazione: YAML consente di usare solo spazi per l’indentazione.
- Alias senza ancore: un alias
*namerichiede un’ancora&nameprecedente nello stesso documento. - Avvisi per elementi che vengono analizzati ma potrebbero non funzionare come previsto, ad esempio un tag sconosciuto al parser o una versione
%YAMLnon supportata.
La stessa chiave in mappe diverse è consentita, così come un file con più documenti separati da ---: le righe vengono conteggiate nell’intero file.
Che cosa non controlla
Il validatore controlla che il testo sia YAML valido, non che un programma specifico lo accetti. Un file Docker Compose può essere YAML valido e contenere comunque un’impostazione che Docker Compose non riconosce. I messaggi provengono dalla libreria yaml e sono in inglese.
Come funziona
Lo strumento analizza il testo con la libreria yaml, che segue la specifica YAML 1.2 e richiede che le chiavi siano univoche. Tutto viene eseguito nel tuo browser: i tuoi file non vengono mai caricati.
Funzionalità
- Errori di sintassi con riga e colonna
- Chiavi ripetute, tab usati per l’indentazione e alias senza ancore
- Errori e avvisi evidenziati nell’editor, con possibilità di fare clic per scorrere fino al punto corrispondente
- File con più documenti
- Esecuzione nel browser