...
← Curs Kubernetes: toate lecțiile
Lecția 9 · Etichete

Etichete și selectori

Într-un cluster real sunt sute de poduri. Cum le găsești pe cele ale magazinului? Cum știe un Deployment care sunt podurile lui? Răspunsul e unul singur: etichetele (labels) și selectorii care le aleg. Sunt mecanismul care leagă între ele aproape toate obiectele Kubernetes.

Ce sunt etichetele

O etichetă este o pereche cheie=valoare lipită pe un obiect: app=magazin, tier=front, mediu=productie. Kubernetes nu le dă niciun sens; tu alegi ce înseamnă. Un obiect poate avea oricâte etichete.

În exemplele de mai jos rulează patru poduri: două ale magazinului și două ale blogului, pe niveluri diferite (front, back, db). Vezi-le cu etichete:

kubectl get pods --show-labels
NAME       READY   STATUS    RESTARTS   AGE   LABELS
articole   1/1     Running   0          16s   app=blog,tier=front
baza       1/1     Running   0          14s   app=blog,tier=db
produse    1/1     Running   0          20s   app=magazin,tier=back
vitrina    1/1     Running   0          18s   app=magazin,tier=front

Ai văzut deja etichete: kubectl run pune singur run=NUME, iar în YAML le scrii sub metadata.labels. Când ai multe, -L le arată ca coloane:

kubectl get pods -L app,tier
NAME       READY   STATUS    RESTARTS   AGE   APP       TIER
articole   1/1     Running   0          18s   blog      front
baza       1/1     Running   0          16s   blog      db
produse    1/1     Running   0          22s   magazin   back
vitrina    1/1     Running   0          20s   magazin   front

Selectori: alege podurile după etichete

Un selector este o condiție pe etichete. Cu -l (sau --selector) afișezi doar obiectele potrivite:

kubectl get pods -l app=magazin
NAME      READY   STATUS    RESTARTS   AGE
produse   1/1     Running   0          24s
vitrina   1/1     Running   0          22s
SelectorAlege podurile
-l app=magazincu eticheta app egală cu magazin
-l app=magazin,tier=frontcare îndeplinesc ambele condiții (virgula = și)
-l tier!=dbcu tier diferit de db (și pe cele fără eticheta tier)
-l 'tier in (front,back)'cu tier front sau back
-l tiercare au eticheta tier, cu orice valoare
-l '!tier'care nu au eticheta tier
kubectl get pods -l 'tier in (front,back)'
NAME       READY   STATUS    RESTARTS   AGE
articole   1/1     Running   0          22s
produse    1/1     Running   0          26s
vitrina    1/1     Running   0          24s
De ce contează

Așa lucrează Kubernetes intern: un Deployment își recunoaște podurile după selectorul app=magazin, un Service trimite trafic la podurile cu anumite etichete. Dacă scrii greșit o etichetă, obiectele „nu se mai văd” între ele. Vei vedea asta în modulul 2.

Adaugă, schimbă și șterge etichete

kubectl label lucrează pe obiecte care există deja. Adaugă o etichetă nouă:

kubectl label pod vitrina mediu=test
pod/vitrina labeled

Schimbarea unei etichete existente cere --overwrite, ca să nu suprascrii din greșeală:

kubectl label pod baza tier=cache
error: 'tier' already has a value (db), and --overwrite is false
kubectl label pod baza tier=cache --overwrite
pod/baza labeled

Ștergi o etichetă scriind cheia urmată de minus:

kubectl label pod vitrina mediu-
kubectl get pods -L tier,mediu
pod/vitrina labeled
NAME       READY   STATUS    RESTARTS   AGE   TIER    MEDIU
articole   1/1     Running   0          32s   front
baza       1/1     Running   0          30s   cache
produse    1/1     Running   0          36s   back
vitrina    1/1     Running   0          34s   front

Pe hartă, podurile își păstrează locul; doar etichetele s-au schimbat. Un selector care căuta tier=db nu mai găsește acum niciun pod.

Adnotări: informații, nu selecție

Lângă etichete există adnotările (annotations): tot perechi cheie-valoare, dar pentru informații pe care nu le folosești în selectori: cine a făcut schimbarea, linkul spre tichet, descrierea. Pot fi și texte lungi.

kubectl annotate pod produse responsabil="echipa magazin"
kubectl describe pod produse | grep -A 1 Annotations
pod/produse annotated
Annotations:      responsabil: echipa magazin
Status:           Running
EticheteAdnotări
Folosite în selectoridanu
Valoriscurte (max. 63 de caractere), fără spațiiorice text
Exempleapp, tier, mediu, versiunekubernetes.io/change-cause, contact, link spre documentație

Greșeli frecvente

  • error: 'tier' already has a value (front), and --overwrite is false: eticheta există; adaugă --overwrite dacă chiar vrei să o schimbi;
  • -l app=Magazin nu găsește nimic: valorile sunt sensibile la litere mari și mici;
  • un selector cu spații sau paranteze (tier in (front,back)) trebuie pus între ghilimele, altfel shell-ul îl desparte;
  • etichetele nu acceptă spații sau diacritice în valori: mediu=producție dă eroare de validare, folosește productie.
O convenție bună

Kubernetes recomandă etichete precum app.kubernetes.io/name, app.kubernetes.io/version și app.kubernetes.io/part-of. Pe proiecte mici, app, tier și mediu sunt suficiente; important este ca toată echipa să folosească aceleași chei.

În lumea reală

1Operații în masă

kubectl delete pods -l mediu=test curăță dintr-o singură comandă toate podurile de test, oricâte ar fi.

2Costuri

Etichete precum echipa=plati sau centru-cost=marketing permit împărțirea facturii de cloud pe echipe.

3Jurnale și monitorizare

Prometheus și Grafana grupează metricile după etichetele podurilor, de exemplu toate erorile pentru app=magazin.

Exercițiul tău

În cluster rulează patru poduri: a, b, c și d. Mută podul b în nivelul front (eticheta lui tier devine front), șterge eticheta temporar de pe podul c, apoi listează doar podurile din nivelul front.

  • Uită-te la etichete: kubectl get pods --show-labels.
  • Schimbă eticheta lui b: kubectl label pod b tier=front --overwrite.
  • Șterge eticheta temporar de pe c: kubectl label pod c temporar-.
  • Listează podurile front: kubectl get pods -l tier=front.
b are deja eticheta tier (cu valoarea back), deci fără --overwrite primești eroare. Minusul de la final șterge eticheta.

Soluția exercițiului

kubectl get pods --show-labels
kubectl label pod b tier=front --overwrite
kubectl label pod c temporar-
kubectl get pods -l tier=front
Excelent! Continuă cu lecția următoare →
terminalKubernetes
VerificareSe încarcă...
Mediul de lucru se încarcă. Poți citi lecția între timp.
Parcursul tău Primii pași cu Kubernetes Lecția 9 · Etichete și selectori
Progres 0% 0 din 14
Lecția curentă 9 / 12 Etichete