...
Eroare Kubernetes · Manifeste YAML, apply și câmpuri invalide

The Pod "p" 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)

Pe scurt

Un pod existent permite modificarea doar a câtorva câmpuri (imaginea, toleranțele, activeDeadlineSeconds). Pentru variabile de mediu, porturi, resurse sau volume trebuie să-l recreezi (kubectl replace --force -f sau delete + apply). Mai bine, rulează aplicația într-un Deployment, care recreează podurile singur.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Podurile sunt gândite ca obiecte de unică folosință: odată pornite, specificația lor e aproape în întregime înghețată. API server-ul acceptă doar schimbări pe care kubelet-ul le poate aplica fără să recreeze podul: imaginea containerelor, toleranțe noi, termenul activeDeadlineSeconds.

Mesajul apare când modifici un manifest de pod (o variabilă de mediu, un port, resurse, o comandă) și rulezi kubectl apply sau kubectl edit. La edit, kubectl salvează modificarea respinsă într-un fișier temporar și îți spune unde.

În practică, podurile simple sunt pentru teste. Aplicațiile se pun într-un Deployment: acolo schimbi șablonul, iar Deploymentul creează poduri noi cu configurația nouă, fără întrerupere.

De ce apare: cauzele frecvente

1Schimbi o variabilă de mediu într-un pod

Greșit
YAML
# p.yaml: value schimbat
kubectl apply -f p.yaml
Corect
YAML
kubectl replace --force -f p.yaml

Podul trebuie recreat ca să primească altă configurație.

2kubectl edit pe pod

Greșit
YAML
kubectl edit pod p   # schimbi resources
Corect
YAML
kubectl edit deployment web   # schimbi resources în șablon

Deploymentul recreează podurile cu noul șablon.

3Doar imaginea se poate schimba direct

Greșit
YAML
kubectl edit pod p   # schimbi ports
Corect
YAML
kubectl set image pod/p p=nginx:1.26   # merge fără recreare

Imaginea e unul dintre puținele câmpuri modificabile; kubelet repornește containerul.

Repară tu

Repară eroarea, direct în pagină

Podul p2 (o pagină de test a unui hotel) a fost creat din ~/k8s/p2.yaml cu MESAJ=Bun venit. Ai schimbat în fișier mesajul în Rezervari deschise, iar kubectl apply dă pod updates may not change fields. Recreează podul din fișier, ca să primească variabila nouă.

Indiciu

kubectl replace --force -f șterge podul și îl creează din nou.

Alte forme ale mesajului

  • error: pods "p" is invalid A copy of your changes has been stored to "/tmp/kubectl-edit-1234.yaml"

Cum o eviți pe viitor

  • Nu rula aplicații ca poduri simple: folosește Deployment, StatefulSet sau Job.
  • Modifică șablonul (spec.template) al controllerului, nu podurile create de el.
  • Pentru poduri de test, ține manifestul în fișier și recreează-l cu kubectl replace --force -f.
  • Folosește kubectl diff -f înainte de apply, ca să vezi dacă modificarea atinge câmpuri care nu se pot schimba.

Întrebări frecvente

De ce imaginea se poate schimba, dar variabilele nu?

Kubelet-ul poate opri containerul și porni altul cu altă imagine în același pod. Variabilele, porturile și volumele țin de felul în care a fost creat podul, așa că schimbarea lor cere un pod nou.

Ce se întâmplă dacă modific un pod creat de Deployment?

Chiar și schimbările permise sunt anulate la următoarea recreare: Deploymentul creează podurile din șablonul lui, nu din podul modificat.

Erori înrudite

← Toate erorile Kubernetes

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Kubernetes de la zero, cu exerciții la fiecare lecție

Curs Kubernetes: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 12 lecții sunt gratuite.