Typowe pułapki wcięć YAML

W YAML-u spacje nie są ozdobnikiem. Samo wcięcie decyduje o tym, co zostanie zagnieżdżone pod czym, więc jedna spacja w niewłaściwym miejscu może zmienić strukturę całego manifestu. 😬

Gdy akcja wstawia wartość lub blok, tekst trafia do kolumny, w której znajduje się akcja. Błędne oszacowanie tego miejsca powoduje uszkodzenie wyrenderowanego YAML-a.

YAML bezwzględnie zabrania używania tabulatorów do wcięć. Pojedynczy tabulator prowadzi do mylącego błędu analizy składni, dlatego edytor należy skonfigurować tak, aby wstawiał spacje.

Wstawienie wielowierszowej wartości do drzewa nie powoduje jej automatycznego wyrównania. Za pomocą funkcji indent należy dodać odpowiednią liczbę spacji na początku wierszy.

Liczba podana po indent określa, ile spacji należy dodać przed każdym wierszem wartości. Należy dopasować ją do poziomu, na którym ma znaleźć się blok.

Częsty błąd polega na tym, że indent nie dodaje początkowego znaku nowej linii, więc pierwszy wiersz zostaje sklejony z kluczem YAML. To po cichu niszczy dokument.

W większości chartów używa się zamiast tego funkcji nindent. Najpierw dodaje ona początkowy znak nowej linii, a następnie stosuje wcięcie, dzięki czemu blok zaczyna się poprawnie w osobnym wierszu.

Spacje przed {{ w źródle wpływają na wiersz, w którym akcja wypisze wynik. Akcje sterujące należy umieszczać na poziomie odpowiadającym miejscu, które ma zajmować ich wynik.

Gdy wartość szablonowa staje się listą, każdy element wymaga myślnika na właściwym poziomie wcięcia. Połączenie toYaml z nindent zwykle obsługuje to poprawnie.

Błędy wcięć są niewidoczne w źródle, ale oczywiste w wyniku. Należy wyrenderować chart i przejrzeć surowy YAML, aby szybko znaleźć nieprawidłowo wyrównane bloki. 👀

Uruchomienie helm lint pozwala wykryć wiele problemów z YAML-em i wcięciami, zanim chart zostanie zainstalowany w klastrze.

Wstawiany blok wciąż zostaje sklejony z kluczem YAML znajdującym się nad nim.

Można już unikać klasycznych pułapek: nie używać tabulatorów, stosować nindent do poprawnego wstawiania bloków oraz zawsze renderować lub sprawdzać YAML za pomocą lint. 🎯