Azure Kubernetes集群Dashboard开启及访问失败问题咨询

嗨，咱们一步步来排查你在Azure Kubernetes集群上访问Dashboard遇到的问题：

1. 先确认Dashboard组件有没有部署到位 #

首先得检查Dashboard的Pod和服务是否存在，执行这两个命令看看：

kubectl get pods -n kubernetes-dashboard
kubectl get svc -n kubernetes-dashboard

如果没有任何输出，说明Dashboard压根没部署。现在新的Kubernetes版本默认不会预装Dashboard，你得手动装一下——可以用官方推荐的部署清单，把对应版本的YAML内容存成本地文件（比如dashboard.yaml），然后执行：

kubectl apply -f dashboard.yaml

要是不确定对应哪个版本，去Kubernetes Dashboard官方文档找和你集群K8s版本匹配的部署文件就行。

2. 检查端口转发的配置对不对 #

你尝试访问127.0.0.1/ui，应该是用了kubectl端口转发，但这里可能有两个坑：

• 首先，Dashboard默认用的是HTTPS的8443端口，不是HTTP的80端口；而且新版本的Dashboard已经去掉了/ui这个路径，直接访问根路径就好。
• 正确的端口转发命令应该是这样：

kubectl port-forward svc/kubernetes-dashboard -n kubernetes-dashboard 8001:443

之后你得用https://127.0.0.1:8001访问（注意是HTTPS，不是HTTP），别再用/ui后缀了。

3. 权限配置是不是没跟上 #

就算Dashboard部署好了，权限不够也会导致访问失败。给你一套快速配置管理员权限的步骤：

• 先创建一个服务账户：

kubectl create serviceaccount admin-user -n kubernetes-dashboard

• 把这个账户绑定到集群管理员角色：

kubectl create clusterrolebinding admin-user-binding --clusterrole cluster-admin --serviceaccount=kubernetes-dashboard:admin-user

• 然后获取访问用的令牌：

kubectl get secret -n kubernetes-dashboard $(kubectl get serviceaccount admin-user -n kubernetes-dashboard -o jsonpath="{.secrets[0].name}") -o jsonpath="{.data.token}" | base64 --decode

复制输出的令牌字符串，在Dashboard的登录界面粘贴进去就能访问了。

4. Azure环境特有的检查点 #

如果你用的是Azure AKS（原ACS），还得确认这几点：

• 集群连接是否正常：执行kubectl cluster-info，要是能返回API服务器的地址，说明本地和集群的通信没问题。
• 有没有正确获取集群凭据：用Azure CLI执行az aks get-credentials --resource-group <你的资源组名称> --name <你的集群名称>，确保kubectl已经关联到你的Azure集群。
• 网络安全组（NSG）或网络策略有没有拦截流量：端口转发是通过kubectl和集群API服务器通信的，得保证你的本地机器能正常访问集群的API服务器端点。

5. 看看Dashboard Pod是不是正常运行 #

如果Dashboard的Pod状态是CrashLoopBackOff或者Error，那得看看日志找原因：

kubectl logs <你的Dashboard Pod名称> -n kubernetes-dashboard

常见的问题比如镜像拉取失败（可能是网络问题）、RBAC权限不足导致Pod启动失败，日志里一般会给出明确的提示。

内容的提问来源于stack exchange，提问作者chaitra