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ă.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Pagina 503 Service Temporarily Unavailable vine de la controllerul ingress-nginx, nu de la aplicație. Înseamnă că hostul și calea s-au potrivit cu o regulă, dar controllerul nu are unde să trimită cererea.
Cauze: serviciul din backend nu are endpoint-uri (selector greșit, poduri care nu sunt Ready, Deployment scalat la 0), numele serviciului din Ingress e greșit, sau portul din backend.service.port nu există în serviciu.
kubectl describe ingress arată backend-urile și, pentru fiecare, endpoint-urile găsite. Dacă vezi <error: endpoints "x" not found> sau o listă goală, ai găsit problema. Pentru comparație, 404 înseamnă că nu s-a potrivit nicio regulă, iar 502 că podul a fost găsit, dar nu răspunde corect.
De ce apare: cauzele frecvente
1Selectorul serviciului nu găsește poduri
kubectl create service clusterip blog --tcp=80:80 # selector app=blog, podurile au app=sitekubectl patch svc blog -p '{"spec":{"selector":{"app":"site"}}}'Fără endpoint-uri, controllerul nu are unde trimite cererea.
2Port inexistent în serviciu
backend:
service:
name: blog
port:
number: 8080 # serviciul are doar 80backend:
service:
name: blog
port:
number: 80Portul din Ingress e portul serviciului, nu al containerului.
3Deployment scalat la 0
kubectl scale deploy site --replicas=0kubectl scale deploy site --replicas=2Fără poduri, nu există endpoint-uri.
Repară eroarea, direct în pagină
Blogul unei cofetării e publicat la http://blog.local prin Ingress-ul blog, către serviciul blog, dar pagina arată 503 Service Temporarily Unavailable. Podurile Deploymentului site au eticheta app=site. Repară selectorul serviciului, ca blogul să răspundă cu 200.
Indiciu
kubectl describe ingress blog și kubectl get endpoints blog.
Reparația
Pagina și endpoint-urile:
curl -s http://blog.local | grep title
kubectl get endpoints blog<head><title>503 Service Temporarily Unavailable</title></head>
NAME ENDPOINTS AGE
blog <none> 28sSelectorul corect:
kubectl patch svc blog -p '{"spec":{"selector":{"app":"site"}}}'
k8ssim avans 5
curl -s -o /dev/null -w '%{http_code}\n' http://blog.localservice/blog patched
Au trecut 5 secunde (ora clusterului: 10:00:41).
200De ce merge
Regula Ingress-ului se potrivea, dar serviciul blog avea selectorul app=blog și niciun endpoint, deci controllerul nu avea unde să trimită cererea. Cu app=site, serviciul găsește podurile, controllerul primește lista de endpoint-uri, iar http://blog.local răspunde cu pagina aplicației.
Alte forme ale mesajului
<html><head><title>503 Service Temporarily Unavailable</title></head>default backend - 503
Cum o eviți pe viitor
- După ce creezi un Ingress, rulează
kubectl describe ingressși verifică endpoint-urile fiecărui backend. - Creează serviciile cu
kubectl expose, ca selectorul să fie corect. - Folosește numele portului serviciului în Ingress (
port.name: http). - Testează serviciul din cluster înainte să-l publici prin Ingress.
Întrebări frecvente
De ce 503 și nu 502?
503 înseamnă că nu există niciun pod în spate. 502 înseamnă că există, dar conexiunea la el a eșuat sau răspunsul a fost invalid.
Aplicația mea nu are nicio pagină 503. De unde vine?
De la nginx-ul controllerului de Ingress, care răspunde în locul aplicației.
Erori înrudite
Endpoints: <none> Serviciul nu are niciun pod în spate: selectorul lui nu se potrivește cu etichetele podurilor sau podurile nu sunt Ready. Compară selectorul (kubectl describe svc) cu etichetele (kubectl get pods --show-labels) și corectează-l. 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. 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. Î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.
