Příklad chyby odsazení YAML: Mezera Off-by-One

Tato stránka otevře validátor YAML předem načtený s krátkou konfigurací serveru, která obsahuje skutečnou, běžnou chybu: po dvou klíčích vnořených do čtyř mezer se následující klíč vrátí zpět na tři mezery místo toho, aby se vrátil na dvoumístnou úroveň uzavíracího bloku. YAML nemá žádnou toleranci mezi tabulátory a mezerami a žádnou pevnou šířku odsazení, takže jediná zbloudilá mezera, jako je tato, není průměrná – jednoduše neodpovídá žádnému otevřenému bloku a soubor je neplatný. Níže uvedená kontrola selhání se spustí v okamžiku načtení stránky.

Toto je jeden z nejběžnějších způsobů, jak se skutečný YAML v praxi zlomí: ruční úprava souboru v editoru, který nevynucuje konzistentní velikost odsazení, nebo vložení fragmentu odněkud s jiným rozestupem, než má okolní blok. Na rozdíl od duplicitního klíče nebo zbloudilého tabulátoru lze jednotlivé odsazení snadno přehlédnout, a to zejména v hluboce vnořeném souboru manifestu Kubernetes nebo souboru kanálu CI – což je přesně důvod, proč jej automatická kontrola zachytí rychleji než lidský recenzent skenující rozdíl.

Nahraďte ukázkový text svým vlastním souborem, abyste viděli stejné řádkové a sloupcové hlášení použité ve vaší konfiguraci. Jakmile porozumíte zde uvedenému vzorci selhání, porovnejte jej s přednastavením yaml-config-example, abyste viděli stejnou strukturu s konzistentním čistým odsazením.