...
← Curs Kubernetes: toate lecțiile
Lecția 11 · Mini-proiect

Mini-proiect: pagina ta în cluster

E timpul să pui cap la cap tot ce ai învățat: un fișier YAML cu mai multe obiecte, etichete, un namespace, inspectarea cu logs și describe. La final îți deschizi aplicația în browser cu o unealtă nouă, kubectl port-forward, un tunel de pe calculatorul tău până la pod.

Planul

Construiești o pagină a magazinului, pas cu pas, cum ai face și la muncă:

1
scrii un singur fișier YAML cu namespace-ul și podul (despărțite de ---);
2
îl aplici cu kubectl apply -f;
3
verifici că podul rulează: get, describe, logs;
4
deschizi aplicația pe calculatorul tău cu kubectl port-forward și tabul Previzualizare.

Mai jos parcurgi planul pe o pagină de exemplu, vitrina, în namespace-ul demo. În exercițiu faci același lucru pentru site-ul tău.

Un fișier, două obiecte

Namespace-ul și podul stau în același fișier. Namespace-ul vine primul, fiindcă podul are nevoie de el:

cat > ~/k8s/vitrina.yaml <<'EOF'
apiVersion: v1
kind: Namespace
metadata:
  name: demo
---
apiVersion: v1
kind: Pod
metadata:
  name: vitrina
  namespace: demo
  labels:
    app: vitrina
spec:
  containers:
  - name: vitrina
    image: academia/magazin:v1
    ports:
    - containerPort: 8080
    env:
    - name: MESAJ
      value: "Reduceri de toamna"
EOF
kubectl apply -f ~/k8s/vitrina.yaml
namespace/demo created
Error from server (Forbidden): error when creating "/home/elev/k8s/vitrina.yaml": pods "vitrina" is forbidden: error looking up service account demo/default: serviceaccount "default" not found

Surpriză: namespace-ul s-a creat, dar podul a fost refuzat. Când un namespace e nou-nouț, Kubernetes îi creează în fundal contul de serviciu default, de care are nevoie orice pod; dacă podul ajunge în aceeași secundă, contul încă nu există. Pe clusterele reale vei întâlni exact acest mesaj. Soluția e simplă: aplici din nou, apply fiind sigur de rulat de câte ori vrei:

kubectl apply -f ~/k8s/vitrina.yaml
namespace/demo unchanged
pod/vitrina created

unchanged pentru namespace (exista deja) și created pentru pod: exact ce aștepți de la o comandă declarativă.

Verifică podul

k8ssim avans 10
kubectl get pods -n demo --show-labels
Au trecut 10 secunde (ora clusterului: 10:00:18).
NAME      READY   STATUS    RESTARTS   AGE   LABELS
vitrina   1/1     Running   0          14s   app=vitrina
kubectl logs vitrina -n demo
> magazin@1.0.0 start
> node server.js

Magazin Academia v1 pornit pe portul 8080 (pod vitrina)

Jurnalul confirmă că aplicația ascultă pe 8080. Dacă podul nu ar fi ajuns în Running, următorul pas ar fi fost kubectl describe pod vitrina -n demo și secțiunea Events (lecția 5).

Tunelul: kubectl port-forward

Podul are un IP din rețeaua clusterului (10.244.x.x), la care calculatorul tău nu ajunge direct. kubectl port-forward deschide un tunel: tot ce trimiți la localhost:PORT_LOCAL ajunge, prin API server, la PORT_POD din pod. Formatul este kubectl port-forward pod/NUME PORT_LOCAL:PORT_POD:

kubectl port-forward pod/vitrina 8081:8080 -n demo
curl localhost:8081
Forwarding from 127.0.0.1:8081 -> 8080
Forwarding from [::1]:8081 -> 8080
Magazin Academia v1 | pod: vitrina | Reduceri de toamna
  • 8081 este portul de pe calculatorul tău, 8080 portul aplicației din pod; pot fi diferite, ca la docker run -p 8081:8080;
  • pe un calculator real, comanda ține terminalul ocupat până apeși Ctrl+C, iar curl îl rulezi în alt terminal; în laborator tunelul rămâne activ în fundal;
  • tunelele active le vezi cu k8ssim forwards (ajutor doar al laboratorului) și pe hartă, în coloana Port-forward.

