Die Syntax für Aktionen mit doppelten geschweiften Klammern

Helm-Charts sind kein reines YAML. Sie sind Vorlagen: gewöhnliches YAML mit kleinen Logikstücken, die Helm für Sie ausfüllt. ✨

Jede Template-Direktive steht zwischen zwei geschweiften Klammern. Das Paar {{ }} ist der Übergang von statischem YAML zu Helms Template-Engine.

Alles, was zwischen den Klammern steht, wird als action bezeichnet. Helm wertet sie beim Rendern aus und setzt das Ergebnis wieder in Ihr YAML ein.

Die einfachste Action gibt etwas aus. Hier ersetzt Helm die Action vor der Anwendung des Manifests durch den Release-Namen.

Dieser führende Punkt ist der context: das Objekt der obersten Ebene, das alles enthält, was Helm weiß. Sie navigieren mit weiteren Punkten hinein, etwa .Release.Name.

Leerzeichen innerhalb der Klammern sind reine Stilfrage. {{ .Chart.Name }} und {{.Chart.Name}} werden identisch gerendert. Die Helm-Konvention bevorzugt zur besseren Lesbarkeit die Form mit Leerzeichen.

Eine Action, die einen Wert liefert, ist eine expression-Action. Sie ersetzt Text genau an ihrer Position – ideal für Namen, Tags und Labels.

Andere Actions geben überhaupt nichts aus. Schlüsselwörter wie if und range steuern, was gerendert wird, und entscheiden, ob ein Block erscheint oder wiederholt wird.

Diese gesamte Syntax stammt aus der text/template-Engine von Go. Helm ergänzt sie um weitere Funktionen, aber die Grundlage {{ }} ist reines Go.

Text außerhalb der Klammern wird unverändert durchgereicht. Nur die Actions werden ausgewertet, daher bleibt Ihre YAML-Struktur beim Rendern intakt. 🧱

Führen Sie helm template aus und beobachten Sie, wie jede Action verschwindet und durch ihren berechneten Wert ersetzt wird. Diese Ausgabe entspricht exakt dem, was Kubernetes erreicht.

Sie entdecken {{ .Release.Name }} in einer Chart-Vorlage.

Sie kennen jetzt die grundlegende Syntax: {{ }} markiert eine Action, der Punkt ist der Root-Kontext, und alles außerhalb der Klammern wird unverändert gerendert. 🎯