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

wget: bad address 'catalog-api'

Pe scurt

Numele cerut nu există în DNS-ul clusterului: nu există niciun serviciu cu acest nume în namespace-ul podului. Creează serviciul (kubectl expose) sau folosește numele exact al serviciului existent.

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

Ce înseamnă

În cluster, numele DNS scurte (catalog-api) sunt rezolvate de CoreDNS doar pentru serviciile din același namespace. wget: bad address (busybox) înseamnă că rezolvarea a eșuat: niciun serviciu cu acel nume. Echivalentul în curl este curl: (6) Could not resolve host, iar în aplicații getaddrinfo ENOTFOUND sau UnknownHostException.

Cauze: Deploymentul există, dar nu a fost expus (un Deployment nu are nume DNS, doar un Service are), numele serviciului diferă de cel din configurarea aplicației, sau serviciul e în alt namespace (atunci trebuie catalog-api.alt-ns).

Verifică cu kubectl get svc și, din pod, cu nslookup catalog-api.

De ce apare: cauzele frecvente

1Deployment neexpus

Greșit
YAML
kubectl create deployment catalog-api --image=academia/api:1.0
# niciun Service
Corect
YAML
kubectl expose deployment catalog-api --port=80 --target-port=3000

Numele DNS aparține Service-ului, nu Deploymentului.

2Nume diferit de cel din configurare

Greșit
YAML
API_URL=http://catalog-api   # serviciul se numește catalog
Corect
YAML
kubectl expose deployment catalog-api --port=80 --target-port=3000   # sau API_URL=http://catalog

Numele din URL trebuie să fie exact numele serviciului.

3Serviciu în alt namespace

Greșit
YAML
wget http://catalog-api
Corect
YAML
wget http://catalog-api.produse

Numele scurt merge doar în același namespace.

Repară tu

Repară eroarea, direct în pagină

Frontend-ul unui magazin de jucării apelează http://catalog-api, dar din podul test vezi wget: bad address 'catalog-api'. Deploymentul catalog-api (academia/api:1.0, portul 3000) există, dar nu are serviciu. Expune-l cu serviciul catalog-api pe portul 80.

Indiciu

kubectl expose deployment catalog-api --port=80 --target-port=3000.

Alte forme ale mesajului

  • curl: (6) Could not resolve host: catalog-api
  • Error: getaddrinfo ENOTFOUND catalog-api

Cum o eviți pe viitor

  • Expune fiecare Deployment care primește trafic cu un Service.
  • Pune URL-urile serviciilor în ConfigMap-uri, cu numele exacte.
  • Testează rezolvarea din cluster cu nslookup dintr-un pod busybox.
  • Folosește numele complet (svc.ns) când apelezi servicii din alte namespace-uri.

Întrebări frecvente

Pot apela un pod după numele lui?

Nu, podurile nu primesc nume DNS după numele lor (cu excepția celor dintr-un StatefulSet cu serviciu headless). Folosește un Service.

De ce numele merge din alt pod, dar nu din acesta?

Probabil podurile sunt în namespace-uri diferite: numele scurt se rezolvă doar în namespace-ul podului care întreabă.

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.