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

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

Pe scurt

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

Greșit
YAML
  ports:
  - port: 80
    targetPort: 8080
    nodePort: 8080
Corect
YAML
  ports:
  - port: 80
    targetPort: 8080
    nodePort: 30080

nodePort trebuie să fie între 30000 și 32767.

2Vrei portul 80 din exterior

Greșit
YAML
    nodePort: 80
Corect
YAML
# Ingress sau Service de tip LoadBalancer

Porturile standard se publică prin Ingress sau load balancer.

Repară tu

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.

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ă nodePort gol 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 și nodePort.

Î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

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