Przykład błędu wcięcia YAML: spacja typu off-by-one

Ta strona otwiera walidator YAML z fabrycznie załadowaną krótką konfiguracją serwera, która zawiera prawdziwy, częsty błąd: po tym, jak dwa klucze są zagnieżdżone na głębokość czterech spacji, kolejny klucz spada z powrotem na trzy spacje, zamiast powracać na poziom dwóch spacji w otaczającym bloku. YAML nie ma tolerancji wobec tabulatorów i spacji ani stałej szerokości wcięć, więc pojedyncza taka spacja nie jest uśredniana — po prostu nie pasuje do żadnego otwartego bloku i plik jest nieprawidłowy. Poniższa kontrola, która zakończyła się niepowodzeniem, jest uruchamiana w momencie załadowania strony.

Jest to jeden z najczęstszych sposobów, w jaki prawdziwy YAML psuje się w praktyce: ręczna edycja pliku w edytorze, który nie wymusza stałego rozmiaru wcięcia lub wklejenie fragmentu z miejsca o innych odstępach niż otaczający blok. W odróżnieniu od zduplikowanego klucza lub niepotrzebnej karty, wcięcie różniące się o jedno można łatwo przeoczyć, szczególnie w głęboko zagnieżdżonym pliku manifestu Kubernetes lub pliku potoku CI — właśnie dlatego automatyczne sprawdzanie wyłapuje je szybciej niż weryfikator skanujący różnicę.

Zastąp przykładowy tekst własnym plikiem, aby zobaczyć te same raporty w formie wierszy i kolumn zastosowane w Twojej konfiguracji. Kiedy już zrozumiesz wzorzec niepowodzeń, porównaj go z ustawieniem wstępnym yaml-config-example, aby zobaczyć tę samą strukturę ze spójnym wcięciem przechodzącym czysto.