502 Bad Gateway
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
kubectl expose deploy magazin --port=80 --target-port=80 # aplicația ascultă pe 8080kubectl patch svc magazin -p '{"spec":{"ports":[{"port":80,"targetPort":8080}]}}'Controllerul se conectează la targetPort-ul podului.
2Aplicația vorbește HTTPS
# podul ascultă TLS pe 8443metadata:
annotations:
nginx.ingress.kubernetes.io/backend-protocol: HTTPSControllerul trebuie să știe ce protocol folosește backend-ul.
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.
Reparația
Pagina și porturile:
curl -s http://ceai.local | grep title
kubectl describe svc ceai | grep -E 'TargetPort|Endpoints'<head><title>502 Bad Gateway</title></head>
TargetPort: 80/TCP
Endpoints: 10.244.2.2:80targetPort corect:
kubectl patch svc ceai -p '{"spec":{"ports":[{"port":80,"targetPort":8080}]}}'
k8ssim avans 5
curl -s -o /dev/null -w '%{http_code}\n' http://ceai.localservice/ceai patched
Au trecut 5 secunde (ora clusterului: 10:00:41).
200De ce merge
Controllerul de Ingress se conecta la portul 80 al podurilor, unde magazinul nu ascultă, deci primea refuz și răspundea cu 502. Cu targetPort: 8080, conexiunea ajunge la aplicație. Ingress-ul nu se schimbă, pentru că el folosește portul serviciului (80), care a rămas același.
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 decontainerPortdin 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
wget: can't connect to remote host (10.96.118.62): Connection refused Numele serviciului s-a rezolvat (avem IP-ul), dar conexiunea e refuzată: fie targetPort-ul serviciului nu e portul pe care ascultă containerul, fie serviciul nu are endpoint-uri. Compară targetPort cu containerPort și verifică kubectl get endpoints. 503 Service Temporarily Unavailable ingress-nginx a găsit regula, dar serviciul din spate nu are niciun pod pregătit (endpoint-uri goale), nu există sau portul din Ingress nu e un port al serviciului. Verifică kubectl get endpoints pentru serviciul din backend și numele și portul din regulă. 404 Not Found (nginx, de la ingress-nginx) Cererea a ajuns la controllerul ingress-nginx, dar nicio regulă nu se potrivește cu hostul sau calea cerută, așa că răspunde backend-ul implicit cu 404. Verifică host-ul și path-ul din Ingress față de URL-ul folosit. Î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.
