访问 Azure Kubernetes 服务 (AKS) 中的 Kubernetes Web 仪表板

项目
06/02/2023

Kubernetes 包含一个可用于基本管理操作的 Web 仪表板。使用此仪表板，可以查看应用程序的基本运行状况状态和指标，创建并部署服务，以及编辑现有应用程序。本文介绍如何使用 Azure CLI 访问 Kubernetes 仪表板，然后引导你完成一些基本的仪表板操作。

有关 Kubernetes 仪表板的详细信息，请参阅 Kubernetes Web UI 仪表板。 AKS 使用版本 2.0 及更高版本的开源仪表板。

警告

AKS 仪表板加载项已设置为弃用。

默认情况下，为运行的 Kubernetes 版本低于 1.18 的群集启用 Kubernetes 仪表板。
默认情况下，在 Kubernetes 1.18 或更高版本上创建的所有新群集都将禁用仪表板加载项。
从 Kubernetes 1.19 预览版开始，AKS 将不再支持安装托管的 kube-dashboard 加载项。
启用了加载项的现有群集不会受到影响。用户能够继续将开源仪表板作为用户安装的软件手动安装。

准备阶段

本文档详述的步骤假设你已创建 AKS 群集并已通过该群集建立 kubectl 连接。如果需要创建 AKS 群集，请参阅快速入门：使用 Azure CLI 部署 Azure Kubernetes 服务群集。

还需要安装并配置 Azure CLI 2.6.0 或更高版本。运行 az --version 即可查找版本。如果需要进行安装或升级，请参阅安装 Azure CLI。

禁用 Kubernetes 仪表板

默认情况下，在 K8s 版本低于 1.18 的群集上启用 kube-dashboard 加载项。可以通过运行以下命令禁用加载项。

az aks disable-addons -g myRG -n myAKScluster -a kube-dashboard

启动 Kubernetes 仪表板

警告

AKS 仪表板加载项在版本 1.19+ 中已弃用。

若要在群集上启动 Kubernetes 仪表板，请使用 az aks browse 命令。此命令要求在群集上安装 kube-dashboard 加载项，运行任何低于 Kubernetes 1.18 的版本的群集都默认包含该加载项。

以下示例将为 myResourceGroup 资源组中的 myAKSCluster 群集打开仪表板：

# Enable kube-dashboard addon before start the kubernetes dashboard
az aks enable-addons --addons kube-dashboard --resource-group myResourceGroup --name myAKSCluster

az aks browse --resource-group myResourceGroup --name myAKSCluster

此命令在开发系统与 Kubernetes API 之间创建一个代理，并在 Web 浏览器中打开 Kubernetes 仪表板。如果 Web 浏览器未打开到 Kubernetes 仪表板，请复制并在 Azure CLI 中粘贴所记录的 URL 地址，通常为 http://127.0.0.1:8001。

注意

如果在 http://127.0.0.1:8001 没有看到仪表板，则可以手动路由到以下地址。运行 1.16 或更高版本的群集使用 https 并需要单独的终结点。

K8s 1.16 或更高版本：http://127.0.0.1:8001/api/v1/namespaces/kube-system/services/https:kubernetes-dashboard:/proxy
K8s 1.15 及更低版本：http://127.0.0.1:8001/api/v1/namespaces/kube-system/services/kubernetes-dashboard:/proxy

重要

从 Kubernetes 仪表板 v1.10.1 或 kubernetes v1.16 + 开始，由于该版本中的安全修补程序，服务帐户“kubernetes-dashboard”不再能够用于检索资源。因此，没有身份验证信息的请求会返回 401 未授权错误。从服务帐户检索的持有者令牌仍可通过此 Kubernetes 仪表板示例中的方式使用，但与早期版本相比，这会影响仪表板加载项的登录流。

如果仍运行 1.16 之前的版本，则仍可向“kubernetes-dashboard”服务帐户授予权限，但不建议这样做：

kubectl create clusterrolebinding kubernetes-dashboard --clusterrole=cluster-admin --serviceaccount=kube-system:kubernetes-dashboard

显示的初始屏幕要求提供 kubeconfig 或令牌。这两个选项都要求提供资源权限才会在仪表板中显示这些资源。

使用 kubeconfig

对于启用了 Azure AD 的群集和启用了非 Azure AD 的群集，都可以传入kubeconfig。确保访问令牌有效，如果令牌已过期，则可以通过 kubectl 刷新令牌。

使用 az aks get-credentials -a --resource-group <RG_NAME> --name <CLUSTER_NAME> 设置管理员 kubeconfig
选择 Kubeconfig 并单击 Choose kubeconfig file 打开文件选择器
选择 kubeconfig 文件（默认为 $HOME/.kube/config）
单击 Sign In

使用令牌

对于启用了非 Azure AD 的群集，运行 kubectl config view 并复制与群集的用户帐户关联的令牌。
登录时，粘贴到令牌选项中。
单击 Sign In

对于启用了 Azure AD 的群集，使用以下命令检索 AAD 令牌。验证是否已替换命令中的资源组和群集名称。

## Update <RESOURCE_GROUP and <AKS_NAME> with your input.

kubectl config view -o jsonpath='{.users[?(@.name == "clusterUser_<RESOURCE GROUP>_<AKS_NAME>")].user.auth-provider.config.access-token}'

成功后，将显示类似如下的页面。

The overview page of the Kubernetes web dashboard