Príklad chyby odsadenia YAML: Medzera Off-by-One

Táto stránka otvorí validátor YAML s predinštalovanou krátkou konfiguráciou servera, ktorá obsahuje skutočnú, bežnú chybu: po dvoch kľúčoch vnorených štyri medzery sa nasledujúci kľúč vráti späť na tri medzery namiesto toho, aby sa vrátil na dvojmiestnu úroveň uzatváracieho bloku. YAML nemá toleranciu medzi tabulátormi a medzerami a žiadnu pevnú šírku odsadenia, takže jedna zatúlaná medzera, ako je táto, nie je priemerná – jednoducho nezodpovedá žiadnemu otvorenému bloku a súbor je neplatný. Kontrola zlyhania nižšie sa spustí v momente načítania stránky.

Toto je jeden z najbežnejších spôsobov, ako sa skutočný YAML v praxi zlomí: ručná úprava súboru v editore, ktorý nevynucuje konzistentnú veľkosť odsadenia, alebo prilepenie fragmentu odniekiaľ s iným rozostupom, ako má okolitý blok. Na rozdiel od duplicitného kľúča alebo zatúlaného tabulátora je možné prehliadku odsadenia po jednom ľahko prehliadnuť, najmä v hlboko vnorenom súbore manifestu Kubernetes alebo CI pipeline – čo je presne dôvod, prečo ho automatizovaná kontrola zachytí rýchlejšie ako ľudský recenzent skenujúci rozdiel.

Nahraďte vzorový text vlastným súborom, aby ste videli rovnaký riadkový a stĺpcový prehľad použitý vo vašej konfigurácii. Keď pochopíte vzorec zlyhania, porovnajte ho s prednastavením príkladu yaml-config, aby ste videli rovnakú štruktúru s konzistentným čistým prechodom odsadenia.