** server can't find plati-api.default.svc.cluster.local: NXDOMAIN
DNS-ul clusterului nu cunoaște numele: serviciul nu există în namespace-ul căutat. De obicei serviciul e în alt namespace; folosește numele cu namespace (plati-api.plati) sau numele complet (plati-api.plati.svc.cluster.local).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
nslookup (din busybox) arată cum caută podul numele: un nume scurt e completat cu domeniile de căutare din /etc/resolv.conf, primul fiind NAMESPACE_POD.svc.cluster.local. Mesajul NXDOMAIN (non-existent domain) înseamnă că serverul DNS (CoreDNS) a răspuns că numele nu există.
Cazul tipic: aplicația din default apelează plati-api, dar serviciul e în namespace-ul plati. Numele scurt devine plati-api.default.svc.cluster.local, care nu există. Soluția: plati-api.plati (sau numele complet).
Dacă și numele complet dă NXDOMAIN, serviciul nu există deloc (kubectl get svc -A | grep plati). Dacă nslookup dă timeout, problema e la CoreDNS sau la rețea, nu la nume.
De ce apare: cauzele frecvente
1Serviciu în alt namespace
API_URL=http://plati-apiAPI_URL=http://plati-api.platiNumele scurt e căutat doar în namespace-ul podului.
2Domeniu scris greșit
plati-api.plati.svc.clusterplati-api.plati.svc.cluster.localNumele complet se termină cu domeniul clusterului.
3Serviciul nu există
nslookup plati-api.plati # NXDOMAINkubectl get svc -n plati
kubectl expose deployment plati-api -n plati --port=80Fără serviciu nu există nume.
Repară eroarea, direct în pagină
Magazinul (default) apelează API-ul de plăți, care rulează ca serviciul plati-api în namespace-ul plati. Din podul test, nslookup plati-api dă NXDOMAIN. Găsește numele corect și verifică faptul că http://plati-api.plati răspunde din test.
Indiciu
Un nume scurt e căutat doar în namespace-ul podului (default).
Reparația
Numele scurt:
kubectl exec test -- nslookup plati-api || true
kubectl get svc -A | grep platiServer: 10.96.0.10
Address: 10.96.0.10:53
** server can't find plati-api.default.svc.cluster.local: NXDOMAIN
command terminated with exit code 1
plati plati-api ClusterIP 10.96.119.199 <none> 80/TCP 18sNumele cu namespace:
kubectl exec test -- nslookup plati-api.plati
kubectl exec test -- wget -qO- -T 2 http://plati-api.plati | head -3Server: 10.96.0.10
Address: 10.96.0.10:53
Name: plati-api.plati.svc.cluster.local
Address: 10.96.119.199
{"mesaj":"API Academia 1.0.0","rute":["/api/produse","/api/status","/health"]}De ce merge
Numele scurt a fost completat cu default.svc.cluster.local, unde nu există niciun serviciu plati-api, deci DNS-ul a răspuns NXDOMAIN. Cu plati-api.plati, căutarea ajunge în namespace-ul corect, iar CoreDNS întoarce ClusterIP-ul serviciului. Aplicația trebuie configurată cu acest nume.
Alte forme ale mesajului
nslookup: can't resolve 'plati-api'** server can't find plati-api: NXDOMAIN
Cum o eviți pe viitor
- Folosește mereu
serviciu.namespacecând apelezi alt namespace. - Ține URL-urile serviciilor în ConfigMap-ul aplicației, nu în cod.
- Testează cu
kubectl exec POD -- nslookup NUMEînainte să depanezi aplicația. - Verifică
/etc/resolv.confdin pod când rezolvarea se comportă ciudat.
Întrebări frecvente
Ce înseamnă NXDOMAIN?
Că serverul DNS a răspuns clar: numele nu există. E diferit de timeout, care înseamnă că serverul nu a răspuns.
De ce trebuie .svc.cluster.local uneori?
Nu trebuie de obicei: serviciu.namespace e completat automat. Numele complet ajută doar în aplicații care nu folosesc domeniile de căutare.
Erori înrudite
wget: bad address 'catalog-api' 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. Error from server (NotFound): namespaces "magazn" not found Namespace-ul dat cu -n (sau din context) nu există în cluster: e scris greșit sau nu a fost creat încă. Verifică lista cu kubectl get namespaces și folosește numele exact, ori creează-l cu kubectl create namespace înainte să pui obiecte în el. wget: can't connect to remote host (10.96.118.62): Connection refused 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. Î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.
