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

** server can't find plati-api.default.svc.cluster.local: NXDOMAIN

Pe scurt

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

Greșit
YAML
API_URL=http://plati-api
Corect
YAML
API_URL=http://plati-api.plati

Numele scurt e căutat doar în namespace-ul podului.

2Domeniu scris greșit

Greșit
YAML
plati-api.plati.svc.cluster
Corect
YAML
plati-api.plati.svc.cluster.local

Numele complet se termină cu domeniul clusterului.

3Serviciul nu există

Greșit
YAML
nslookup plati-api.plati   # NXDOMAIN
Corect
YAML
kubectl get svc -n plati
kubectl expose deployment plati-api -n plati --port=80

Fără serviciu nu există nume.

Repară tu

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).

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.namespace câ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.conf din 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

← 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.