...
Eroare Kubernetes · Deployment, rollout, Job, CronJob și HPA

The Job "import" is invalid: spec.template.spec.restartPolicy: Required value: valid values: "OnFailure", "Never"

Pe scurt

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

Greșit
YAML
  template:
    spec:
      containers:
      - name: import
Corect
YAML
  template:
    spec:
      restartPolicy: Never
      containers:
      - name: import

Jobul cere Never sau OnFailure.

2Câmpul pus la nivelul Jobului

Greșit
YAML
spec:
  restartPolicy: Never
  template: ...
Corect
YAML
spec:
  template:
    spec:
      restartPolicy: Never

restartPolicy aparține podului.

3Always explicit

Greșit
YAML
      restartPolicy: Always
Corect
YAML
      restartPolicy: OnFailure

Always nu e permis la Joburi.

Repară tu

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.

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 și backoffLimit completate.
  • Validează manifestele cu kubectl apply --dry-run=server în pipeline.
  • Când transformi un Deployment în Job, verifică întâi restartPolicy și backoffLimit.

Î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

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