MyCodeSchool

Pasul 1 din 5

Helm

Pasul 1 din 5 · Ce construiești

  • Helm
  • Avansat
  • 14 minute

Șabloanele Helm: cum devine values.yaml un manifest

Un singur șablon, două medii. Aceeași comandă produce un ConfigMap pentru test și unul pentru producție, doar din valorile primite:

terminal, fragment din data
$ helm template demo afis
  MEDIU: "TEST"
  ECHIPA: "web"
$ helm template demo afis --set mediu=prod --set echipa=mobil --set public=true
  MEDIU: "PROD"
  ECHIPA: "mobil"
  PUBLIC: "da"

helm template nu atinge niciun cluster: afișează doar YAML-ul final. E unealta cu care verifici orice șablon înainte să-l instalezi.

Pasul 2 din 5

Urmărește șablonul rând cu rând

Chart-ul afis are valorile de mai jos. Release-ul se numește demo.

afis/values.yaml
mediu: testreplici: 1resurse:  memorie: 128Miporturi:  - 80  - 443public: false
afis/templates/_helpers.tpl
{{- define "afis.etichete" -}}app: {{ .Release.Name }}mediu: {{ .Values.mediu }}{{- end }}

Apasă pe „Linia următoare”. În stânga vezi valoarea folosită, în dreapta YAML-ul produs până acum.

afis/templates/configmap.yaml
apiVersion: v1kind: ConfigMapmetadata:  name: {{ .Release.Name }}-config  labels:    {{- include "afis.etichete" . | nindent 4 }}data:  MEDIU: {{ .Values.mediu | upper | quote }}  REPLICI: {{ .Values.replici | quote }}  ECHIPA: {{ .Values.echipa | default "web" | quote }}  {{- if .Values.public }}  PUBLIC: "da"  {{- end }}  PORTURI: {{ join "," .Values.porturi | quote }}

Valori folosite

YAML-ul produs


      

  1. Liniile 1–3. Text fără acolade: Helm îl copiază exact cum e.
  2. Linia 4. .Release.Name e numele release-ului, demo. Textul din jur rămâne, deci rezultă demo-config.
  3. 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ă.
  4. Linia 8. Un pipeline: valoarea test trece prin upper, devine TEST, apoi prin quote, care pune ghilimelele.
  5. Linia 9. replici e numărul 1. Într-un ConfigMap, valorile trebuie să fie text, așa că quote îl face "1".
  6. Linia 10. echipa nu există în values.yaml. default "web" pune o valoare de rezervă în loc de un gol.
  7. 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.
  8. Linia 14. join lipește elementele listei porturi cu virgulă: 80,443.
  9. 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.

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 și spațiile din jurul acoladelor

afis/templates/service.yaml
apiVersion: v1kind: Servicemetadata:  name: {{ .Release.Name }}spec:  selector:    app: {{ .Release.Name }}  ports:  {{- range .Values.porturi }}    - name: p{{ . }}      port: {{ . }}  {{- end }}

helm template demo afis -s templates/service.yaml, fragment

  ports:
    - name: p80
      port: 80
    - name: p443
      port: 443

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.

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.

Capcană: o cheie care nu există

x.yaml, fragment
data:  HOST: {{ .Values.baza.host }}
Error: afis/templates/x.yaml:6:18
  executing "afis/templates/x.yaml" at <.Values.baza.host>:
    nil pointer evaluating interface {}.host

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

Cum verifici un șablon

Trei comenzi, în ordinea asta, înainte de orice instalare:

fără cluster

helm lint afis
helm template demo afis
helm template demo afis -f productie.yaml

Pentru un șablon care pică, --debug afișează YAML-ul invalid, ca să vezi rândul vinovat.

Continuă cu