Kubernetes控制节点重命名全攻略：从证书更新到服务重启的完整流程-优快云博客

Kubernetes控制节点重命名全流程实战指南

在Kubernetes集群运维过程中，控制节点重命名是一个需要谨慎操作的高风险任务。许多管理员在主机名变更后遭遇集群不可用的情况，根本原因在于忽略了证书、配置文件和系统服务的联动更新。本文将用生产环境验证过的完整方案，带你步步为营完成这一关键操作。

1. 前期准备与环境检查

执行任何可能影响集群稳定的操作前，完善的准备工作能避免灾难性后果。首先通过以下命令确认当前节点状态：

kubectl get nodes -o wide
hostnamectl status
ls -l /etc/kubernetes/pki/

需要特别检查的关键项：

当前控制节点的角色标签（通常包含control-plane或master）
/etc/kubernetes目录下的证书有效期
kubelet服务状态是否正常

重要提醒：操作前必须对以下目录进行完整备份
/etc/kubernetes
/var/lib/kubelet
$HOME/.kube

建议使用rsync进行增量备份：

BACKUP_DIR=/opt/k8s_backup_$(date +%Y%m%d)
mkdir -p $BACKUP_DIR
rsync -avz /etc/kubernetes $BACKUP_DIR/
rsync -avz /var/lib/kubelet $BACKUP_DIR/

2. 主机名变更与系统配置更新

修改主机名不是简单的hostnamectl命令就能完成的，需要同步更新多个系统配置文件：

# 永久修改主机名
sudo hostnamectl set-hostname new-control-node

接着需要手动更新以下文件中的旧主机名引用：

/etc/hosts
/etc/hostname
/etc/cloud/cloud.cfg（如果存在）

验证修改是否生效：

hostnamectl status
ping -c 1 $(hostname)

典型问题排查：

重启后主机名恢复原值 → 检查/etc/cloud/cloud.cfg中的preserve_hostname配置
节点间无法解析 → 确保所有节点的/etc/hosts同步更新

3. Kubernetes核心组件配置调整

3.1 静态Pod清单修改

控制平面组件以静态Pod方式运行，其定义文件需要更新：

cd /etc/kubernetes/manifests
grep -r "old-hostname" .  # 定位需要修改的文件

需要修改的主要文件：

etcd.yaml
kube-apiserver.yaml
kube-controller-manager.yaml
kube-scheduler.yaml

修改示例：

# etcd.yaml片段修改
spec:
  containers:
  - command:
    - etcd
    - --advertise-client-urls=https://new-control-node:2379
    - --initial-advertise-peer-urls=https://new-control-node:2380
    - --listen-peer-urls=https://new-control-node:2380

3.2 ConfigMap更新

集群关键配置存储在ConfigMap中，需要逐个更新：

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

需要特别注意kubeadm-config中的这些字段：

apiServer:
  certSANs:
  - "new-control-node"
localAPIEndpoint:
  advertiseAddress: x.x.x.x
  bindPort: 6443
nodeRegistration:
  name: "new-control-node"

4. 证书体系重建

这是最关键的步骤，错误的证书配置会导致API服务不可用。

4.1 证书备份与清理

# 创建备份目录
mkdir -p /etc/kubernetes/pki/backup_{date +%s}

# 移动旧证书（注意保留CA证书）
mv /etc/kubernetes/pki/apiserver.* /etc/kubernetes/pki/backup/
mv /etc/kubernetes/pki/etcd/server.* /etc/kubernetes/pki/backup/

4.2 生成新证书

使用kubeadm分阶段生成证书：

kubeadm init phase certs all --config /etc/kubernetes/kubeadm-config.yaml

验证证书信息：

openssl x509 -in /etc/kubernetes/pki/apiserver.crt -text -noout | grep DNS

4.3 kubeconfig文件更新

kubeadm init phase kubeconfig all
cp /etc/kubernetes/admin.conf ~/.kube/config

5. 节点对象与网络配置

5.1 节点信息更新

导出并编辑节点配置：

kubectl get node old-node -o yaml > node.yaml
vi node.yaml  # 修改metadata.name和status.addresses

应用更新：

kubectl delete node old-node
kubectl apply -f node.yaml

5.2 网络插件调整

根据使用的CNI插件不同，可能需要额外操作：

网络插件	需要执行的操作
Calico	更新node资源中的hostname
Flannel	重启所有Pod
Cilium	执行cilium node update

6. 服务重启与验证

有序重启相关服务：

systemctl daemon-reload
systemctl restart containerd
systemctl restart kubelet

验证步骤：

检查节点状态：
```
kubectl get nodes -o wide
```

测试核心功能：

kubectl run test --image=nginx
kubectl get pods -A

检查组件健康状态：
```
kubectl get --raw='/readyz?verbose'
```

7. 后续维护建议

完成主节点重命名后，还需要注意：

更新所有Worker节点的kubelet配置中对应的API Server地址
检查Ingress Controller等组件中的节点选择器
更新监控系统中的节点标签配置
修改CI/CD流水线中的节点引用

我在实际运维中遇到过kube-proxy因节点名变更导致iptables规则异常的情况，解决方法是：

kubectl -n kube-system delete pod -l k8s-app=kube-proxy