Formatowanie i walidacja YAML

Do czego służy

YAML jest popularny w plikach konfiguracyjnych — manifestach Kubernetes, workflow GitHub Actions i GitLab CI, Docker Compose, playbookach Ansible, dokumentach OpenAPI — bo łatwo go czytać. Łatwo go też zepsuć: złe wcięcie, tabulator, niezamknięty cudzysłów albo brak spacji po dwukropku mogą zmienić znaczenie pliku lub uniemożliwić jego wczytanie.

Ten walidator analizuje twój YAML i zgłasza każdy błąd składni z numerem wiersza i kolumny, a także ostrzeżenia, np. o nieznanych dyrektywach. Gdy YAML jest poprawny, pokazuje liczbę dokumentów i typ wartości głównej każdego z nich oraz może wyświetlić starannie sformatowaną kopię z jednolitym wcięciem.

Jak używać

1. Wklej YAML w pole wejściowe, wgraj plik .yaml lub .yml albo kliknij Przykład.
2. Wynik pojawia się w trakcie pisania: zielona etykieta Poprawny YAML lub lista błędów w rodzaju Wiersz 3, kolumna 2.
3. Zostaw włączone Pokaż sformatowany YAML, aby dostać uporządkowaną kopię, i wybierz wcięcie 2 lub 4 spacje. Skopiuj ją przyciskiem nad blokiem.
4. Wyłączaj Zduplikowane klucze to błąd tylko wtedy, gdy twoje narzędzia dopuszczają powtarzające się klucze.

Typowe błędy

server:
  port: 8080
   host: localhost   # indented one space too far
tags: [web, api      # missing closing bracket

• Niespójne wcięcia: elementy na tym samym poziomie muszą zaczynać się w tej samej kolumnie. YAML nie pozwala na wcięcia tabulatorem.
• Brak spacji po dwukropku: key:value to zwykły ciąg znaków, a nie klucz i wartość.
• Znaki specjalne bez cudzysłowów: wartości zaczynające się od *, &, !, %, @ lub grawisu albo zawierające : lub # wymagają cudzysłowów.
• Nieoczekiwane typy: yes, no, on i off to w YAML 1.2 ciągi znaków, ale w starszych parserach YAML 1.1 wartości logiczne; dla pewności ujmij je w cudzysłowy. Numery wersji, np. 1.10, bez cudzysłowów stają się liczbą 1.1.

Sprawdzanie struktury

To narzędzie sprawdza składnię, czyli czy tekst jest poprawnie zbudowanym YAML-em. Aby sprawdzić, czy plik ma właściwe klucze i typy wartości, przekonwertuj go narzędziem YAML na JSON i zweryfikuj wynik walidatorem JSON Schema.