Ako zachovať prísnu integritu odsadenia pri preklade YAML konfiguračných súborov (napríklad dokumentácie Kubernetes/Ansible)?
“YAML je závislý od odsadenia (medzier) na vyjadrenie úrovní; akákoľvek chyba v odsadení spôsobí zlyhanie analýzy súboru.”
Analýza základných príčin
Prísna ochrana ukotvenia medzier
Neprekladáme len text, ale zaznamenávame aj počet medzier pred každým riadkom. Po dokončení prekladu systém povinne vkladá preklad do príslušnej úrovne odsadenia, čím zabezpečuje 100 % správnu štruktúru syntaktického stromu YAML.
Preklad a zachovanie komentárov
Komentáre v konfiguračných súboroch (obsah za znakom #) sú kľúčové pre pochopenie konfigurácie. Používateľ si môže zvoliť preklad týchto komentárov na lepšie porozumenie tímom, pričom hodnoty konfiguračných kľúčov (Key) ostávajú nezmenené.
Podpora viacerých prúdov dokumentov
Pri YAML súbore, ktorý obsahuje viacero dokumentov (oddelených `---`), systém rozpozná oddeľovače a jednotlivé bloky spracuje samostatne, čím nedochádza k zámene obsahu rôznych modulov.
Zhrnutie konečného riešenia
Lokalizácia technickej konfiguračnej dokumentácie už nie je DevOps nočnou morou a zabezpečuje celosvetovú použiteľnosť nasadzovacích skriptov.