...
Eroare Kubernetes · Containere care nu pornesc sau cad

Liveness probe failed: HTTP probe failed with statuscode: 404

Pe scurt

Proba de liveness cere o adresă pe care aplicația nu o are (404), iar kubelet-ul crede că aplicația s-a blocat și repornește containerul la nesfârșit. Corectează path-ul probei (de exemplu /health) și portul, ca să indice un endpoint care răspunde 200.

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

Ce înseamnă

Proba de liveness întreabă periodic containerul dacă e „viu”. Pentru httpGet, orice cod între 200 și 399 înseamnă succes; 404, 500 sau lipsa răspunsului înseamnă eșec. După failureThreshold eșecuri la rând (implicit 3), kubelet-ul omoară containerul și îl repornește: în evenimente apare Container X failed liveness probe, will be restarted.

Un 404 înseamnă că aplicația răspunde, deci e sănătoasă, dar nu are calea cerută. E o greșeală de configurare: path scris greșit (/sanatate în loc de /health), alt prefix (/api/health), sau o aplicație care și-a schimbat endpoint-ul într-o versiune nouă.

Simptomul arată ca un crash: restarturi și CrashLoopBackOff, dar jurnalul aplicației e curat, iar ultimul lucru din el e o pornire reușită.

De ce apare: cauzele frecvente

1Path greșit

Greșit
YAML
        livenessProbe:
          httpGet:
            path: /sanatate
            port: 8080
Corect
YAML
        livenessProbe:
          httpGet:
            path: /health
            port: 8080

Aplicația are /health; /sanatate dă 404.

2Lipsește prefixul aplicației

Greșit
YAML
            path: /health   # aplicația servește sub /api
Corect
YAML
            path: /api/health

Path-ul trebuie să fie exact cel la care răspunde aplicația.

3Probă care verifică dependențele

Greșit
YAML
            path: /api/produse   # interoghează baza de date
Corect
YAML
            path: /health   # doar procesul

Dacă proba depinde de baza de date, o problemă a bazei repornește toate podurile fără motiv.

Repară tu

Repară eroarea, direct în pagină

Deploymentul vitrina (academia/magazin:v1, ascultă pe 8080) al unui magazin de flori are o probă de liveness pe /sanatate, iar podurile repornesc continuu. Confirmă din evenimente motivul și schimbă path-ul probei în /health din ~/k8s/vitrina.yaml, apoi aplică fișierul.

Indiciu

Evenimentul Unhealthy arată codul primit; aplicația are endpoint-ul /health.

Alte forme ale mesajului

  • Normal Killing kubelet Container lv failed liveness probe, will be restarted
  • Liveness probe failed: HTTP probe failed with statuscode: 500

Cum o eviți pe viitor

  • Testează endpoint-ul probei din cluster înainte: kubectl exec POD -- wget -qO- localhost:8080/health.
  • Fă proba de liveness simplă: răspunde dacă procesul funcționează, fără să verifice baze de date sau alte servicii.
  • Folosește un initialDelaySeconds sau o startupProbe pentru aplicațiile care pornesc greu.
  • Documentează endpoint-urile de sănătate ale fiecărui serviciu.

Întrebări frecvente

Cum deosebesc un crash de o probă eșuată?

La o probă eșuată, evenimentele arată Unhealthy și failed liveness probe, will be restarted, iar jurnalul aplicației nu are nicio eroare. La un crash, jurnalul anterior arată eroarea, iar Last State are codul aplicației.

Care e diferența față de readiness?

Liveness repornește containerul. Readiness doar îl scoate din Service (podul apare 0/1), fără restart.

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.