Ubuntu下执行kubectl apply -f hello-world.yaml命令出现连接拒绝错误

错误原因 #

这个报错是因为kubectl默认尝试连接本地127.0.0.1:8080的Kubernetes API Server，但该端口没有服务监听，通常源于以下情况：

• kubectl的kubeconfig配置未正确指向集群API Server地址
• 本地Kubernetes集群（如minikube、kind）未启动
• API Server使用非默认端口，且未在kubeconfig中配置

解决方案 #

1. 检查并启动本地集群 #

如果使用minikube：

# 查看集群状态
minikube status
# 若集群已停止，启动集群
minikube start

如果使用kind：

# 查看现有集群
kind get clusters
# 若集群未运行，重建集群
kind delete cluster --name <集群名称>
kind create cluster

2. 确认kubectl上下文配置 #

# 查看当前使用的上下文
kubectl config current-context
# 列出所有可用上下文
kubectl config get-contexts
# 切换到正确的集群上下文
kubectl config use-context <目标上下文名称>

3. 验证kubeconfig中的API Server地址 #

# 查看当前kubeconfig详情
kubectl config view

找到clusters节点下的server字段，确认地址是否正确（比如minikube的API Server地址通常是https://192.168.49.2:8443，而非http://localhost:8080）。如果地址错误，可通过集群工具重新生成配置：

# minikube更新上下文配置
minikube update-context

4. 临时跳过验证（不推荐长期使用） #

若确认yaml内容合规，仅需临时绕过验证，可添加参数执行：

kubectl apply -f hello-world.yaml --validate=false

注意：此方法仅绕开验证，未解决根本问题，长期使用可能导致配置不符合集群规范。

5. 检查自建集群的API Server状态 #

如果是自行搭建的集群，检查API Server是否正常监听：

sudo netstat -tulpn | grep kube-apiserver

若API Server未运行，根据集群部署方式重启服务（如systemd管理）：

sudo systemctl restart kube-apiserver

内容的提问来源于stack exchange，提问作者Pravin A L