单节点 K8S IP 修改步骤

原创已于 2025-12-31 10:40:50 修改 · 552 阅读

8 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#kubernetes #容器 #云原生 #tcp/ip

于 2025-12-29 17:39:43 首次发布

适用场景

kubeadm 部署的私有化单节点 K8S 集群（任意网络插件）节点 IP 变更，适配不同网络配置场景，无硬编码固定值。

操作

1. 备份配置

cp -r /etc/kubernetes/ /etc/kubernetes_bak

2. 替换 IP 配置

find /etc/kubernetes/ -type f | xargs -i sed -i 's/旧ip/新ip/g' {}
sed -i 's/旧ip/新ip/g' /etc/hosts

3. 重建 admin.conf

rm -f /etc/kubernetes/admin.conf
kubeadm init phase kubeconfig admin --apiserver-advertise-address 新ip

4. 重建 apiserver 证书

rm -f /etc/kubernetes/pki/apiserver.*
kubeadm init phase certs apiserver --apiserver-advertise-address 新ip

5. 重启服务

systemctl restart docker
systemctl restart kubelet
# kubelet报主机名notfound时执行
# hostnamectl set-hostname 自定义主机名 && systemctl restart kubelet

6. 配置 kubectl

cp -f /etc/kubernetes/admin.conf ~/.kube/config

7. 更新 ConfigMap

kubectl edit cm -n kube-system kube-proxy
kubectl edit cm -n kube-system kubeadm-config

8. 验证集群状态

kubectl -n kube-system get pod

常见故障通用处理方案

1. coredns 提示 /run/flannel/subnet.env 不存在

步骤 1：获取集群真实 flannel 网段配置

# 方式1：从flannel的ConfigMap获取集群总网段
FLANNEL_NETWORK=$(kubectl get cm kube-flannel-cfg -n kube-system -o yaml | grep -oP 'Network: \K.*' | tr -d ' ')
# 方式2：从运行中的flannel Pod获取节点子网（若方式1失败）
FLANNEL_SUBNET=$(kubectl exec -n kube-system $(kubectl get pod -n kube-system | grep flannel | awk '{print $1}') -- env | grep FLANNEL_SUBNET | cut -d'=' -f2)
# 方式3：获取flannel MTU和IPMASQ配置
FLANNEL_MTU=$(kubectl exec -n kube-system $(kubectl get pod -n kube-system | grep flannel | awk '{print $1}') -- env | grep FLANNEL_MTU | cut -d'=' -f2)
FLANNEL_IPMASQ=$(kubectl exec -n kube-system $(kubectl get pod -n kube-system | grep flannel | awk '{print $1}') -- env | grep FLANNEL_IPMASQ | cut -d'=' -f2)

步骤 2：生成适配当前集群的 subnet.env 文件

# 若自动获取失败，可手动替换为集群实际值
echo -e "FLANNEL_NETWORK=${FLANNEL_NETWORK:-10.244.0.0/22}\nFLANNEL_SUBNET=${FLANNEL_SUBNET:-10.244.0.1/24}\nFLANNEL_MTU=${FLANNEL_MTU:-1450}\nFLANNEL_IPMASQ=${FLANNEL_IPMASQ:-true}" > /run/flannel/subnet.env

2. scheduler 日志显示连接旧 IP 超时

reboot

3. 清理异常 Pod / 容器

kubectl delete po -n kube-system $(kubectl get po -n kube-system | grep -E 'coredns|kube-apiserver' | awk '{print $1}') --force
docker rm <异常容器ID> --force