...
← Curs Kubernetes: toate lecțiile
Lecția 3 · Introducere

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țiuneCe conține
clustersclusterele cunoscute: nume, adresa server și certificatul autorității (ca să știi că vorbești cu serverul corect)
usersidentitățile tale: certificat client, token sau un program care obține token-ul (în cloud)
contextscombinații cluster + utilizator (+ namespace), fiecare cu un nume
current-contextcontextul folosit acum de orice comandă kubectl

Contextul curent îl afli direct:

kubectl config current-context
kind-academia
De ce contexte

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]
ParteExemple
VERBget, describe, run, create, apply, delete, logs, exec
TIPpods, nodes, deployments, services, namespaces
NUMEsalut, 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
Bine de știut

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ă

1kubeconfig de la cloud

Comenzi ca aws eks update-kubeconfig sau az aks get-credentials adaugă singure clusterul, utilizatorul și contextul în ~/.kube/config.

2Fișierul e o cheie

kubeconfig dă acces la cluster: nu îl pui în Git și nu îl trimiți pe chat, la fel ca o parolă.

3Promptul care arată contextul

Mulți ingineri își pun contextul curent în promptul terminalului, ca să vadă mereu dacă sunt pe producție.

Exercițiul tău

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.
grep -i caută fără să țină cont de literele mari și mici; > scrie rezultatul în fișier.

Soluția exercițiului

kubectl config current-context
kubectl cluster-info
kubectl api-resources | grep -i deploy > ~/k8s/scurtaturi.txt
cat ~/k8s/scurtaturi.txt
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 3 · kubectl și fișierul kubeconfig
Progres 0% 0 din 14
Lecția curentă 3 / 12 Introducere