Liniile 1–3. Text fără acolade: Helm îl copiază exact cum e.
Linia 4..Release.Name e numele release-ului, demo. Textul din jur rămâne, deci rezultă demo-config.
Linia 6.include aduce blocul afis.etichete din _helpers.tpl. nindent 4 pune un rând nou și 4 spații în fața fiecărui rând, iar {{- șterge spațiile dinainte de acoladă.
Linia 8. Un pipeline: valoarea test trece prin upper, devine TEST, apoi prin quote, care pune ghilimelele.
Linia 9.replici e numărul 1. Într-un ConfigMap, valorile trebuie să fie text, așa că quote îl face "1".
Linia 10.echipa nu există în values.yaml. default "web" pune o valoare de rezervă în loc de un gol.
Liniile 11–13.public e false, deci tot blocul if dispare. Datorită lui {{-, nu rămâne nici rândul gol pe care stătea.
Linia 14.join lipește elementele listei porturi cu virgulă: 80,443.
Gata. Acesta e exact ce afișează helm template demo afis pentru acest fișier.
Prezice ieșirea
Rulezi helm template demo afis --set mediu=prod. Ce apare la linia 8 și în etichete?
Răspuns: „PROD” și mediu: prod.
Ambele locuri citesc aceeași valoare, .Values.mediu. Doar linia 8 o trece prin upper; helper-ul o folosește neschimbată.
Pasul 3 din 5
Limbajul din acolade
Helm folosește șabloanele din limbajul Go, plus o bibliotecă de funcții. Trei idei acoperă aproape tot ce vei scrie, apoi două capcane.
1
Obiecte și pipeline-uri
Punctul de la început, ., e tot contextul primit de șablon. Din el citești .Values, valorile, .Release, cu numele și namespace-ul, și .Chart, cu datele din Chart.yaml.
Bara | trimite rezultatul din stânga drept ultim argument funcției din dreapta, ca într-un terminal. {{ .Values.echipa | default "web" | quote }} se citește: ia echipa, dacă lipsește pune „web”, apoi pune ghilimele.
range repetă blocul pentru fiecare element din listă. În interior, punctul nu mai e tot contextul: e elementul curent, aici portul. De aceea scrii {{ . }}.
Liniuța din {{- șterge spațiile și rândul nou din stânga acoladei, iar cea din -}} pe cele din dreapta. Fără ele, fiecare range, if și end lasă în urmă un rând gol.
3
define, include și nindent
define, în _helpers.tpl, dă nume unui bloc. Fișierele care încep cu _ nu produc manifeste, doar definiții. include "afis.etichete" . aduce blocul și îi dă tot contextul, prin punctul de la final.
include întoarce text, iar textul trebuie așezat la indentarea potrivită. nindent 4 începe cu un rând nou și pune 4 spații în fața fiecărui rând din bloc. Același helper poate fi folosit la 4 spații în metadata și la 8 într-un template de pod.
Capcană: include fără nindent
configmap.yaml, fragment
labels: {{ include"afis.etichete". }}
Ieșirea, fără nicio eroare
labels:
app: demo
mediu: test
data:
Doar primul rând primește spațiile din fișier. Al doilea începe de la margine, deci mediu a devenit cheie de sus, lângă data, nu etichetă. YAML-ul e valid, iar greșeala trece neobservată.
Dacă încerci | indent 4 pe același rând, primul rând primește 8 spații, iar Helm refuză:
Error: YAML parse error on afis/templates/configmap.yaml: error converting YAML to JSON: yaml: line 6: did not find expected key
Repară cu {{- include "afis.etichete" . | nindent 4 }}, ca în pasul 2.
baza lipsește din valori, deci e gol. Să citești .host din gol e o eroare, nu un gol mai mic. Nici default pus la final nu te salvează, pentru că eroarea apare înainte să ajungă la el.
Repară adăugând în values.yaml tot drumul, baza: cu host: dedesubt, chiar și cu valoare goală. Sau verifică întâi părintele, cu {{- if .Values.baza }}.
Pasul 4 din 5
Verifică-te
Toate întrebările folosesc chart-ul afis și release-ul demo. Răspunsurile au fost verificate cu helm template.
1 din 5 · Prezice ieșirea
Ce rând produce linia 10 la helm template demo afis --set echipa=mobil?
Răspuns: ECHIPA: "mobil".
default intervine doar când valoarea lipsește sau e goală. Aici ea există, deci trece neschimbată spre quote.
2 din 5 · Prezice ieșirea
Ce produce service.yaml la --set "porturi={8080}"?
Răspuns: un singur port, p8080.
O listă dată cu --set o înlocuiește complet pe cea din values.yaml, nu i se adaugă. range are un singur element de parcurs.
3 din 5 · Alege varianta
În interiorul lui {{- range .Values.porturi }}, ce este .?
Răspuns: elementul curent.
range mută punctul pe fiecare element, pe rând. Ca să citești ceva din afara buclei, ca .Release.Name, scrii $.Release.Name: $ e mereu contextul de la început.
4 din 5 · Prezice ieșirea
Ce rând apare în plus la helm template demo afis --set public=true?
Răspuns: PUBLIC: "da".
--set transformă true în valoare logică, deci if intră pe ramură. Rândul e copiat exact cum e scris în șablon, cu "da".
5 din 5 · Alege varianta
Ce face liniuța din {{- if .Values.public }}?
Răspuns: șterge spațiile din stânga.
Liniuța controlează doar spațiile din jurul acoladei, nu logica. Negarea se scrie {{- if not .Values.public }}.
Pasul 5 din 5
Ce ai învățat
.Values, .Release și .Chart sunt datele din care se completează un șablon.
| leagă funcții: default pune o rezervă, quote pune ghilimele, upper face majuscule.
if și range se scriu cu {{-, ca să nu lase rânduri goale.
Un helper se aduce cu include și se așază cu nindent.
Cum verifici un șablon
Trei comenzi, în ordinea asta, înainte de orice instalare: