Ai fișierele YAML ale unei aplicații. Le vrei în trei medii, cu setări diferite, și vrei să poți reveni la versiunea de ieri cu o comandă. Helm le transformă într-un pachet, numit chart, și ține istoria fiecărei instalări:
terminal
$ helm rollback web 1Rollback was a success! Happy Helming!
$ helm history web
REVISION STATUS DESCRIPTION
1 superseded Install complete
2 superseded Upgrade complete
3 deployed Rollback to 1
Din tabel au rămas trei coloane, ca să încapă pe ecran. Revenirea la versiunea 1 a devenit ea însăși versiunea 3.
să scrii un chart cu Chart.yaml, values.yaml și șabloane
să instalezi și să actualizezi o aplicație cu helm install și helm upgrade
să schimbi setări cu --set sau cu un fișier de valori
să revii la o versiune anterioară cu helm rollback
Pasul 2 din 5
Instalare, actualizare, revenire
Chart-ul se numește anunturi și are trei fișiere, plus un Service pe care îl găsești în teorie. Valorile implicite stau în values.yaml:
replicaCount: 1image:repository: nginxtag: 1.27-alpinemesaj: Bun venit
Apasă pe „Linia următoare” și urmărește ce versiuni apar în cluster. Release-ul, adică instalarea concretă a chart-ului, se numește web.
terminal
helm lint ./anunturihelm install web ./anunturihelm upgrade web ./anunturi \ --set replicaCount=3\ --set mesaj="Ora de sport se mută joi"kubectl get podshelm history webhelm rollback web 1helm history web
Release-ul web
Ce afișează terminalul
Linia 1.helm lint verifică chart-ul fără să atingă clusterul. Sugestia despre iconiță e doar informativă: 0 chart-uri picate.
Linia 2.helm install completează șabloanele cu valorile din values.yaml și trimite rezultatul în cluster. Prima versiune, REVISION: 1.
Liniile 3–5.helm upgrade cu două valori schimbate din linia de comandă: trei copii și alt mesaj. Apare versiunea 2.
Linia 6. Trei pod-uri noi. Mesajul s-a schimbat, deci pod-urile vechi au fost înlocuite, nu doar înmulțite.
Linia 7.helm history arată fiecare versiune. Doar una e deployed; cea dinainte e superseded, adică înlocuită.
Linia 8.helm rollback web 1 aplică din nou exact ce era în versiunea 1: un pod, mesajul „Bun venit”.
Linia 9. Istoria nu se rescrie. Revenirea e o versiune nouă, a treia, care copiază prima.
Gata. Tot timpul ai lucrat cu numele release-ului, web, nu cu fișiere YAML separate.
Prezice ieșirea
După rollback, rulezi kubectl exec deploy/web -- printenv MESAJ. Ce apare?
Răspuns: „Bun venit”.
Rollback-ul refolosește valorile versiunii 1, cele din values.yaml. Deployment-ul s-a schimbat, deci pod-urile au fost recreate cu mesajul vechi.
Pasul 3 din 5
Ce e un chart și cum primește valori
Trei idei: șabloanele, release-urile și valorile. Apoi două greșeli care opresc o instalare înainte să înceapă.
Tot ce e între {{ }} e completat de Helm. .Values vine din values.yaml și din ce dai la comandă. .Release.Name e numele ales la instalare, aici web. quote pune ghilimele, ca un mesaj cu două puncte să rămână text.
Ca să vezi ce va trimite Helm, fără să instalezi nimic, rulează helm template web ./anunturi. Primești YAML-ul final, cu replicas: 1 și image: "nginx:1.27-alpine".
2
Release și versiuni
Un chart e ca o rețetă, iar un release e o prăjitură făcută după ea. Același chart poate fi instalat de două ori, cu nume diferite: web-test și web-prod, fiecare cu valorile lui.
Fiecare install, upgrade sau rollback creează o versiune nouă, salvată în cluster. helm uninstall web șterge tot ce a creat release-ul. helm upgrade --install instalează dacă nu există și actualizează dacă există, comanda preferată în pipeline-uri.
3
Valori: fișier, apoi linie de comandă
productie.yaml
replicaCount: 3mesaj: "Salut,lume"
helm template web ./anunturi -f productie.yaml --set replicaCount=5
replicas: 5
value: "Salut, lume"
Helm pornește de la values.yaml, peste el pune fișierele date cu -f, iar la final valorile din --set. Ultimul câștigă: replicaCount e 5, nu 3.
Fiecare mediu primește fișierul lui: test.yaml, productie.yaml. Chart-ul rămâne unul singur.
Capcană: virgula din --set
Pentru --set, virgula separă mai multe valori. Un mesaj care conține o virgulă e tăiat în două:
$ helm template web ./anunturi --set mesaj="Salut, lume"
Error: failed parsing --set data: key " lume" has no value
Repară scăpând virgula, --set mesaj="Salut\, lume", sau mută textul într-un fișier de valori și folosește -f, ca în productie.yaml.
Capcană: un spațiu lipsă în values.yaml
anunturi/values.yaml
replicaCount: 1image:repository: nginxtag: 1.27-alpinemesaj: Bun venit
$ helm lint ./anunturi
[ERROR] values.yaml: unable to parse YAML: error converting YAML to JSON: yaml: line 3: did not find expected key
În YAML, indentarea e structură. tag are un singur spațiu, iar repository are două, deci nu mai sunt frați sub image. Linia raportată e cea dinaintea problemei, așa că verifică și linia următoare.
Repară cu exact două spații în fața lui tag și rulează helm lint înainte de orice instalare.
Pasul 4 din 5
Verifică-te
Toate întrebările pornesc de la chart-ul anunturi din pasul 2.
1 din 5 · Alege varianta
Release-ul web există deja. Rulezi încă o dată helm install web ./anunturi. Ce se întâmplă?
Răspuns: eroare.
Helm 4 răspunde cu Error: INSTALLATION FAILED: release name check failed: cannot reuse a name that is still in use. Pentru o instalare care există, folosești upgrade, sau upgrade --install.
2 din 5 · Prezice ieșirea
Versiunea curentă are trei copii și mesajul „Concurs”, date cu --set. Rulezi helm upgrade web ./anunturi --set replicaCount=2. Ce mesaj au pod-urile?
Răspuns: „Bun venit”.
Fiecare upgrade pornește de la values.yaml plus ce dai acum. Valorile din comanda trecută nu se păstrează. De aceea setările pe medii stau în fișiere, nu în comenzi de memorat.
3 din 5 · Prezice ieșirea
În ce linie afișează helm template web ./anunturi numele Deployment-ului?
Răspuns: name: web.
.Release.Name e numele release-ului, primul argument după template, nu numele chart-ului. În YAML-ul final nu mai rămâne nicio acoladă.
4 din 5 · Alege varianta
Ai replicaCount: 3 în productie.yaml. Rulezi helm upgrade web ./anunturi -f productie.yaml --set replicaCount=5. Câte copii pornesc?
Răspuns: 5.
Ordinea e values.yaml, apoi -f, apoi --set. Ce vine mai târziu suprascrie ce era înainte.
5 din 5 · Prezice ieșirea
Faci install, apoi două upgrade-uri, apoi helm rollback web 2. Ce număr are versiunea deployed în helm history web?
Răspuns: 4.
Install e 1, upgrade-urile sunt 2 și 3, iar rollback-ul devine versiunea 4, cu descrierea Rollback to 2. Istoria doar crește.
Pasul 5 din 5
Ce ai învățat
Un chart are Chart.yaml, values.yaml și șabloane în templates/.
Un release e o instalare cu nume; fiecare schimbare îi adaugă o versiune.
Valorile vin din values.yaml, apoi din -f, apoi din --set, iar ultima câștigă.
helm rollback creează o versiune nouă, cu setările uneia vechi.
În practică, o singură comandă acoperă și prima instalare, și actualizările: helm upgrade --install web ./anunturi -f productie.yaml. Merge la fel prima dată și a suta oară.