Składnia akcji z podwójnymi klamrami

Wykresy Helm nie są zwykłymi plikami YAML. Są szablonami: zwykłym YAML z niewielkimi fragmentami logiki, które Helm uzupełnia za Ciebie. ✨

Każda dyrektywa szablonu znajduje się między dwiema klamrami. Para {{ }} to przejście od statycznego YAML do mechanizmu szablonów Helm.

Wszystko, co znajduje się między klamrami, nazywa się akcją. Helm oblicza ją podczas renderowania i wstawia wynik z powrotem do YAML.

Najprostsza akcja po prostu coś wyświetla. W tym przypadku Helm zastępuje akcję nazwą wydania, zanim manifest zostanie zastosowany.

Początkowa kropka to kontekst: obiekt najwyższego poziomu zawierający wszystkie informacje znane Helmowi. Można zagłębiać się w niego za pomocą kolejnych kropek, na przykład .Release.Name.

Spacje wewnątrz klamer są tylko kwestią stylu. {{ .Chart.Name }} i {{.Chart.Name}} renderują się tak samo. Konwencja Helm preferuje formę ze spacjami ze względu na czytelność.

Akcja zwracająca wartość jest akcją typu wyrażenie. Podstawia tekst dokładnie w miejscu swojego wystąpienia, co doskonale sprawdza się w przypadku nazw, tagów i etykiet.

Inne akcje niczego nie wyświetlają. Słowa kluczowe takie jak if i range sterują tym, co zostanie wyrenderowane, decydując, czy blok się pojawi lub powtórzy.

Cała ta składnia pochodzi z mechanizmu text/template języka Go. Helm dodaje do niego własne funkcje, ale podstawa {{ }} pochodzi bezpośrednio z Go.

Tekst znajdujący się poza klamrami jest przekazywany bez zmian. Obliczane są tylko akcje, dzięki czemu struktura YAML pozostaje nienaruszona po renderowaniu. 🧱

Uruchom helm template i obserwuj, jak każda akcja znika, zastąpiona obliczoną wartością. Ten wynik jest dokładnie tym, co trafia do Kubernetes.

W szablonie wykresu widzisz {{ .Release.Name }}.

Znasz już podstawową składnię: {{ }} oznacza akcję, kropka wskazuje główny kontekst, a wszystko poza klamrami jest renderowane bez zmian. 🎯