Același răspuns îl vezi în tabul Previzualizare: scrie adresa localhost:8081 și apasă Enter (sau folosește scurtătura care apare acolo).

Bine de știut

port-forward este o unealtă pentru tine, programatorul: pentru teste și depanare. Clienții magazinului nu ajung niciodată la aplicație așa; pentru ei există Services și Ingress (modulele 2 și 4).

Greșeli frecvente

  • Error from server (NotFound): pods "vitrina" not found la port-forward: ai uitat -n demo;
  • unable to listen on port 8081: … address already in use: portul local e ocupat de alt tunel sau program; alege alt port local;
  • curl: (7) Failed to connect: tunelul s-a oprit (pe un calculator real, ai apăsat Ctrl+C sau ai închis terminalul) sau ai greșit portul;
  • portul din dreapta trebuie să fie cel pe care ascultă aplicația (8080 la magazin, 80 la nginx), nu un port ales la întâmplare.

Rezumatul proiectului

PasComandă
fișierul cu namespace + pod~/k8s/NUME.yaml, documente despărțite de ---
trimis în clusterkubectl apply -f ~/k8s/NUME.yaml (încă o dată dacă primești eroarea serviceaccount)
verificatkubectl get pods -n NS, kubectl logs POD -n NS, kubectl describe pod POD -n NS
deschis în browserkubectl port-forward pod/POD 8080:8080 -n NS + Previzualizare
1Așa lucrezi zilnic

Un programator backend își verifică versiunea nouă în clusterul de dezvoltare exact așa: apply, logs, port-forward, browser.

2Acces la baze de date

Tot cu port-forward te conectezi de pe laptop la o bază de date din cluster, fără să o expui pe internet.

Exercițiul tău

Publică-ți prima pagină: scrie în ~/k8s/site.yaml namespace-ul site și podul site (în namespace-ul site) din imaginea academia/magazin:v1, cu eticheta app: site, portul 8080 și variabila MESAJ cu valoarea Primul meu site în Kubernetes. Aplică fișierul și deschide aplicația pe localhost:8080 cu port-forward.

  • Scrie ~/k8s/site.yaml: un Namespace numit site, apoi ---, apoi Pod-ul site cu namespace: site, eticheta app: site, imaginea academia/magazin:v1, containerPort: 8080 și env → MESAJ.
  • kubectl apply -f ~/k8s/site.yaml (dacă podul e refuzat cu serviceaccount "default" not found, rulează comanda încă o dată).
  • Verifică: kubectl get pods -n site.
  • Deschide tunelul: kubectl port-forward pod/site 8080:8080 -n site, apoi curl localhost:8080 sau tabul Previzualizare.
Variabilele de mediu în YAML sunt o listă sub container: env: apoi - name: MESAJ și value: "Primul meu site în Kubernetes".

Soluția exercițiului

cat > ~/k8s/site.yaml <<'EOF'
apiVersion: v1
kind: Namespace
metadata:
  name: site
---
apiVersion: v1
kind: Pod
metadata:
  name: site
  namespace: site
  labels:
    app: site
spec:
  containers:
  - name: site
    image: academia/magazin:v1
    ports:
    - containerPort: 8080
    env:
    - name: MESAJ
      value: "Primul meu site în Kubernetes"
EOF
kubectl apply -f ~/k8s/site.yaml
kubectl apply -f ~/k8s/site.yaml
kubectl get pods -n site
kubectl port-forward pod/site 8080:8080 -n site
curl localhost:8080
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 11 · Mini-proiect: pagina ta în cluster
Progres 0% 0 din 14
Lecția curentă 11 / 12 Mini-proiect