Declarativ: kubectl apply -f
Ai un fișier YAML; acum îl trimiți în cluster. kubectl apply -f este comanda pe care o vei folosi cel mai des în toată cariera de Kubernetes: creează obiectele care lipsesc, le actualizează pe cele schimbate și nu face nimic dacă totul e deja cum scrie în fișier.
Imperativ sau declarativ
| Imperativ | Declarativ | |
|---|---|---|
| Cum arată | kubectl run, kubectl delete pod, kubectl label | un fișier YAML + kubectl apply -f |
| Ce spui | „fă pasul acesta” | „așa trebuie să arate” |
| Rulat de două ori | a doua oară dă eroare (AlreadyExists) | a doua oară nu schimbă nimic |
| Unde rămâne | în istoricul terminalului tău | în fișier, pus în Git |
Comenzile imperative sunt perfecte pentru teste și investigații. Pentru ce rămâne în cluster, echipele folosesc fișiere: fișierul este sursa adevărului. Dacă vrei să știi cum arată producția, citești fișierele din Git, nu ghicești din comenzi rulate cândva de cineva.
apply: created, unchanged, configured
Scrie un pod în fișier și aplică-l:
cat > ~/k8s/web.yaml <<'EOF'
apiVersion: v1
kind: Pod
metadata:
name: web
labels:
app: web
spec:
containers:
- name: web
image: nginx:1.27
EOF
kubectl apply -f ~/k8s/web.yamlpod/web created
Aplică-l din nou, fără nicio schimbare:
kubectl apply -f ~/k8s/web.yaml
pod/web unchanged
unchanged: clusterul arată deja exact ca fișierul. Acum schimbă imaginea în fișier (cu sed, de la cursul de Linux, sau în Editorul YAML) și aplică:
sed -i 's/nginx:1.27/nginx:1.26/' ~/k8s/web.yaml kubectl apply -f ~/k8s/web.yaml
pod/web configured
| Mesaj | Înseamnă |
|---|---|
| created | obiectul nu exista și a fost creat |
| unchanged | obiectul există și arată deja ca în fișier |
| configured | obiectul exista și a fost actualizat după fișier |
În tabul Editor YAML, butonul „kubectl apply” rulează pentru tine kubectl apply -f pe fișierul deschis, iar rezultatul apare în terminal.
Ce a adăugat clusterul: -o yaml
Fișierul tău are 10 rânduri. Obiectul salvat în cluster are mult mai multe: valorile implicite completate de Kubernetes și secțiunea status. Le vezi cu -o yaml:
k8ssim avans 10 kubectl get pod web -o yaml | grep -E 'uid|imagePullPolicy|restartPolicy|phase|podIP:'
Au trecut 10 secunde (ora clusterului: 10:00:22).
uid: b35d709a-3676-40d5-a3c5-33a1b2a24daa
imagePullPolicy: IfNotPresent
restartPolicy: Always
phase: Running
podIP: 10.244.2.2- uid: identificatorul unic al obiectului, diferit pentru fiecare pod creat;
- imagePullPolicy: IfNotPresent și restartPolicy: Always: valori implicite pe care nu le-ai scris;
- phase: Running și podIP: din status, starea reală.
În adnotarea kubectl.kubernetes.io/last-applied-configuration, apply ține minte ultima versiune a fișierului tău; așa știe data viitoare ce ai schimbat și ce ai șters din fișier.
Un generator de YAML: --dry-run=client -o yaml
Nu trebuie să scrii fiecare fișier de la zero. Comenzile imperative pot doar afișa obiectul, fără să-l creeze: --dry-run=client (doar pe calculatorul tău) și -o yaml. Redirecționat într-un fișier, ai un schelet gata făcut:
kubectl run apache --image=httpd:2.4 --port=80 --dry-run=client -o yaml > ~/k8s/apache.yaml cat ~/k8s/apache.yaml
apiVersion: v1
kind: Pod
metadata:
creationTimestamp: null
labels:
run: apache
name: apache
namespace: default
spec:
containers:
- image: httpd:2.4
name: apache
ports:
- containerPort: 80
resources: {}
dnsPolicy: ClusterFirst
restartPolicy: Always
status: {}Poți șterge rândurile inutile (creationTimestamp: null, resources: {}, status: {}) și apoi aplica fișierul. La examenele de certificare Kubernetes (CKA, CKAD) aproape toată lumea lucrează așa, ca să câștige timp.
Ștergerea după fișier și o greșeală frecventă
kubectl delete -f șterge exact obiectele descrise în fișier:
kubectl delete -f ~/k8s/web.yaml
pod "web" deleted
Unele câmpuri ale unui pod nu se pot schimba după creare. Imaginea da (ai văzut configured), dar de exemplu porturile nu. Aplică din nou web.yaml și apoi adaugă un port în fișier:
kubectl apply -f ~/k8s/web.yaml printf ' ports:\n - containerPort: 80\n' >> ~/k8s/web.yaml kubectl apply -f ~/k8s/web.yaml
pod/web created The Pod "web" is invalid: spec: Forbidden: pod updates may not change fields other than `spec.containers[*].image`,`spec.initContainers[*].image`,`spec.activeDeadlineSeconds`,`spec.tolerations` (only additions to existing tolerations),`spec.terminationGracePeriodSeconds` (allow it to be set to 1 if it was previously negative)
Forbidden: pod updates may not change fields other than spec.containers[*].image…: un pod rulează exact cum a fost creat. Soluția: kubectl delete -f și apoi kubectl apply -f din nou. Cu Deployment-urile (modulul 2) problema dispare: ele înlocuiesc singure podurile când schimbi ceva.
Valorile etichetelor sunt șiruri. Scrie versiune: "1", cu ghilimele; fără ele, pe un cluster real primești cannot unmarshal number into Go struct field ObjectMeta.metadata.labels of type string.
În lumea reală
În CI/CD, ultimul pas este aproape mereu un kubectl apply -f pe folderul cu manifeste (sau un instrument care face același lucru, ca Helm sau Argo CD).
Fișierul testat pe clusterul de dezvoltare este aplicat apoi neschimbat pe producție.
Un coleg citește diferența din fișier înainte de lansare; o comandă tastată direct în producție nu o vede nimeni.
Fișierul ~/k8s/pod.yaml din lecția trecută este gata. Trimite-l în cluster, apoi adaugă în fișier eticheta versiune: "1" (lângă app: pagina) și aplică-l din nou, ca podul să primească eticheta.
- Aplică fișierul: kubectl apply -f ~/k8s/pod.yaml (vezi pod/pagina created).
- În Editorul YAML, sub labels, adaugă rândul versiune: "1", aliniat cu app: pagina.
- Aplică din nou fișierul (vezi pod/pagina configured).
- Verifică eticheta: kubectl get pods --show-labels.
Soluția exercițiului
kubectl apply -f ~/k8s/pod.yaml
cat > ~/k8s/pod.yaml <<'EOF'
apiVersion: v1
kind: Pod
metadata:
name: pagina
labels:
app: pagina
versiune: "1"
spec:
containers:
- name: pagina
image: nginx:1.27
ports:
- containerPort: 80
EOF
kubectl apply -f ~/k8s/pod.yaml
kubectl get pods --show-labels 