Error: INSTALLATION FAILED: context deadline exceeded
Cu --wait, Helm a așteptat ca podurile să fie Ready, dar timpul (--timeout, implicit 5m) a expirat. Release-ul rămâne failed. Cauza e în poduri (imagine greșită, crash, probe): găsește-o cu kubectl get pods, corectează valorile și refă instalarea.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
helm install --wait (sau upgrade --wait) nu se oprește după crearea obiectelor, ci așteaptă ca Deploymenturile, StatefulSet-urile și Joburile să fie gata. Dacă asta nu se întâmplă în --timeout, Helm marchează release-ul failed și afișează context deadline exceeded. Mesajul nu spune de ce: obiectele rămân în cluster, iar cauza se vede în ele.
Cauze: o imagine sau un tag greșit (ImagePullBackOff), aplicația cade (CrashLoopBackOff), readiness probe-ul nu trece, podurile nu au loc pe noduri (Pending) sau un PVC nu se leagă. Rar, aplicația pornește corect, dar mai încet decât timeout-ul.
Cu --atomic, Helm face singur rollback (sau dezinstalează release-ul la prima instalare).
De ce apare: cauzele frecvente
1Tag greșit
helm install m academia/magazin --set image.tag=v9 --wait --timeout 30shelm uninstall m
helm install m academia/magazin --set image.tag=v2 --wait --timeout 2mCorectezi valoarea și refaci instalarea.
2Timeout prea mic pentru o aplicație lentă
--wait --timeout 30s # aplicația pornește în 90 s--wait --timeout 5mTimeout-ul trebuie să acopere pornirea normală.
3Instalare fără curățenie automată
helm install m academia/magazin --waithelm install m academia/magazin --wait --atomic--atomic curăță singur o instalare eșuată.
Repară eroarea, direct în pagină
Pipeline-ul unei agenții de bilete a instalat release-ul bilete din academia/magazin cu --set image.tag=v9 --wait --timeout 30s, iar Helm a dat context deadline exceeded. Află ce au podurile, dezinstalează release-ul eșuat și instalează-l din nou cu image.tag=v2, tot cu --wait.
Indiciu
kubectl get pods -l app.kubernetes.io/instance=bilete.
Reparația
Release-ul și podurile:
helm list -a
kubectl get pods -l app.kubernetes.io/instance=bileteNAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
bilete default 1 2026-01-15 10:00:04.123460789 +0200 EET failed magazin-0.2.0 v1
NAME READY STATUS RESTARTS AGE
bilete-magazin-s4tmctp97q-frj8f 0/1 ImagePullBackOff 0 33s
bilete-magazin-s4tmctp97q-hrb6d 0/1 ImagePullBackOff 0 33sInstalează din nou, corect:
helm uninstall bilete
helm install bilete academia/magazin --set image.tag=v2 --wait --timeout 2m
helm listrelease "bilete" uninstalled
NAME: bilete
LAST DEPLOYED: Thu Jan 15 10:00:42 2026
NAMESPACE: default
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
Magazinul a fost instalat ca release-ul bilete în namespace-ul default.
Ca să-l vezi în browser:
kubectl port-forward svc/bilete-magazin 8080:80
apoi deschide http://localhost:8080
NAME NAMESPACE REVISION UPDATED STATUS CHART APP VERSION
bilete default 1 2026-01-15 10:00:42.123498789 +0200 EET deployed magazin-0.2.0 v1De ce merge
Tagul v9 nu există, deci podurile au rămas în ImagePullBackOff, iar Helm a așteptat degeaba până la expirarea timpului și a marcat release-ul failed. După dezinstalare, instalarea cu v2 pornește poduri care devin Ready în timpul dat, iar release-ul e deployed.
Alte forme ale mesajului
Error: UPGRADE FAILED: context deadline exceededError: INSTALLATION FAILED: release m failed, and has been uninstalled due to atomic being set: context deadline exceeded
Cum o eviți pe viitor
- Folosește
--wait --atomicîn pipeline, ca un eșec să nu lase release-uri stricate. - Verifică tagurile imaginilor înainte de livrare.
- Alege
--timeoutdupă timpul real de pornire, cu rezervă. - La eșec, afișează automat
kubectl get podsși evenimentele în jurnalul pipeline-ului.
Întrebări frecvente
De ce release-ul apare failed, dar obiectele există?
Pentru că Helm le-a creat, apoi a așteptat degeaba să fie gata. Fără --atomic, nu le șterge.
Pot repara cu helm upgrade?
Da, de obicei un upgrade cu valorile corecte creează o revizie nouă deployed. Dacă nu merge, uninstall și install.
Erori înrudite
error: timed out waiting for the condition on jobs/export 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. Back-off pulling image "academia/magazin:v4" Kubelet-ul a încercat de mai multe ori să descarce imaginea, a eșuat și acum așteaptă înainte de încercarea următoare (ImagePullBackOff). Caută în evenimente motivul primei erori (not found, pull access denied, 401) și corectează imaginea; nu ajută să aștepți. error: deployment "plati" exceeded its progress deadline Rollout-ul nu a avansat în progressDeadlineSeconds (implicit 600 s): podurile noi nu ajung Ready (imagine greșită, crash, probe). Kubernetes nu face rollback automat; revino cu kubectl rollout undo și caută cauza în podurile noi. Î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.
