The Job "import" is invalid: spec.template: Invalid value: core.PodTemplateSpec{...}: field is immutable
Șablonul podului unui Job nu se mai poate modifica după creare. Ca să rulezi Job-ul cu altă comandă sau imagine, șterge-l și creează-l din nou (kubectl delete job, apoi apply), sau dă-i alt nume la fiecare rulare.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un Job descrie o rulare anume: odată creat, podurile lui sunt create din șablonul de atunci, iar Kubernetes nu permite schimbarea șablonului (spec.template), nici a selectorului sau a completions în modul obișnuit. Mesajul conține tot șablonul, într-o formă greu de citit, dar important e finalul: field is immutable.
Apare des în pipeline-uri care aplică la fiecare livrare același fișier de Job (de exemplu o migrare de bază de date) cu altă imagine sau altă comandă. Prima livrare merge, a doua se oprește aici.
Soluțiile: ștergi Job-ul vechi înainte (kubectl delete job import --ignore-not-found), îi dai un nume unic pe rulare (import-v2, generateName), sau folosești ttlSecondsAfterFinished, ca Job-urile terminate să dispară singure.
De ce apare: cauzele frecvente
1Aplici același Job cu altă comandă
# job.yaml: command schimbată
kubectl apply -f job.yamlkubectl delete job import
kubectl apply -f job.yamlJob-ul vechi trebuie șters; cel nou rulează cu șablonul nou.
2Același nume la fiecare livrare
metadata:
name: migraremetadata:
name: migrare-v2 # sau generateName: migrare-Un nume nou înseamnă un obiect nou, fără conflict cu cel vechi.
3Job-urile vechi rămân în cluster
spec:
template: ...spec:
ttlSecondsAfterFinished: 600
template: ...Cu TTL, Job-ul terminat e șters automat și numele se eliberează.
Repară eroarea, direct în pagină
Job-ul import (importul de comenzi al unui magazin online) a rulat deja raportul pe o zi. Ai schimbat în ~/k8s/import.yaml argumentele la --zile 7, iar kubectl apply dă spec.template: field is immutable. Rulează din nou Job-ul cu argumentele noi, sub același nume.
Indiciu
Șterge Job-ul vechi, apoi aplică fișierul.
Reparația
apply refuză șablonul nou:
kubectl apply -f import.yaml 2>&1 | grep -o 'field is immutable' || truefield is immutableȘterge și creează din nou:
kubectl delete job import
kubectl apply -f import.yaml
kubectl wait --for=condition=complete job/import --timeout=60s
kubectl logs job/import | tail -2job.batch "import" deleted
job.batch/import created
job.batch/import condition met
Total vânzări: 12810 lei
Raport salvat: /rapoarte/raport-7z.txtDe ce merge
Un Job e o rulare înghețată: șablonul lui nu se modifică după creare, așa că apply refuză noile argumente. Ștergerea elimină Job-ul vechi împreună cu podurile lui, iar apply creează un Job nou cu același nume și cu --zile 7, care rulează imediat.
Cum o eviți pe viitor
- Tratează Job-urile ca rulări de unică folosință: nume nou sau ștergere înainte de fiecare rulare.
- Pune
ttlSecondsAfterFinishedpe Job-urile create automat. - Pentru rulări periodice folosește CronJob, care creează singur Job-uri cu nume unice.
- În Helm, migrările se fac de obicei ca hook-uri cu politică de ștergere.
Întrebări frecvente
De ce Job-ul nu se poate actualiza ca un Deployment?
Pentru că Deploymentul descrie o stare care durează, iar Job-ul o sarcină care se termină. O modificare a șablonului nu ar avea sens pentru podurile deja terminate.
Ștergerea Job-ului șterge și jurnalele?
Da, odată cu podurile lui. Dacă ai nevoie de jurnal, citește-l sau salvează-l înainte de ștergere.
Erori înrudite
The Deployment "web" is invalid: spec.selector: Invalid value: v1.LabelSelector{MatchLabels:map[string]string{"app":"magazin-web"}, MatchExpressions:[]v1.LabelSelectorRequirement(nil)}: field is immutable Selectorul unui Deployment (StatefulSet, DaemonSet) nu se mai poate schimba după creare. Ca să-l schimbi, șterge obiectul și creează-l din nou din fișier (kubectl delete -f, apoi apply -f, sau kubectl replace --force -f), acceptând că podurile se recreează. 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) 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. Warning BackoffLimitExceeded job-controller Job has reached the specified backoff limit Podurile Jobului au eșuat de mai multe ori decât permite backoffLimit (implicit 6), așa că Jobul s-a oprit cu statusul Failed. Citește jurnalul unui pod eșuat, corectează cauza și creează Jobul din nou (un Job eșuat nu se repornește). Î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.
