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
| Selector | Alege podurile |
|---|---|
| -l app=magazin | cu eticheta app egală cu magazin |
| -l app=magazin,tier=front | care îndeplinesc ambele condiții (virgula = și) |
| -l tier!=db | cu tier diferit de db (și pe cele fără eticheta tier) |
| -l 'tier in (front,back)' | cu tier front sau back |
| -l tier | care 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
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
| Etichete | Adnotări | |
|---|---|---|
| Folosite în selectori | da | nu |
| Valori | scurte (max. 63 de caractere), fără spații | orice text |
| Exemple | app, tier, mediu, versiune | kubernetes.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.
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ă
kubectl delete pods -l mediu=test curăță dintr-o singură comandă toate podurile de test, oricâte ar fi.
Etichete precum echipa=plati sau centru-cost=marketing permit împărțirea facturii de cloud pe echipe.
Prometheus și Grafana grupează metricile după etichetele podurilor, de exemplu toate erorile pentru app=magazin.
Î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.
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
