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

error: unable to forward port because pod is not running. Current status=Pending

Pe scurt

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

Greșit
YAML
    resources:
      requests:
        cpu: "3"   # nodurile au 2 CPU
Corect
YAML
    resources:
      requests:
        cpu: 500m

Podul trebuie să încapă pe un nod ca să ruleze.

2Port-forward imediat după creare

Greșit
YAML
kubectl apply -f pod.yaml
kubectl port-forward pod/api 8080:3000
Corect
YAML
kubectl apply -f pod.yaml
kubectl wait --for=condition=Ready pod/api --timeout=60s
kubectl port-forward pod/api 8080:3000

Așteaptă ca podul să ruleze.

Repară tu

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.

Alte forme ale mesajului

  • error: unable to forward port because pod is not running. Current status=Failed
  • error: 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

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