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

The Service "admin" is invalid: spec.ports[0].nodePort: Invalid value: 30080: provided port is already allocated

Pe scurt

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.

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

Ce înseamnă

Un nodePort e deschis pe toate nodurile, deci e unic în tot clusterul, nu doar în namespace. Dacă alt serviciu îl folosește deja, API server-ul refuză noul serviciu cu provided port is already allocated.

Apare când copiezi un manifest dintr-un alt proiect, când instalezi aceeași aplicație în două namespace-uri (dev și prod) cu același nodePort fix, sau când un serviciu vechi, uitat, ocupă portul.

Afli cine ocupă portul cu kubectl get svc -A | grep 30080. De obicei e mai simplu să nu fixezi nodePort-ul: Kubernetes alege unul liber, iar tu îl citești din kubectl get svc.

De ce apare: cauzele frecvente

1Același nodePort în două medii

Greșit
YAML
# dev și prod, ambele cu nodePort: 30080
Corect
YAML
# dev: 30080, prod: 30081 (sau lasă câmpul gol)

nodePort-ul e unic pe tot clusterul.

2Serviciu vechi uitat

Greșit
YAML
kubectl get svc -A | grep 30080   # demo-vechi
Corect
YAML
kubectl delete svc demo-vechi -n demo

Eliberezi portul dacă serviciul vechi nu mai e folosit.

Repară tu

Repară eroarea, direct în pagină

Serviciul site al unei săli de sport folosește deja nodePort: 30080. Acum vrei să publici și panoul de administrare (admin) din ~/k8s/admin.yaml, care cere tot 30080 și e refuzat. Folosește 30081 pentru admin și aplică fișierul.

Indiciu

kubectl get svc -A arată porturile ocupate.

Alte forme ale mesajului

  • spec.ports[0].nodePort: Invalid value: 30100: provided port is already allocated

Cum o eviți pe viitor

  • Nu fixa nodePort-ul decât dacă un sistem extern are nevoie de un port anume.
  • Ține un registru al nodePort-urilor fixe din cluster.
  • În charturi, pune nodePort-ul în valori, diferit pentru fiecare mediu.
  • Curăță serviciile de test după ce nu mai sunt folosite.

Întrebări frecvente

Portul e ocupat în alt namespace. De ce contează?

Pentru că nodePort-ul se deschide pe noduri, care sunt comune tuturor namespace-urilor.

Cum aflu ce port a ales Kubernetes?

kubectl get svc NUME îl arată în coloana PORT(S), de exemplu 80:31544/TCP.

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.