tpl: strings uit values renderen

Soms bevat een waarde in values.yaml zelf sjabloonsyntaxis. Standaard behandelt Helm deze als een gewone tekenreeks en evalueert deze nooit.

De functie tpl neemt een tekenreeks en een context en verwerkt die tekenreeks als een Go-sjabloon op de plek waar je de functie aanroept.

Het tweede argument van tpl is het bereik dat tijdens het verwerken wordt gebruikt. Als je de hoofddot doorgeeft, kan de tekenreeks Values en Release bereiken.

Een gebruiker kan nu een dynamische tekenreeks in values opslaan, bijvoorbeeld een hostnaam die uit de releasenaam wordt opgebouwd, en deze tijdens het verwerken laten uitbreiden.

Geef dat veld in je sjabloon met de hoofdcontext door aan tpl om de opgeslagen tijdelijke aanduiding in een echte waarde om te zetten.

Een rechtstreekse verwijzing drukt de accolades als onbewerkte tekst af. Alleen tpl evalueert daadwerkelijk de ingesloten instructies in de opgeslagen tekenreeks.

Je kunt ook bestandsinhoud aan tpl doorgeven, zodat een meegeleverd configuratiebestand release-specifieke plaatshouders kan bevatten.

De context hoeft niet de root te zijn. Geef een dict door, zodat de gerenderde tekenreeks precies de variabelen ziet die je kiest.

Charts laten gebruikers vaak op deze manier hosts of annotaties voor ingress van sjablonen voorzien, zodat flexibele configuratie in waarden staat in plaats van in sjablonen.

Als de opgeslagen tekenreeks een typefout bevat, mislukt tpl tijdens het renderen. Test daarom met helm template nadat je waarden met sjablonen hebt toegevoegd.

Omdat een host met sjablonen punten of dubbele punten kan bevatten, leid je het resultaat van tpl door quote, zodat de uiteindelijke YAML-waarde een veilige tekenreeks blijft.

Je hebt geleerd dat tpl sjabloontekenreeksen evalueert die in waarden of bestanden zijn opgeslagen, met een context die je opgeeft, zoals de root-dot. 🎉