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

wget: download timed out

Pe scurt

Conexiunea nu e refuzată, ci ignorată: un NetworkPolicy blochează traficul, iar pachetele sunt aruncate fără răspuns. Verifică politicile din namespace-ul destinației și etichetele podului client; adaugă eticheta permisă sau o regulă nouă.

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

Ce înseamnă

Un NetworkPolicy care selectează un pod și are reguli ingress interzice tot traficul care nu e permis explicit. Pachetele interzise sunt aruncate în tăcere, deci clientul nu primește refuz, ci așteaptă până la timeout: wget: download timed out, curl: (28) Failed to connect ... Timeout was reached, ETIMEDOUT sau SocketTimeoutException în aplicații.

Timeout-ul e indiciul: o conexiune refuzată înseamnă de obicei port sau endpoint greșit, iar un timeout, de obicei o politică sau un firewall.

Cauze: clientul nu are eticheta cerută de from.podSelector, clientul e în alt namespace (iar podSelector singur se referă doar la namespace-ul politicii), portul nu e listat în ports, sau există o politică default-deny fără excepții. kubectl describe networkpolicy arată regulile pe înțeles.

De ce apare: cauzele frecvente

1Client fără eticheta permisă

Greșit
YAML
from:
- podSelector:
    matchLabels:
      rol: api
# clientul are rol: raport
Corect
YAML
kubectl label pod raport rol=api   # sau o regulă nouă pentru rol=raport

Doar podurile cu etichetele din from pot trece.

2Client din alt namespace

Greșit
YAML
from:
- podSelector:
    matchLabels:
      rol: api
Corect
YAML
from:
- namespaceSelector:
    matchLabels:
      kubernetes.io/metadata.name: backend
  podSelector:
    matchLabels:
      rol: api

podSelector singur alege doar din namespace-ul politicii.

3Port nelistat

Greșit
YAML
ports:
- port: 80
Corect
YAML
ports:
- port: 5432

Portul permis trebuie să fie portul destinației.

Repară tu

Repară eroarea, direct în pagină

Baza de date a unui spital veterinar (db) are un NetworkPolicy care permite doar podurile cu rol=api. Noul pod de rapoarte raport are nevoie de acces, dar wget http://db dă download timed out. Adaugă podului raport eticheta rol=api (fără să modifici politica) și verifică accesul.

Indiciu

kubectl describe networkpolicy arată ce etichete sunt permise.

Alte forme ale mesajului

  • curl: (28) Failed to connect to db port 5432 after 2001 ms: Timeout was reached
  • Error: connect ETIMEDOUT 10.96.12.40:5432

Cum o eviți pe viitor

  • Documentează în fiecare NetworkPolicy cine are voie și de ce.
  • Pune etichete de rol (rol: api) pe poduri, folosite consecvent de politici.
  • Testează accesul cu un pod busybox cu etichetele clientului.
  • Când vezi timeout în cluster, verifică întâi kubectl get networkpolicy -A.

Întrebări frecvente

De ce timeout și nu Connection refused?

Pentru că politica aruncă pachetele fără să răspundă. Clientul nu află nimic și așteaptă.

NetworkPolicy funcționează în orice cluster?

Doar dacă pluginul de rețea o implementează (Calico, Cilium; kindnet doar în versiunile noi). Altfel politicile sunt ignorate.

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.