Namespace-uri: primii pași
Etichetele grupează obiectele după rol. Pentru o separare mai puternică, de exemplu între echipe sau între aplicații, Kubernetes are namespace-uri: „dosare” în care pui obiectele. Ai folosit deja unul, kube-system; în această lecție îți creezi propriile namespace-uri și înveți opțiunile -n și -A.
Ce este un namespace
Un namespace este un spațiu de nume în interiorul clusterului. Gândește-te la el ca la un dosar: două fișiere cu același nume pot sta liniștite în dosare diferite. La fel, poți avea podul web în namespace-ul magazin și alt pod web în namespace-ul blog.
Clusterul vine cu câteva namespace-uri gata create:
kubectl get namespaces
NAME STATUS AGE default Active 15m ingress-nginx Active 13m kube-node-lease Active 15m kube-public Active 15m kube-system Active 15m local-path-storage Active 15m
| Namespace | Ce conține |
|---|---|
| default | tot ce creezi fără să alegi un namespace (podurile tale de până acum) |
| kube-system | componentele clusterului: API server, etcd, CoreDNS, kube-proxy |
| kube-public | informații publice despre cluster, citite rar |
| kube-node-lease | semnalele de viață ale nodurilor (folosite intern) |
| ingress-nginx, local-path-storage | programe instalate în laborator: ingress-ul și stocarea (modulele 4 și 5) |
Unele obiecte sunt ale întregului cluster: nodurile, namespace-urile însele, StorageClass-urile. Coloana NAMESPACED din kubectl api-resources (lecția 3) îți spune care sunt care.
Opțiunea -n
Orice comandă lucrează implicit în default. Cu -n NUME (sau --namespace NUME) alegi alt namespace:
kubectl get pods kubectl get pods -n ingress-nginx
No resources found in default namespace. NAME READY STATUS RESTARTS AGE ingress-nginx-controller-827dspdzk8-tgzq6 1/1 Running 0 12m
În default nu e nimic (laboratorul îți arată un sfat în terminal), iar în ingress-nginx rulează controllerul de ingress. Dacă „nu-ți găsești” podul, aproape sigur te uiți în alt namespace.
Creează un namespace și lucrează în el
Un namespace nou se creează cu o singură comandă. Apoi pui -n la run, get, describe, logs, delete, la orice:
kubectl create namespace test kubectl run web --image=nginx:1.27 -n test k8ssim avans 10 kubectl get pods -n test
namespace/test created pod/web created Au trecut 10 secunde (ora clusterului: 10:00:22). NAME READY STATUS RESTARTS AGE web 1/1 Running 0 14s
Același nume poate exista în alt namespace, fără conflict:
kubectl run web --image=nginx:1.27 k8ssim avans 10 kubectl get pods -A -l run=web
pod/web created Au trecut 10 secunde (ora clusterului: 10:00:38). NAMESPACE NAME READY STATUS RESTARTS AGE default web 1/1 Running 0 14s test web 1/1 Running 0 30s
-A (prescurtarea pentru --all-namespaces) caută în toate namespace-urile și adaugă coloana NAMESPACE. Aici l-am combinat cu un selector, ca să vezi doar cele două poduri web. Fără -l, kubectl get pods -A listează tot clusterul, inclusiv kube-system.
În YAML, namespace-ul se scrie în metadata:
apiVersion: v1 kind: Pod metadata: name: web namespace: test
Ștergerea unui namespace
Când ștergi un namespace, Kubernetes șterge tot ce e în el: poduri, configurări, servicii:
kubectl delete namespace test kubectl get pods -A -l run=web
namespace "test" deleted NAMESPACE NAME READY STATUS RESTARTS AGE default web 1/1 Running 0 21s
A rămas doar podul web din default. E foarte comod pentru curățenie după teste și foarte periculos dacă greșești numele.
kubectl delete namespace nu cere confirmare. Pe un cluster real, ștergerea unui namespace cu multe obiecte poate dura un minut (namespace-ul stă în Terminating), dar nu se mai poate opri.
Greșeli frecvente
- Error from server (NotFound): pods "web" not found, deși podul există: ai uitat -n; caută-l cu kubectl get pods -A;
- Error from server (NotFound): namespaces "magazn" not found: namespace-ul trebuie să existe înainte să creezi obiecte în el;
- Error from server (AlreadyExists): namespaces "test" already exists: namespace-ul e deja creat; poți merge mai departe;
- namespace-urile nu se pun unul în altul: nu există „subdosare”.
Poți schimba namespace-ul implicit al contextului (ca să nu mai scrii -n mereu) și poți pune limite de resurse pe un namespace (ResourceQuota). Le înveți în modulul despre configurare.
În lumea reală
Echipa de plăți lucrează în plati, echipa de catalog în catalog; fiecare își vede doar obiectele ei și are drepturi doar acolo (RBAC, modulul 4).
Firmele mici pun dev și staging ca namespace-uri pe același cluster, ca să economisească; producția stă de obicei pe un cluster separat.
Uneltele precum ingress-nginx, cert-manager sau Prometheus își primesc fiecare namespace-ul lor, ca să nu se amestece cu aplicațiile.
Pregătește un spațiu separat pentru magazin: creează namespace-ul magazin, pornește în el podul web din imaginea nginx:1.27 și listează podurile din toate namespace-urile.
- kubectl create namespace magazin
- kubectl run web --image=nginx:1.27 -n magazin
- Listează tot clusterul: kubectl get pods -A (găsește podul web pe rândul namespace-ului magazin).
Soluția exercițiului
kubectl create namespace magazin kubectl run web --image=nginx:1.27 -n magazin kubectl get pods -A
