...
Eroare Kubernetes · Services, DNS, Ingress și port-forward

502 Bad Gateway

Pe scurt

Controllerul de Ingress a găsit podurile, dar conexiunea la ele a eșuat: de obicei targetPort-ul serviciului nu e portul aplicației, sau aplicația cade în timpul cererii. Corectează targetPort-ul și verifică jurnalele podurilor.

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

Ce înseamnă

Spre deosebire de 503 (niciun pod), 502 înseamnă că serviciul are endpoint-uri, controllerul a încercat să trimită cererea la un pod, dar a primit refuz sau un răspuns invalid. ingress-nginx se conectează direct la IP-ul și targetPort-ul podurilor, deci un targetPort greșit duce direct la 502.

Alte cauze: aplicația ascultă doar pe 127.0.0.1, aplicația vorbește HTTPS, dar controllerul trimite HTTP (sau invers; se rezolvă cu adnotarea nginx.ingress.kubernetes.io/backend-protocol), sau podul cade în timpul cererii.

Jurnalul controllerului (kubectl logs -n ingress-nginx deploy/ingress-nginx-controller) arată connect() failed (111: Connection refused) while connecting to upstream, cu IP-ul și portul încercat.

De ce apare: cauzele frecvente

1targetPort greșit

Greșit
YAML
kubectl expose deploy magazin --port=80 --target-port=80   # aplicația ascultă pe 8080
Corect
YAML
kubectl patch svc magazin -p '{"spec":{"ports":[{"port":80,"targetPort":8080}]}}'

Controllerul se conectează la targetPort-ul podului.

2Aplicația vorbește HTTPS

Greșit
YAML
# podul ascultă TLS pe 8443
Corect
YAML
metadata:
  annotations:
    nginx.ingress.kubernetes.io/backend-protocol: HTTPS

Controllerul trebuie să știe ce protocol folosește backend-ul.

Repară tu

Repară eroarea, direct în pagină

Magazinul de ceaiuri ceai (academia/magazin:v1, portul 8080) e publicat la http://ceai.local, dar pagina arată 502 Bad Gateway. Serviciul ceai are targetPort: 80. Corectează targetPort la 8080, ca pagina să răspundă cu 200.

Indiciu

502 înseamnă că podurile există, dar portul nu e cel corect.

Alte forme ale mesajului

  • <html><head><title>502 Bad Gateway</title></head>
  • connect() failed (111: Connection refused) while connecting to upstream

Cum o eviți pe viitor

  • Folosește porturi cu nume (targetPort: http) legate de containerPort din pod.
  • Testează serviciul din cluster înainte să-l publici.
  • Citește jurnalul controllerului: spune exact ce adresă a încercat.
  • Configurează aplicațiile să asculte pe 0.0.0.0.
  • Adaugă readiness probe-uri, ca podurile care încă pornesc să nu primească trafic.

Întrebări frecvente

De ce 502 și nu Connection refused?

Pentru că între tine și pod e nginx-ul controllerului. El primește refuzul și îți răspunde cu 502.

Am 502 doar uneori. De ce?

Probabil unele poduri cad sau repornesc. Verifică restarturile cu kubectl get pods și readiness probe-ul.

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.