...
Eroare Kubernetes · kubectl, kubeconfig și conexiunea la cluster

The connection to the server localhost:8080 was refused - did you specify the right host or port?

Pe scurt

kubectl nu găsește niciun kubeconfig și încearcă adresa implicită localhost:8080, unde nu ascultă nimic. Verifică dacă există ~/.kube/config (sau variabila KUBECONFIG) și dacă contextul curent indică spre clusterul tău; la kind îl refaci cu kind get kubeconfig.

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

Ce înseamnă

Mesajul vine de la kubectl, nu de la cluster. Fără un fișier kubeconfig valid, kubectl nu știe unde e API server-ul și folosește o valoare implicită veche, localhost:8080, pe care nu ascultă nimic. De aceea apare la orice comandă, chiar și la kubectl get pods.

Cauzele tipice: lipsește ~/.kube/config (cluster abia instalat, utilizator schimbat, sudo kubectl, care caută în /root/.kube/config), variabila KUBECONFIG indică spre un fișier inexistent sau gol, ori pe un nod de control ai uitat să copiezi /etc/kubernetes/admin.conf.

Ca să afli ce vede kubectl, rulează kubectl config view: dacă iese clusters: null, nu are niciun kubeconfig. Dacă adresa din mesaj e alta (de exemplu 127.0.0.1:6443), kubeconfig-ul există, dar clusterul e oprit sau portul s-a schimbat.

De ce apare: cauzele frecvente

1Lipsește ~/.kube/config

Greșit
YAML
rm ~/.kube/config
kubectl get nodes
Corect
YAML
kind get kubeconfig --name academia > ~/.kube/config
kubectl get nodes

Fără kubeconfig, kubectl nu are adresa API server-ului. kind îți poate genera din nou fișierul pentru clusterul existent.

2KUBECONFIG indică spre un fișier greșit

Greșit
YAML
export KUBECONFIG=~/.kube/cluster-vechi
kubectl get pods
Corect
YAML
unset KUBECONFIG
kubectl config current-context

Variabila KUBECONFIG are prioritate față de ~/.kube/config. Dacă fișierul din ea nu există, kubectl ajunge la valoarea implicită localhost:8080.

3Rulezi kubectl cu sudo

Greșit
YAML
sudo kubectl get pods
Corect
YAML
kubectl get pods

Cu sudo, kubectl caută kubeconfig-ul utilizatorului root, care de obicei nu există. kubectl nu are nevoie de drepturi de root.

Repară tu

Repară eroarea, direct în pagină

Fișierul ~/.kube/config a fost șters din greșeală, iar orice comandă kubectl dă The connection to the server localhost:8080 was refused. Clusterul kind academia merge în continuare. Refă kubeconfig-ul cu ajutorul lui kind și verifică faptul că vezi din nou nodurile clusterului.

Indiciu

kind get kubeconfig --name academia afișează kubeconfig-ul clusterului; redirecționează-l în fișier.

Alte forme ale mesajului

  • The connection to the server 127.0.0.1:6443 was refused - did you specify the right host or port?
  • E1104 10:00:00.000000 memcache.go:265] couldn't get current server API group list: Get "http://localhost:8080/api?timeout=32s": dial tcp 127.0.0.1:8080: connect: connection refused

Cum o eviți pe viitor

  • După instalarea unui cluster (kind, minikube, kubeadm), verifică imediat kubectl config current-context și kubectl get nodes.
  • Nu rula kubectl cu sudo.
  • Dacă lucrezi cu mai multe clustere, păstrează fișierele separat și alege-le explicit cu KUBECONFIG sau --kubeconfig, nu suprascrie ~/.kube/config la întâmplare.
  • Fă o copie a kubeconfig-ului înainte să-l editezi de mână.

Întrebări frecvente

De ce localhost:8080, dacă clusterul meu nu a folosit niciodată portul ăsta?

E o valoare implicită istorică a kubectl, folosită doar când nu găsește nicio configurare. Faptul că apare înseamnă aproape sigur că nu se citește niciun kubeconfig, nu că ar fi ceva greșit în cluster.

Ce fac dacă mesajul arată 127.0.0.1:6443 sau alt port?

Atunci kubeconfig-ul e citit, dar API server-ul nu răspunde: clusterul e oprit (containerul kind, VM-ul minikube), portul s-a schimbat după o repornire sau ești pe alt calculator. Pornește clusterul și verifică adresa din kubectl config view.

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.