AKS集群版本升级后仪表盘版本未同步，需手动升级吗？

架构老林

2026-5-25

AKS集群升级后Kubernetes仪表盘版本未更新的解决办法

嘿，这个问题我之前帮不少开发者处理过——AKS的Kubernetes仪表盘不会自动随集群版本升级，必须手动操作才能更新到匹配的版本。

AKS将Kubernetes核心组件（比如kube-apiserver、kube-controller-manager）和附加组件（像仪表盘、监控工具等）分开管理。升级集群时只会更新核心组件，附加组件需要单独维护，所以仪表盘版本不会跟着自动同步。

首先检查当前仪表盘的部署状态和版本：
执行以下命令查看部署信息：
```
kubectl get deployment kubernetes-dashboard -n kube-system
```
从输出的IMAGE字段可以确认当前使用的是旧版本的仪表盘镜像。
删除旧的仪表盘部署和服务：
先移除旧的部署资源：
```
kubectl delete deployment kubernetes-dashboard -n kube-system
```
同时删除对应的服务（可选，但建议清理干净）：
```
kubectl delete service kubernetes-dashboard -n kube-system
```
部署适配1.9.6集群的仪表盘版本：
针对Kubernetes 1.9.x版本，推荐使用仪表盘v1.8.x或v1.9.x版本（确保版本兼容性）。比如部署v1.9.0版本的仪表盘：
```
kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v1.9.0/src/deploy/recommended/kubernetes-dashboard.yaml
```
验证升级结果：
等待部署完成后，检查仪表盘Pod是否正常运行：
```
kubectl get pods -n kube-system | grep kubernetes-dashboard
```
重新打开Kubernetes仪表盘，就能看到版本已经更新到对应的版本了。