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

curl: (7) Failed to connect to localhost port 8080 after 0 ms: Couldn't connect to server

Pe scurt

Pe calculatorul tău nu ascultă nimic pe portul cerut: aplicația rulează în cluster, nu local. Deschide un tunel cu kubectl port-forward (sau folosește NodePort / Ingress) și apoi apelează localhost.

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

Ce înseamnă

Podurile rulează în rețeaua clusterului, nu pe calculatorul tău. Chiar dacă containerul ascultă pe 8080, localhost:8080 de pe laptop nu ajunge la el. curl încearcă să se conecteze, nimeni nu ascultă, iar conexiunea e refuzată imediat (after 0 ms).

Cazuri tipice: ai uitat să pornești port-forward, l-ai oprit (Ctrl+C sau terminal închis), podul s-a repornit și tunelul a căzut, sau ai pornit tunelul pe alt port local.

Variante de acces din exterior: kubectl port-forward (temporar, pentru depanare), un serviciu NodePort (portul 30000+ al unui nod), un LoadBalancer sau un Ingress (http://nume.local în laborator).

De ce apare: cauzele frecvente

1Fără tunel

Greșit
YAML
curl localhost:8080
Corect
YAML
kubectl port-forward svc/magazin 8080:80
curl localhost:8080

Tunelul aduce portul serviciului pe calculatorul tău.

2Tunel pe alt port

Greșit
YAML
kubectl port-forward svc/magazin 9090:80
curl localhost:8080
Corect
YAML
curl localhost:9090

Folosește portul local din stânga.

3Tunel căzut după repornirea podului

Greșit
YAML
# port-forward pod/magazin-abc, podul a fost înlocuit
Corect
YAML
kubectl port-forward svc/magazin 8080:80

Repornește tunelul; svc/ alege un pod nou.

Repară tu

Repară eroarea, direct în pagină

Vrei să vezi pe laptop aplicația unei școli de dans, publicată în cluster prin serviciul dans (port 80). curl localhost:8080 dă Failed to connect. Deschide un tunel de la portul local 8080 la serviciul dans și verifică cu curl.

Indiciu

kubectl port-forward svc/NUME LOCAL:PORT.

Alte forme ale mesajului

  • curl: (7) Failed to connect to 127.0.0.1 port 8080: Connection refused

Cum o eviți pe viitor

  • Pornește port-forward într-un terminal separat și lasă-l deschis cât lucrezi.
  • Verifică tunelurile active înainte de curl.
  • Pentru acces permanent, publică aplicația prin Ingress, nu prin port-forward.
  • Folosește svc/NUME în port-forward, ca tunelul să nu depindă de un pod anume.

Întrebări frecvente

De ce nu pot accesa IP-ul podului de pe laptop?

Pentru că rețeaua podurilor e internă clusterului. Doar nodurile și podurile o văd direct.

Port-forward merge și pentru baze de date?

Da, pentru orice port TCP: kubectl port-forward svc/postgres 5433:5432, apoi psql -h localhost -p 5433.

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.