Ako zachovať prísnu integritu odsadenia pri preklade YAML konfiguračných súborov (napríklad dokumentácie Kubernetes/Ansible)?

Diagnostika aktuálneho stavu

“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

1

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.

2

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é.

3

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.