...
← Curs Kubernetes: toate lecțiile
Lecția 8 · YAML

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

ImperativDeclarativ
Cum aratăkubectl run, kubectl delete pod, kubectl labelun fișier YAML + kubectl apply -f
Ce spui„fă pasul acesta”„așa trebuie să arate”
Rulat de două oria 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.yaml
pod/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ă
createdobiectul nu exista și a fost creat
unchangedobiectul există și arată deja ca în fișier
configuredobiectul exista și a fost actualizat după fișier
Butonul kubectl apply

Î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.

Atenție la etichete numerice

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ă

1Pipeline de lansare

Î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).

2Același fișier, mai multe medii

Fișierul testat pe clusterul de dezvoltare este aplicat apoi neschimbat pe producție.

3Revizuire

Un coleg citește diferența din fișier înainte de lansare; o comandă tastată direct în producție nu o vede nimeni.

Exercițiul tău

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.
Valoarea etichetei trebuie scrisă cu ghilimele, "1", fiindcă etichetele sunt șiruri de caractere.

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
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 8 · Declarativ: kubectl apply -f
Progres 0% 0 din 14
Lecția curentă 8 / 12 Yaml