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

The Job "import" is invalid: spec.template: Invalid value: core.PodTemplateSpec{...}: field is immutable

Pe scurt

Ș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ă

Greșit
YAML
# job.yaml: command schimbată
kubectl apply -f job.yaml
Corect
YAML
kubectl delete job import
kubectl apply -f job.yaml

Job-ul vechi trebuie șters; cel nou rulează cu șablonul nou.

2Același nume la fiecare livrare

Greșit
YAML
metadata:
  name: migrare
Corect
YAML
metadata:
  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

Greșit
YAML
spec:
  template: ...
Corect
YAML
spec:
  ttlSecondsAfterFinished: 600
  template: ...

Cu TTL, Job-ul terminat e șters automat și numele se eliberează.

Repară tu

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.

Cum o eviți pe viitor

  • Tratează Job-urile ca rulări de unică folosință: nume nou sau ștergere înainte de fiecare rulare.
  • Pune ttlSecondsAfterFinished pe 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

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