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

wget: can't connect to remote host (10.96.118.62): Connection refused

Pe scurt

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.

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

Ce înseamnă

Mesajul vine de la wget (busybox), rulat într-un pod. Apare după ce DNS-ul a funcționat: IP-ul din paranteză e ClusterIP-ul serviciului. Conexiunea refuzată înseamnă că pe drumul serviciu → pod nu ascultă nimeni.

Cele mai frecvente două cauze: targetPort greșit (serviciul trimite traficul pe portul 80, dar aplicația ascultă pe 8080) sau serviciul fără endpoint-uri (selectorul nu se potrivește cu etichetele podurilor, ori podurile nu sunt Ready). În al doilea caz, kube-proxy respinge direct conexiunea.

Diagnostic rapid: kubectl get endpoints NUME (dacă e gol, e o problemă de selector sau de readiness) și kubectl describe svc NUME (compară TargetPort cu portul containerului). Același mesaj în curl este curl: (7) Failed to connect ... Connection refused.

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}]}}'

targetPort trebuie să fie portul containerului.

2Fără endpoint-uri

Greșit
YAML
selector:
  app: magazin-web   # podurile au app: magazin
Corect
YAML
selector:
  app: magazin

Selectorul alege podurile din spatele serviciului.

3Aplicația ascultă doar pe localhost

Greșit
YAML
# serverul pornește pe 127.0.0.1:8080
Corect
YAML
# serverul pornește pe 0.0.0.0:8080

Traficul vine pe IP-ul podului, nu pe localhost.

Repară tu

Repară eroarea, direct în pagină

Catalogul unei edituri (catalog, academia/magazin:v1, ascultă pe 8080) e expus prin serviciul catalog cu targetPort: 80. Din podul test, wget http://catalog dă Connection refused. Schimbă targetPort la 8080, fără să schimbi portul serviciului (80).

Indiciu

kubectl describe svc catalog arată TargetPort; aplicația ascultă pe 8080.

Alte forme ale mesajului

  • curl: (7) Failed to connect to magazin port 80 after 2 ms: Couldn't connect to server
  • wget: can't connect to remote host (10.96.0.15): Connection refused

Cum o eviți pe viitor

  • Folosește porturi cu nume (targetPort: http) ca serviciul să urmeze portul declarat în container.
  • Verifică kubectl get endpoints imediat după ce creezi un serviciu.
  • Testează din cluster cu un pod busybox înainte să adaugi Ingress-ul.
  • Configurează aplicațiile să asculte pe 0.0.0.0, nu pe 127.0.0.1.

Întrebări frecvente

De ce DNS-ul merge, dar conexiunea nu?

Pentru că DNS-ul rezolvă doar numele serviciului în ClusterIP. Dacă în spatele lui nu ascultă nimic pe portul corect, conexiunea e refuzată.

Cum văd pe ce port ascultă containerul?

kubectl get pod POD -o jsonpath='{.spec.containers[0].ports}' arată porturile declarate. Documentația imaginii spune portul real.

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.