The Job "import" is invalid: spec.template.spec.restartPolicy: Required value: valid values: "OnFailure", "Never"
Podurile unui Job (și ale unui CronJob) trebuie să aibă restartPolicy Never sau OnFailure; valoarea implicită Always nu e permisă, pentru că un job trebuie să se poată termina. Adaugă restartPolicy: Never (sau OnFailure) în șablonul podului.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un pod obișnuit are implicit restartPolicy: Always: containerul e repornit oricând se oprește. Pentru un Job asta n-ar avea sens, pentru că jobul n-ar termina niciodată. De aceea validarea cere explicit Never (la eșec, Jobul creează un pod nou) sau OnFailure (containerul e repornit în același pod).
Eroarea apare când transformi un manifest de pod sau Deployment în Job și uiți câmpul, sau când îl pui la nivelul greșit (în spec al Jobului, nu în spec.template.spec). kubectl create job pune singur Never, deci problema apare doar la manifeste scrise de mână.
Cu Never păstrezi podurile eșuate pentru jurnale; cu OnFailure, jurnalul încercărilor anterioare e mai greu de văzut.
De ce apare: cauzele frecvente
1Câmpul lipsește
template:
spec:
containers:
- name: import template:
spec:
restartPolicy: Never
containers:
- name: importJobul cere Never sau OnFailure.
2Câmpul pus la nivelul Jobului
spec:
restartPolicy: Never
template: ...spec:
template:
spec:
restartPolicy: NeverrestartPolicy aparține podului.
3Always explicit
restartPolicy: Always restartPolicy: OnFailureAlways nu e permis la Joburi.
Repară eroarea, direct în pagină
Fișierul ~/k8s/import.yaml definește Jobul import pentru produsele unui depozit, dar kubectl apply e refuzat cu restartPolicy: Required value. Adaugă restartPolicy: Never în șablonul podului și aplică fișierul, apoi verifică faptul că jobul termină cu succes.
Indiciu
Câmpul stă în spec.template.spec, lângă containers.
Reparația
Refuzul:
kubectl apply -f import.yaml || trueError from server (Invalid): error when creating "import.yaml": The Job "import" is invalid: spec.template.spec.restartPolicy: Required value: valid values: "OnFailure", "Never"restartPolicy:
sed -i 's/^ spec:$/ spec:\n restartPolicy: Never/' import.yaml
kubectl apply -f import.yaml
kubectl wait --for=condition=complete job/import --timeout=120s
kubectl logs job/import | tail -1job.batch/import created
job.batch/import condition met
Raport salvat: /rapoarte/raport-7z.txtDe ce merge
Un Job are nevoie ca podurile lui să se poată termina, deci validarea refuză valoarea implicită Always. Cu restartPolicy: Never în spec.template.spec, Jobul e acceptat, creează podul, iar raportul de import rulează o singură dată până la final.
Alte forme ale mesajului
The CronJob "raport" is invalid: spec.jobTemplate.spec.template.spec.restartPolicy: Required value: valid values: "OnFailure", "Never"spec.template.spec.restartPolicy: Unsupported value: "Always": supported values: "OnFailure", "Never"
Cum o eviți pe viitor
- Generează scheletul cu
kubectl create job NUME --image=... --dry-run=client -o yaml. - Ține un șablon de Job în proiect, cu
restartPolicyșibackoffLimitcompletate. - Validează manifestele cu
kubectl apply --dry-run=serverîn pipeline. - Când transformi un Deployment în Job, verifică întâi
restartPolicyșibackoffLimit.
Întrebări frecvente
Never sau OnFailure?
Never păstrează fiecare încercare ca pod separat, cu jurnalul ei. OnFailure repornește containerul în același pod și e mai economic.
De ce un Deployment nu are aceeași problemă?
Pentru că un Deployment acceptă doar Always: aplicațiile lui trebuie să ruleze continuu.
Erori înrudite
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. The CronJob "backup" is invalid: spec.schedule: Invalid value: "0 25 * * *": unparseable schedule: "0 25 * * *" Expresia cron din spec.schedule nu e validă: are o valoare în afara intervalului (ora 25, minutul 60), un număr greșit de câmpuri sau un format necunoscut. Scrie expresia cu 5 câmpuri: minut (0-59), oră (0-23), zi (1-31), lună (1-12), zi a săptămânii (0-6). 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.
