如何部署Kubernetes Dashboard

Kubernetes Dashboard 是一个基于 Web 的用户界面，用于管理和监控 Kubernetes 集群。它提供了一个直观的界面，允许用户查看集群的状态、部署应用程序、管理资源、查看日志等。本文将详细介绍如何部署 Kubernetes Dashboard，并配置其访问权限。

目录

1. 准备工作
2. 部署 Kubernetes Dashboard
3. 配置访问权限
4. 访问 Kubernetes Dashboard
5. 常见问题与解决方案
6. 总结

准备工作

在开始部署 Kubernetes Dashboard 之前，确保你已经具备以下条件：

• 一个正在运行的 Kubernetes 集群。
• kubectl 命令行工具已安装并配置好，能够与集群通信。
• 集群中已经配置了 kubeconfig 文件，并且你有足够的权限来部署和管理资源。

检查 Kubernetes 集群状态

首先，使用以下命令检查 Kubernetes 集群的状态：

kubectl get nodes

确保所有节点都处于 Ready 状态。如果集群中有任何节点未准备好，请先解决这些问题。

安装 kubectl 命令行工具

如果你还没有安装 kubectl，可以通过以下步骤安装：

1. Linux 系统：

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
   chmod +x kubectl
   sudo mv kubectl /usr/local/bin/

1. macOS 系统：

   brew install kubectl

1. Windows 系统：

下载 kubectl.exe 并将其添加到系统的 PATH 环境变量中。

配置 kubeconfig 文件

确保 kubeconfig 文件已正确配置，并且你可以通过 kubectl 与集群通信：

kubectl config view

如果 kubeconfig 文件未正确配置，请参考 Kubernetes 官方文档进行配置。

部署 Kubernetes Dashboard

Kubernetes Dashboard 的部署过程相对简单，主要包括以下几个步骤：

1. 部署 Dashboard 的 YAML 文件。
2. 创建访问 Dashboard 的服务账户和角色绑定。
3. 获取访问令牌。

1. 部署 Dashboard 的 YAML 文件

Kubernetes Dashboard 的官方 YAML 文件可以通过以下命令获取并部署：

kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml

这个命令会部署 Dashboard 的所有必要资源，包括 Deployment、Service、ServiceAccount 等。

2. 创建访问 Dashboard 的服务账户和角色绑定

默认情况下，Kubernetes Dashboard 使用 kubernetes-dashboard 服务账户运行。为了能够访问 Dashboard，我们需要创建一个具有足够权限的服务账户，并将其绑定到适当的角色。

创建一个名为 dashboard-adminuser.yaml 的文件，内容如下：

apiVersion: v1
kind: ServiceAccount
metadata:
  name: admin-user
  namespace: kubernetes-dashboard
---
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRoleBinding
metadata:
  name: admin-user
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: cluster-admin
subjects:
- kind: ServiceAccount
  name: admin-user
  namespace: kubernetes-dashboard

然后，使用以下命令应用这个文件：

kubectl apply -f dashboard-adminuser.yaml

这将创建一个名为 admin-user 的服务账户，并将其绑定到 cluster-admin 角色，从而赋予它集群管理员权限。

3. 获取访问令牌

为了访问 Dashboard，我们需要获取 admin-user 服务账户的访问令牌。使用以下命令获取令牌：

kubectl -n kubernetes-dashboard create token admin-user

这个命令会输出一个长字符串，这就是访问 Dashboard 所需的令牌。

配置访问权限

Kubernetes Dashboard 默认情况下只能通过集群内部访问。为了从外部访问 Dashboard，我们需要配置一个代理或暴露服务。

1. 使用 kubectl proxy 访问 Dashboard

最简单的方法是使用 kubectl proxy 命令来创建一个本地代理，从而访问 Dashboard。

运行以下命令启动代理：

kubectl proxy

然后，在浏览器中访问以下 URL：

http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/

2. 暴露 Dashboard 服务

如果你希望通过外部网络访问 Dashboard，可以通过以下方式暴露服务：

1. 使用 NodePort：

编辑 kubernetes-dashboard 服务的 YAML 文件，将其类型改为 NodePort：

   kubectl edit service kubernetes-dashboard -n kubernetes-dashboard

找到 type: ClusterIP，将其改为 type: NodePort，然后保存退出。

然后，使用以下命令获取 NodePort：

   kubectl get service kubernetes-dashboard -n kubernetes-dashboard

输出类似于：

   NAME                   TYPE       CLUSTER-IP      EXTERNAL-IP   PORT(S)         AGE
   kubernetes-dashboard   NodePort   10.96.123.123   <none>        443:30000/TCP   10m

在这个例子中，NodePort 是 30000。你可以通过 https://<node-ip>:30000 访问 Dashboard。

1. 使用 LoadBalancer：

如果你在云环境中运行 Kubernetes 集群，可以将服务类型改为 LoadBalancer：

   kubectl edit service kubernetes-dashboard -n kubernetes-dashboard

找到 type: ClusterIP，将其改为 type: LoadBalancer，然后保存退出。

然后，使用以下命令获取 LoadBalancer 的外部 IP：

   kubectl get service kubernetes-dashboard -n kubernetes-dashboard

输出类似于：

   NAME                   TYPE           CLUSTER-IP      EXTERNAL-IP      PORT(S)         AGE
   kubernetes-dashboard   LoadBalancer   10.96.123.123   203.0.113.123   443:30000/TCP   10m

在这个例子中，外部 IP 是 203.0.113.123。你可以通过 https://203.0.113.123 访问 Dashboard。

访问 Kubernetes Dashboard

无论你选择哪种方式访问 Dashboard，最终都需要通过浏览器打开 Dashboard 的 URL。在登录页面中，选择“令牌”选项，并输入之前获取的访问令牌。

登录后，你将看到 Kubernetes Dashboard 的主界面，可以查看集群的状态、部署应用程序、管理资源、查看日志等。

常见问题与解决方案

1. 无法访问 Dashboard

如果你无法访问 Dashboard，请检查以下几点：

• 确保 kubectl proxy 正在运行，或者服务已正确暴露。
• 确保防火墙规则允许访问 Dashboard 的端口。
• 检查 kubectl get service kubernetes-dashboard -n kubernetes-dashboard 的输出，确保服务已正确配置。

2. 访问令牌无效

如果访问令牌无效，请确保你使用的是正确的服务账户令牌。可以通过以下命令重新生成令牌：

kubectl -n kubernetes-dashboard create token admin-user

3. 权限不足

如果你在 Dashboard 中遇到权限不足的问题，请检查服务账户的权限配置。确保 admin-user 服务账户已绑定到 cluster-admin 角色。

总结

Kubernetes Dashboard 是一个强大的工具，可以帮助你更轻松地管理和监控 Kubernetes 集群。通过本文的步骤，你应该能够成功部署并访问 Kubernetes Dashboard。如果你遇到任何问题，请参考常见问题与解决方案部分，或者查阅 Kubernetes 官方文档。

希望本文对你有所帮助，祝你使用 Kubernetes Dashboard 愉快！