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

error: timed out waiting for the condition on jobs/export

Pe scurt

kubectl wait (sau rollout status --timeout) a așteptat cât i-ai cerut, iar condiția nu a fost îndeplinită. Fie timpul e prea scurt pentru operație, fie obiectul nu va ajunge niciodată în starea așteptată: verifică podurile și jurnalele înainte să mărești timpul.

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

Ce înseamnă

kubectl wait --for=condition=X --timeout=T verifică obiectul până devine adevărată condiția sau până expiră timpul. La expirare scrie timed out waiting for the condition on jobs/export și iese cu cod de eroare, ceea ce oprește un pipeline. Mesajul nu spune de ce: asta trebuie aflat separat.

Două situații: operația merge, dar mai încet decât timpul dat (descărcarea imaginii, pornirea aplicației, un job de câteva minute), caz în care mărești timeout-ul; sau operația nu va reuși niciodată (job care pică, pod Pending, imagine greșită), caz în care un timeout mai mare doar amână eroarea.

Înainte să mărești timpul, uită-te la kubectl get pods, kubectl describe și kubectl logs pentru obiectul așteptat. Aceeași eroare apare și la rollout status --timeout și la helm install --wait.

De ce apare: cauzele frecvente

1Timp prea scurt pentru job

Greșit
YAML
kubectl wait --for=condition=complete job/export --timeout=3s
Corect
YAML
kubectl wait --for=condition=complete job/export --timeout=120s

Jobul are nevoie de timp să descarce imaginea și să ruleze.

2Jobul nu va termina niciodată

Greșit
YAML
kubectl wait --for=condition=complete job/migrare --timeout=600s   # jobul pică
Corect
YAML
kubectl logs job/migrare
# corectezi cauza, apoi aștepți

Un timeout mai mare nu repară un job care pică.

3Condiție greșită

Greșit
YAML
kubectl wait --for=condition=Ready job/export
Corect
YAML
kubectl wait --for=condition=complete job/export

Joburile au condițiile Complete și Failed, nu Ready.

Repară tu

Repară eroarea, direct în pagină

Pipeline-ul unui magazin online pornește jobul export (academia/raport:1.0, raport --zile 30) și așteaptă cu kubectl wait --for=condition=complete job/export --timeout=3s, care dă timed out. Verifică dacă jobul merge, apoi așteaptă-l cu un timeout de 120s.

Indiciu

kubectl get pods -l job-name=export și kubectl logs job/export arată dacă jobul lucrează.

Alte forme ale mesajului

  • error: timed out waiting for the condition on pods/api-7d9f8b6c5-x2kq9
  • error: timed out waiting for the condition
  • Error: INSTALLATION FAILED: context deadline exceeded

Cum o eviți pe viitor

  • Alege timeout-uri realiste: măsoară cât durează operația în mod normal și adaugă o rezervă.
  • În pipeline, când wait eșuează, afișează automat kubectl describe și kubectl logs pentru obiect.
  • Pentru joburi, așteaptă în paralel și condiția failed, ca să nu aștepți degeaba.
  • Folosește condiția potrivită tipului: complete pentru joburi, Ready pentru poduri, Available pentru Deploymenturi.

Întrebări frecvente

Cum aștept ca un job să termine sau să eșueze?

Cu două comenzi wait în paralel (complete și failed) sau cu --for=jsonpath='{.status.succeeded}'=1 combinat cu verificarea stării.

Ce timeout implicit are kubectl wait?

30 de secunde.

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.