Primer napake pri zamiku YAML: presledek drug za drugim

Ta stran odpre validator YAML s prednaloženo kratko konfiguracijo strežnika, ki vsebuje resnično, pogosto napako: po tem, ko sta dva ključa ugnezdena štiri presledke globoko, naslednji ključ pade nazaj na tri presledke, namesto da bi se vrnil na raven dveh presledkov obdajajočega bloka. YAML nima tolerance med tabulatorji in presledki in nima fiksne širine zamika, zato en sam potepuški prostor, kot je ta, ne doseže povprečja - preprosto se ne ujema z nobenim odprtim blokom in datoteka je neveljavna. Spodnje neuspešno preverjanje se izvede v trenutku, ko se stran naloži.

To je eden najpogostejših načinov, kako se pravi YAML pokvari v praksi: ročno urejanje datoteke v urejevalniku, ki ne uveljavlja dosledne velikosti zamika, ali lepljenje fragmenta od nekod z drugačnim razmikom kot okoliški blok. Za razliko od podvojenega ključa ali potepuškega zavihka je listek z zamikom, ki se razlikuje od enega, enostavno zgrešiti z očesom, zlasti v globoko ugnezdenem manifestu Kubernetes ali datoteki cevovoda CI – ravno zaradi tega ga samodejno preverjanje ujame hitreje kot človeški pregledovalec, ki skenira razliko.

Zamenjajte vzorčno besedilo s svojo lastno datoteko, da vidite isto poročanje v vrsticah in stolpcih, uporabljeno za vašo konfiguracijo. Ko tukaj razumete vzorec napake, ga primerjajte s prednastavitvijo yaml-config-example, da vidite isto strukturo z doslednim zamikom, ki poteka čisto.