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

503 Service Temporarily Unavailable

Pe scurt

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

Greșit
YAML
kubectl create service clusterip blog --tcp=80:80   # selector app=blog, podurile au app=site
Corect
YAML
kubectl patch svc blog -p '{"spec":{"selector":{"app":"site"}}}'

Fără endpoint-uri, controllerul nu are unde trimite cererea.

2Port inexistent în serviciu

Greșit
YAML
backend:
  service:
    name: blog
    port:
      number: 8080   # serviciul are doar 80
Corect
YAML
backend:
  service:
    name: blog
    port:
      number: 80

Portul din Ingress e portul serviciului, nu al containerului.

3Deployment scalat la 0

Greșit
YAML
kubectl scale deploy site --replicas=0
Corect
YAML
kubectl scale deploy site --replicas=2

Fără poduri, nu există endpoint-uri.

Repară tu

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.

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

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