kubectl și fișierul kubeconfig
Ai aflat că tot ce faci în cluster trece prin API server. Dar de unde știe kubectl la ce cluster să se conecteze și cine ești tu? Răspunsul e un fișier: kubeconfig. În această lecție îl citești, înveți forma generală a comenzilor kubectl și prescurtările care te scapă de mult tastat.
kubectl: un client pentru API server
kubectl nu rulează nimic în cluster. E un program pe calculatorul tău care transformă comenzile în cereri HTTPS către API server și îți afișează răspunsul frumos. La fel ca docker, care vorbea cu Docker Engine, kubectl vorbește cu API serverul.
Ca să trimită o cerere, kubectl are nevoie de trei informații: adresa API serverului, cine ești (un certificat sau un token) și, opțional, namespace-ul implicit. Toate stau în fișierul ~/.kube/config, numit kubeconfig.
kubectl cluster-info
Kubernetes control plane is running at https://127.0.0.1:41235 CoreDNS is running at https://127.0.0.1:41235/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy To further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.
cluster-info arată adresa API serverului (https://127.0.0.1:41235) și a serviciului DNS. kind a creat clusterul în containere Docker și a publicat API serverul pe un port al calculatorului tău, de aceea adresa e 127.0.0.1.
Ce conține kubeconfig
Afișează configurarea cu kubectl config view (cheile secrete sunt ascunse automat, ca DATA+OMITTED):
kubectl config view
apiVersion: v1
clusters:
- cluster:
certificate-authority-data: DATA+OMITTED
server: https://127.0.0.1:41235
name: kind-academia
contexts:
- context:
cluster: kind-academia
user: kind-academia
name: kind-academia
current-context: kind-academia
kind: Config
preferences: {}
users:
- name: kind-academia
user:
client-certificate-data: DATA+OMITTED
client-key-data: DATA+OMITTED| Secțiune | Ce conține |
|---|---|
| clusters | clusterele cunoscute: nume, adresa server și certificatul autorității (ca să știi că vorbești cu serverul corect) |
| users | identitățile tale: certificat client, token sau un program care obține token-ul (în cloud) |
| contexts | combinații cluster + utilizator (+ namespace), fiecare cu un nume |
| current-context | contextul folosit acum de orice comandă kubectl |
Contextul curent îl afli direct:
kubectl config current-context
kind-academia
La muncă vei avea mai multe clustere: dezvoltare, testare, producție. Fiecare are contextul lui, iar current-context spune pe care lucrezi acum. Cea mai neplăcută greșeală din DevOps este să rulezi o comandă pe producție crezând că ești pe testare, de aceea verifici contextul înainte de orice ștergere. Schimbarea contextelor o exersezi în modulul 3.
Forma oricărei comenzi kubectl
Aproape toate comenzile au aceeași structură:
kubectl VERB TIP [NUME] [opțiuni]
| Parte | Exemple |
|---|---|
| VERB | get, describe, run, create, apply, delete, logs, exec |
| TIP | pods, nodes, deployments, services, namespaces |
| NUME | salut, academia-worker (fără nume: toate obiectele de acel tip) |
| opțiuni | -o wide, -n kube-system, --image=nginx:1.27 |
Așa citești comenzile din lecțiile trecute: kubectl get nodes (verb get, tip nodes, fără nume = toate), kubectl describe node academia-worker (verb describe, tip node, nume academia-worker).
Prescurtări: alias-ul k și numele scurte
Vei tasta kubectl de sute de ori pe zi, așa că aproape toată lumea își face alias-ul k. În laborator există deja: k get nodes este același lucru cu kubectl get nodes. Și tipurile au nume scurte; lista completă o dă kubectl api-resources:
kubectl api-resources | head
NAME SHORTNAMES APIVERSION NAMESPACED KIND configmaps cm v1 true ConfigMap endpoints ep v1 true Endpoints events ev v1 true Event limitranges limits v1 true LimitRange namespaces ns v1 false Namespace nodes no v1 false Node persistentvolumeclaims pvc v1 true PersistentVolumeClaim persistentvolumes pv v1 false PersistentVolume pods po v1 true Pod
Coloana SHORTNAMES conține prescurtările: po pentru pods, no pentru nodes, ns pentru namespaces, cm pentru configmaps. Coloana NAMESPACED spune dacă obiectul aparține unui namespace (podurile da, nodurile nu). Le poți combina:
k get no
NAME STATUS ROLES AGE VERSION academia-control-plane Ready control-plane 15m v1.31.2 academia-worker Ready <none> 14m v1.31.2 academia-worker2 Ready <none> 14m v1.31.2
Ca să găsești rapid un tip, filtrezi lista cu grep:
kubectl api-resources | grep -i pods
pods po v1 true Pod
Pentru tip poți scrie forma de singular, de plural sau prescurtarea: kubectl get pod, kubectl get pods și kubectl get po fac exact același lucru.
Greșeli frecvente
Un tip scris greșit primește un mesaj clar de la server:
kubectl get podz
error: the server doesn't have a resource type "podz"
Mesajul înseamnă „serverul nu are niciun tip de resursă numit podz”. Laboratorul îți dă și un sfat (rândul [sfat]), care pe un cluster real nu apare. Alte situații pe care le vei întâlni:
- error: context "prod" does not exist: numele contextului e scris greșit; vezi lista cu kubectl config get-contexts;
- Unable to connect to the server: dial tcp …: connect: connection refused: clusterul nu pornește sau adresa din kubeconfig e veche;
- error: You must be logged in to the server (Unauthorized): certificatul sau token-ul din kubeconfig a expirat.
În lumea reală
Comenzi ca aws eks update-kubeconfig sau az aks get-credentials adaugă singure clusterul, utilizatorul și contextul în ~/.kube/config.
kubeconfig dă acces la cluster: nu îl pui în Git și nu îl trimiți pe chat, la fel ca o parolă.
Mulți ingineri își pun contextul curent în promptul terminalului, ca să vadă mereu dacă sunt pe producție.
Verifică la ce cluster ești conectat: afișează contextul curent și informațiile clusterului, apoi găsește prescurtarea pentru Deployment-uri și salvează rândul găsit în ~/k8s/scurtaturi.txt.
- kubectl config current-context
- kubectl cluster-info
- kubectl api-resources | grep -i deploy > ~/k8s/scurtaturi.txt, apoi verifică fișierul cu cat.
Soluția exercițiului
kubectl config current-context kubectl cluster-info kubectl api-resources | grep -i deploy > ~/k8s/scurtaturi.txt cat ~/k8s/scurtaturi.txt
