The Service "web" is invalid: spec.ports[0].nodePort: Invalid value: 8080: provided port is not in the valid range. The range of valid ports is 30000-32767
Ai cerut un nodePort în afara intervalului permis de cluster (implicit 30000-32767). Alege un port din interval (de exemplu 30080) sau lasă câmpul gol, ca Kubernetes să aleagă unul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un serviciu NodePort deschide același port pe toate nodurile. Ca să nu intre în conflict cu porturile sistemului, Kubernetes permite doar un interval stabilit la API server (--service-node-port-range, implicit 30000-32767). Orice valoare în afara lui e refuzată cu acest mesaj.
Confuzia vine din cele trei porturi ale unui serviciu: port (portul serviciului în cluster, oricare), targetPort (portul containerului) și nodePort (portul de pe noduri, doar în interval). Cine vrea aplicația pe portul 80 sau 8080 de pe nod încearcă nodePort: 80 și primește eroarea.
Pentru porturi standard (80, 443) din exterior se folosesc Ingress-ul sau un serviciu LoadBalancer, nu NodePort.
De ce apare: cauzele frecvente
1Port standard ca nodePort
ports:
- port: 80
targetPort: 8080
nodePort: 8080 ports:
- port: 80
targetPort: 8080
nodePort: 30080nodePort trebuie să fie între 30000 și 32767.
2Vrei portul 80 din exterior
nodePort: 80# Ingress sau Service de tip LoadBalancerPorturile standard se publică prin Ingress sau load balancer.
Repară eroarea, direct în pagină
Fișierul ~/k8s/web.yaml al unui hotel publică serviciul web ca NodePort cu nodePort: 8080, iar kubectl apply e refuzat. Schimbă nodePort în 30080 (port 80, targetPort 8080 rămân) și aplică fișierul.
Indiciu
Intervalul valid e afișat chiar în mesaj.
Reparația
Refuzul:
kubectl apply -f web.yaml || trueError from server (Invalid): error when creating "web.yaml": The Service "web" is invalid: spec.ports[0].nodePort: Invalid value: 8080: provided port is not in the valid range. The range of valid ports is 30000-32767Un port din interval:
sed -i 's/nodePort: 8080/nodePort: 30080/' web.yaml
kubectl apply -f web.yaml
kubectl get svc webservice/web created
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
web NodePort 10.96.225.224 <none> 80:30080/TCP 2sDe ce merge
nodePort-urile trebuie să fie în intervalul clusterului, 30000-32767, ca să nu intre în conflict cu porturile sistemului de pe noduri. Cu 30080, serviciul e acceptat, iar aplicația e accesibilă pe portul 30080 al oricărui nod. Portul serviciului în cluster rămâne 80.
Alte forme ale mesajului
spec.ports[0].nodePort: Invalid value: 80: provided port is not in the valid range. The range of valid ports is 30000-32767
Cum o eviți pe viitor
- Lasă
nodePortgol dacă nu ai nevoie de un port anume. - Când ai nevoie de un port fix, ține o listă a porturilor alocate în cluster.
- Folosește Ingress pentru site-uri pe 80 și 443.
- Reține diferența dintre
port,targetPortșinodePort.
Întrebări frecvente
Pot schimba intervalul?
Da, din opțiunea API server-ului --service-node-port-range, dar în clustere gestionate (EKS, GKE, AKS) nu ai acces la ea.
De ce nu pot folosi portul 80?
Pentru că ar intra în conflict cu procesele de pe noduri. Intervalul separat evită conflictele.
Erori înrudite
The Service "admin" is invalid: spec.ports[0].nodePort: Invalid value: 30080: provided port is already allocated nodePort-ul cerut e folosit deja de alt serviciu din cluster (din orice namespace). Alege alt port liber din interval sau lasă câmpul gol, ca Kubernetes să aloce automat unul. The Service "web" is invalid: spec.type: Unsupported value: "NodePrt": supported values: "ClusterIP", "ExternalName", "LoadBalancer", "NodePort" Tipul serviciului e scris greșit. Valorile permise sunt exact ClusterIP, NodePort, LoadBalancer și ExternalName, cu majusculele lor. Corectează valoarea din manifest. 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.
