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

Warning BackoffLimitExceeded job-controller Job has reached the specified backoff limit

Pe scurt

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

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

Ce înseamnă

Un Job reîncearcă podurile eșuate, cu pauze din ce în ce mai lungi (10 s, 20 s, 40 s...). După backoffLimit eșecuri, se oprește: condiția Failed cu motivul BackoffLimitExceeded, iar kubectl get job arată Failed și 0/1.

Mesajul nu spune de ce au eșuat podurile. Pentru asta citești jurnalul unui pod eșuat (kubectl logs job/NUME sau kubectl logs POD): o comandă greșită, un fișier lipsă, o bază de date indisponibilă, un argument invalid. Cu restartPolicy: Never podurile eșuate rămân și le poți inspecta.

Un Job eșuat nu se mai repornește, iar șablonul lui e imutabil. După corectare îl ștergi și îl creezi din nou (sau cu alt nume).

De ce apare: cauzele frecvente

1Comandă greșită

Greșit
YAML
-- sh -c 'wc -l /etc/paswd'
Corect
YAML
-- sh -c 'wc -l /etc/passwd'

Jurnalul arată fișierul inexistent.

2Dependență indisponibilă

Greșit
YAML
# jobul pornește înaintea bazei de date
Corect
YAML
# init container care așteaptă baza de date

Jobul nu reîncearcă la infinit, deci dependențele trebuie să fie gata.

3Repornești Jobul eșuat

Greșit
YAML
kubectl apply -f job.yaml   # job eșuat, șablon schimbat
Corect
YAML
kubectl delete job import
kubectl apply -f job.yaml

Șablonul e imutabil; Jobul se recreează.

Repară tu

Repară eroarea, direct în pagină

Jobul numara al unui hotel (busybox:1.36, backoffLimit: 2) trebuia să numere liniile din /etc/passwd, dar are statusul Failed cu BackoffLimitExceeded. Citește jurnalul, corectează calea și creează Jobul din nou cu același nume, ca să termine cu succes.

Indiciu

kubectl logs job/numara; Jobul se șterge și se creează din nou.

Alte forme ale mesajului

  • Job has reached the specified backoff limit
  • BackoffLimitExceeded

Cum o eviți pe viitor

  • Folosește restartPolicy: Never ca să păstrezi podurile eșuate pentru jurnale.
  • Testează comanda jobului într-un pod temporar (kubectl run --rm -it) înainte de Job.
  • Setează backoffLimit după natura jobului: mic pentru erori permanente, mai mare pentru erori de rețea.
  • Pune ttlSecondsAfterFinished ca joburile vechi să fie curățate automat.

Întrebări frecvente

Cum văd jurnalul unei încercări anume?

kubectl get pods -l job-name=NUME listează podurile, iar kubectl logs POD arată jurnalul fiecăruia.

Pot reporni un Job eșuat?

Nu direct. Îl ștergi și îl creezi din nou; la un CronJob, poți crea un Job nou cu kubectl create job --from=cronjob/NUME.

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.