...
Eroare Kubernetes · Helm

Error: INSTALLATION FAILED: context deadline exceeded

Pe scurt

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

Greșit
YAML
helm install m academia/magazin --set image.tag=v9 --wait --timeout 30s
Corect
YAML
helm uninstall m
helm install m academia/magazin --set image.tag=v2 --wait --timeout 2m

Corectezi valoarea și refaci instalarea.

2Timeout prea mic pentru o aplicație lentă

Greșit
YAML
--wait --timeout 30s   # aplicația pornește în 90 s
Corect
YAML
--wait --timeout 5m

Timeout-ul trebuie să acopere pornirea normală.

3Instalare fără curățenie automată

Greșit
YAML
helm install m academia/magazin --wait
Corect
YAML
helm install m academia/magazin --wait --atomic

--atomic curăță singur o instalare eșuată.

Repară tu

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.

Alte forme ale mesajului

  • Error: UPGRADE FAILED: context deadline exceeded
  • Error: 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 --timeout după 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

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