error: unable to forward port because pod is not running. Current status=Pending
port-forward funcționează doar spre un pod care rulează, iar podul ales e încă Pending. Află de ce nu pornește (kubectl describe pod), repară cauza, așteaptă să fie Ready și abia apoi pornește port-forward.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
kubectl port-forward deschide un tunel de pe calculatorul tău către un container. Containerul trebuie să ruleze, deci pentru un pod Pending (neprogramat sau încă descărcând imaginea) kubectl refuză imediat, cu statusul curent în mesaj. Pentru un pod terminat vezi Current status=Succeeded sau Failed.
Când dai port-forward la deploy/NUME sau svc/NUME, kubectl alege un pod al acelui obiect, iar dacă niciunul nu rulează primești aceeași eroare.
Port-forward-ul nu e cauza: problema e de ce podul nu pornește. kubectl describe pod arată evenimentul (FailedScheduling, ErrImagePull). În scripturi, așteaptă cu kubectl wait --for=condition=Ready înainte de port-forward.
De ce apare: cauzele frecvente
1Pod Pending din lipsă de resurse
resources:
requests:
cpu: "3" # nodurile au 2 CPU resources:
requests:
cpu: 500mPodul trebuie să încapă pe un nod ca să ruleze.
2Port-forward imediat după creare
kubectl apply -f pod.yaml
kubectl port-forward pod/api 8080:3000kubectl apply -f pod.yaml
kubectl wait --for=condition=Ready pod/api --timeout=60s
kubectl port-forward pod/api 8080:3000Așteaptă ca podul să ruleze.
Repară eroarea, direct în pagină
Vrei să deschizi local API-ul unei aplicații de rețete (podul api, academia/api:1.0, portul 3000), dar kubectl port-forward pod/api 8080:3000 dă pod is not running. Current status=Pending: podul cere 3 CPU. Recreează podul din ~/k8s/api.yaml cu 500m și pornește port-forward pe 8080.
Indiciu
kubectl describe pod api arată de ce stă în Pending; resursele unui pod nu se schimbă pe loc.
Reparația
Refuzul și cauza:
kubectl port-forward pod/api 8080:3000 || true
kubectl describe pod api | grep FailedScheduling | tail -1error: unable to forward port because pod is not running. Current status=Pending
Warning FailedScheduling 75s default-scheduler 0/3 nodes are available: 2 Insufficient cpu, 1 node(s) had untolerated taint {node-role.kubernetes.io/control-plane: }. preemption: 0/3 nodes are available: 1 Preemption is not helpful for scheduling, 2 No preemption victims found for incoming pod.Resurse corecte și tunel:
kubectl delete pod api
sed -i 's/cpu: "3"/cpu: 500m/' api.yaml
kubectl apply -f api.yaml
kubectl wait --for=condition=Ready pod/api --timeout=60s
kubectl port-forward pod/api 8080:3000
curl -s -o /dev/null -w '%{http_code}\n' http://localhost:8080pod "api" deleted
pod/api created
pod/api condition met
Forwarding from 127.0.0.1:8080 -> 3000
Forwarding from [::1]:8080 -> 3000
200De ce merge
Podul cerea mai mult CPU decât are orice nod, deci rămânea Pending, iar port-forward nu are la ce container să se lege. Cu 500m, podul e programat și pornește, iar după kubectl wait tunelul se deschide: localhost:8080 ajunge la portul 3000 al podului.
Alte forme ale mesajului
error: unable to forward port because pod is not running. Current status=Failederror: unable to forward port because pod is not running. Current status=Succeeded
Cum o eviți pe viitor
- În scripturi, pune
kubectl wait --for=condition=Readyînainte de port-forward. - Dacă podul rămâne Pending, citește evenimentele lui înainte de orice altceva.
- Folosește
port-forward svc/NUME, ca tunelul să ajungă la un pod pregătit al serviciului. - Verifică starea cu
kubectl get podînainte să deschizi tunelul.
Întrebări frecvente
Port-forward se oprește când podul repornește?
Da, tunelul e legat de un pod anume. Repornește comanda după ce podul nou e Ready.
Port-forward e potrivit pentru producție?
Nu, e o unealtă de depanare. Pentru acces permanent folosește un Service, un Ingress sau un VPN.
Erori înrudite
0/3 nodes are available: 2 Insufficient cpu, 1 node(s) had untolerated taint {node-role.kubernetes.io/control-plane: }. preemption: 0/3 nodes are available: 1 Preemption is not helpful for scheduling, 2 No preemption victims found for incoming pod. Niciun nod nu are destul CPU nerezervat pentru requests.cpu al podului, așa că podul rămâne Pending. Coboară requests.cpu la cât folosește aplicația de fapt (de exemplu 500m), eliberează resurse sau adaugă noduri. Unable to listen on port 8080: Listeners failed to create with the following errors: [unable to create listener: Error listen tcp4 127.0.0.1:8080: bind: address already in use]
error: unable to listen on any of the requested ports: [{8080 80}] Portul local cerut (aici 8080) e ocupat pe calculatorul tău, de un port-forward vechi sau de alt program. Alege alt port local (8081:80) sau oprește procesul care îl ocupă. curl: (7) Failed to connect to localhost port 8080 after 0 ms: Couldn't connect to server Pe calculatorul tău nu ascultă nimic pe portul cerut: aplicația rulează în cluster, nu local. Deschide un tunel cu kubectl port-forward (sau folosește NodePort / Ingress) și apoi apelează localhost. Î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.
