MyCodeSchool

Pasul 1 din 5

Helm

Pasul 1 din 5 · Ce construiești

  • Helm
  • Mediu
  • 14 minute

Primul tău chart Helm: instalezi, schimbi, revii

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 1
Rollback 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.

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:

anunturi/Chart.yaml
apiVersion: v2name: anunturiversion: 0.1.0appVersion: "1.27"
anunturi/values.yaml
replicaCount: 1image:  repository: nginx  tag: 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


      

  1. Linia 1. helm lint verifică chart-ul fără să atingă clusterul. Sugestia despre iconiță e doar informativă: 0 chart-uri picate.
  2. Linia 2. helm install completează șabloanele cu valorile din values.yaml și trimite rezultatul în cluster. Prima versiune, REVISION: 1.
  3. Liniile 3–5. helm upgrade cu două valori schimbate din linia de comandă: trei copii și alt mesaj. Apare versiunea 2.
  4. Linia 6. Trei pod-uri noi. Mesajul s-a schimbat, deci pod-urile vechi au fost înlocuite, nu doar înmulțite.
  5. Linia 7. helm history arată fiecare versiune. Doar una e deployed; cea dinainte e superseded, adică înlocuită.
  6. Linia 8. helm rollback web 1 aplică din nou exact ce era în versiunea 1: un pod, mesajul „Bun venit”.
  7. Linia 9. Istoria nu se rescrie. Revenirea e o versiune nouă, a treia, care copiază prima.
  8. 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ă.

Șabloane: YAML cu goluri

templates/deployment.yaml
apiVersion: apps/v1kind: Deploymentmetadata:  name: {{ .Release.Name }}spec:  replicas: {{ .Values.replicaCount }}  selector:    matchLabels:      app: {{ .Release.Name }}  template:    metadata:      labels:        app: {{ .Release.Name }}    spec:      containers:        - name: web          image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"          env:            - name: MESAJ              value: {{ .Values.mesaj | quote }}

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.

templates/service.yaml
apiVersion: v1kind: Servicemetadata:  name: {{ .Release.Name }}spec:  selector:    app: {{ .Release.Name }}  ports:    - port: 80

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".

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.

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: nginx tag: 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

Structura chart-ului

anunturi/

Chart.yaml
values.yaml
templates/deployment.yaml
templates/service.yaml

Î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ă.

Continuă cu