Wejscie YAML

Wynik walidacji

Czym jest Walidator YAML?

YAML (YAML Ain't Markup Language) jest uzywany do plikow konfiguracyjnych w Kubernetes, Docker Compose, GitHub Actions i wielu innych narzedzi. W przeciwienstwie do JSON, YAML uzywa wciecia do struktury — bez nawiasow klamrowych. To sprawia, ze jest czytelny, ale tez kruchy: bledne spacje, tabulatory zamiast spacji lub niespojne zagniezdzenie powoduja bledy parsowania. Specyfikacja YAML 1.2 definiuje reguly.

Walidator YAML sprawdza, czy Twoj dokument jest prawidlowy. Parsuje YAML i raportuje bledy skladniowe z numerem wiersza i pozycja. To narzedzie dziala calkowicie w przegladarce. Nic nie jest wysylane na serwer, wiec jest bezpieczne do uzycia z konfiguracjami produkcyjnymi, sekretami lub wrazliwymi danymi.

Przyklady walidacji YAML

Prawidlowy YAML uzywa spojnego wciecia. Nieprawidlowy YAML czesto ma bledne zagniezdzenie. Przyklady z motywem telekomunikacyjnym:

Przyklad 1: Prawidlowy YAML

Prawidlowy

Przyklad 2: Nieprawidlowy YAML (bledne wciecie)

Nieprawidlowy

Walidator raportuje blad. Uzyj Przykladу prawidlowego lub Przykladu nieprawidlowego powyzej, aby zaladowac przyklady do edytora.

Jak uzywac tego narzedzia

1

Wklej lub wczytaj YAML

Skopiuj swoj YAML i wklej go do lewego edytora. Mozesz tez kliknac Wczytaj, aby zaladowac plik .yaml lub .yml z komputera. Uzyj Przykladu prawidlowego dla poprawnego YAML lub Przykladu nieprawidlowego, aby zobaczyc jak wygladaja bledy.

2

Sprawdz wynik walidacji

Prawy panel pokazuje Prawidlowy lub Nieprawidlowy. Jesli nieprawidlowy, wyswietla bledy z numerem wiersza i pozycja, dzieki czemu mozna wskazac problem. Czeste problemy to bledne wciecie, tabulatory zamiast spacji, niespojne zagniezdzenie, znaki specjalne bez cudzysowow lub nieprawidlowe ciagi wielowierszowe.

3

Popraw i ponownie zwaliduj

Popraw bledy we wejsciu i ponownie zwaliduj. Do formatowania i wciecia uzyj Formatera YAML. Do konwersji do JSON lub innych formatow uzyj YAML do JSON lub YAML do XML.

Kiedy walidacja YAML pomaga

Wiekszosci deweloperow potrzeba walidacji podczas pracy z manifestami Kubernetes, plikami Docker Compose lub konfiguracjami CI/CD jak GitHub Actions. Jedna dodatkowa spacja lub tabulator moze przerwac wdrozenie. Przepuszczenie konfiguracji tutaj wykrywa bledy skladniowe przed wypchnieciem.

Pliki konfiguracyjne jak application.yml (Spring Boot) lub .gitlab-ci.yml czesto maja gleboke zagniezdzenie. Walidator pomaga znalezc dokladny wiersz, gdzie wciecie idzie zle. Aby przekonwertowac YAML do JSON lub XML, uzyj YAML do JSON lub YAML do XML.

Jesli edytujesz YAML w edytorze bez dobrej walidacji, to narzedzie daje natychmiastowe informacje zwrotne. Jest tez przydatne przed udostepnianiem konfiguracji wspolpracownikom — walidacja najpierw zapewnia, ze wszyscy otrzymaja prawidlowy plik.

Czesto zadawane pytania

Co sprawia, że YAML jest nieprawidłowy?

Nieprawidłowe wcięcia (tabulatory zamiast spacji), niespójne zagnieżdżanie, znaki specjalne bez cudzysłowów jak : lub # w wartościach, nieprawidłowe ciągi wieloliniowe lub zduplikowane klucze. Walidator wskazuje problem z numerem linii i pozycją.

Tabulatory vs spacje?

YAML wymaga spacji do wcięć. Tabulatory nie są dozwolone. Mieszanie tabulatorów i spacji powoduje błędy. Używaj konsekwentnie 2 lub 4 spacji w całym pliku.

Czy moje dane są gdzieś wysyłane?

Nie. Walidacja działa całkowicie w przeglądarce przy użyciu JavaScript. Żadne dane nie są wysyłane na serwer. Możesz to potwierdzić, otwierając kartę Sieć w przeglądarce podczas korzystania z narzędzia.

Co z kotwicami i aliasami YAML?

Kotwice (&nazwa) i aliasy (*nazwa) są obsługiwane. Walidator sprawdza, czy są używane poprawnie. Odwołania cykliczne spowodują niepowodzenie walidacji.

Czy sprawdza schemat, czy tylko składnię?

To narzędzie waliduje tylko składnię—czy YAML jest poprawnie sformułowany i można go przetworzyć. Nie waliduje względem schematu JSON ani Kubernetes. Do walidacji struktury przekonwertuj do JSON i użyj Generatora schematu JSON.

Powiazane narzedzia

Specyfikacja YAML. Szybkie wprowadzenie do YAML. Specyfikacja JSON. MDN. Konfiguracja Kubernetes. YAML. JSON Schema.