kubernetesui/dashboard-auth

Kubernetes Dashboard 镜像文档

1. 镜像概述和主要用途

Kubernetes Dashboard 是一个通用的、基于 Web 的 Kubernetes 集群管理界面。作为官方推荐的可视化管理工具，该镜像提供了直观的 UI 界面，允许用户通过浏览器便捷地管理集群中运行的应用程序、排查故障，并对集群本身进行配置和监控。其核心价值在于降低 Kubernetes 集群的使用门槛，提高管理效率，适用于开发、运维及集群管理员等各类用户。

2. 核心功能和特性

2.1 集群资源可视化与监控

• 实时展示集群节点、Pod、服务、部署等核心资源的运行状态和 metrics 数据。
• 支持资源使用率（CPU、内存、存储）的图表化展示，便于快速识别性能瓶颈。

2.2 工作负载全生命周期管理

• 支持创建、编辑、删除 Deployment、StatefulSet、DaemonSet、Job 等 Kubernetes 工作负载。
• 提供 Pod 级别的详细信息查看，包括状态、事件、容器日志及资源占用情况。

2.3 服务与网络配置

• 管理 Service、Ingress、Endpoint 等网络资源，支持配置端口映射、负载均衡规则。
• 可视化展示网络拓扑，便于理解服务间依赖关系。

2.4 配置与存储管理

• 支持 ConfigMap、Secret、PersistentVolume（PV）、PersistentVolumeClaim（PVC）等配置和存储资源的创建、编辑与管理。
• 提供 Secret 敏感信息的加密展示，避免明文泄露。

2.5 多用户认证与权限控制

• 集成 Kubernetes RBAC（基于角色的访问控制），支持通过 Token、kubeconfig 等方式认证。
• 根据用户角色动态展示可操作资源，确保权限最小化原则。

2.6 故障排查工具

• 直接查看 Pod 容器日志，支持日志过滤和实时刷新。
• 展示资源事件历史，辅助定位部署失败、运行异常等问题。

3. 使用场景和适用范围

3.1 开发人员日常操作

• 快速部署、更新应用程序，查看部署状态和日志。
• 通过 UI 界面验证资源配置（如环境变量、挂载存储）是否生效。

3.2 运维人员集群监控

• 实时监控集群节点健康状态、资源使用率，及时发现异常节点。
• 批量管理多租户资源，配置资源配额和限制。

3.3 新手用户学习与上手

• 通过可视化界面直观理解 Kubernetes 资源关系（如 Deployment 与 Pod、Service 与 Endpoint）。
• 降低命令行操作门槛，快速熟悉集群管理流程。

3.4 生产环境辅助管理

• 作为命令行工具（kubectl）的补充，提供图形化批量操作能力。
• 支持导出资源配置 yaml，便于版本化管理和备份。

4. 使用方法和配置说明

4.1 前提条件

• 已安装 Docker 环境（推荐 20.10+ 版本）。
• 需连接到 Kubernetes 集群（本地集群如 Minikube、Kind，或远程集群），且宿主机可访问集群 API 服务器（默认地址 https://<集群IP>:6443）。
• 若使用远程集群，需准备有效的 kubeconfig 文件（包含集群认证信息）。

4.2 Docker 部署示例

4.2.1 使用 docker run 命令部署

通过 Docker 直接启动 Dashboard 容器，需指定集群 API 地址或挂载 kubeconfig 文件：

bash
docker run -d \
  --name kubernetes-dashboard \
  -p 8443:8443 \  # 映射安全端口（HTTPS）
  -p 8080:8080 \  # 可选：映射非安全端口（HTTP，仅测试用）
  -v /path/to/your/kubeconfig:/etc/kubernetes/dashboard/kubeconfig \  # 挂载本地 kubeconfig
  -e KUBECONFIG=/etc/kubernetes/dashboard/kubeconfig \  # 指定 kubeconfig 路径
  --restart=always \
  k8s.gcr.io/dashboard/kubernetes-dashboard:v2.7.0  # 替换为目标版本

注意：生产环境必须使用 HTTPS（8443 端口），并通过 kubeconfig 或 Token 认证；HTTP（8080 端口）仅用于测试，禁止暴露公网。

4.2.2 使用 docker-compose 部署

创建 docker-compose.yml 文件，配置如下：

yaml
version: '3'
services:
  kubernetes-dashboard:
    image: k8s.gcr.io/dashboard/kubernetes-dashboard:v2.7.0
    container_name: kubernetes-dashboard
    ports:
      - "8443:8443"
      - "8080:8080"  # 测试用，生产环境可删除
    volumes:
      - /path/to/your/kubeconfig:/etc/kubernetes/dashboard/kubeconfig
    environment:
      - KUBECONFIG=/etc/kubernetes/dashboard/kubeconfig
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
    restart: always

启动服务：

bash
docker-compose up -d

4.3 核心配置参数说明

4.3.1 环境变量

4.3.2 启动参数

可通过 docker run 命令追加启动参数，覆盖默认配置：

• --kubeconfig=<path>：同环境变量 KUBECONFIG，指定认证配置文件。
• --authentication-mode=token,basic：启用认证模式（支持 token/basic/kubeconfig）。
• --insecure-bind-address=0.0.0.0：允许非安全端口绑定到所有网络接口（仅测试用）。
• --enable-skip-login：允许跳过登录（仅测试环境，生产环境禁用）。

4.4 访问与认证

4.4.1 访问 Dashboard

• HTTPS 访问（推荐）：https://<宿主机IP>:8443（首次访问需信任自签名证书）。
• HTTP 访问（测试用）：http://<宿主机IP>:8080（生产环境禁止启用）。

4.4.2 认证方式

• Token 认证（推荐）：通过 kubectl create token dashboard-admin 生成管理员 Token，在登录页面输入。
• Kubeconfig 认证：上传本地 kubeconfig 文件（需包含 cluster、user、context 配置）。
• Basic 认证：需提前在集群中配置 basic-auth Secret，较少使用。

5. 注意事项

5.1 安全性

• 禁止在公网暴露非安全端口（8080），生产环境必须启用 HTTPS（8443）并配置可信证书（替换默认自签名证书）。
• 严格控制 Dashboard 服务账号权限，避免使用 cluster-admin 角色，建议按需分配 edit/view 等细粒度权限。

5.2 版本兼容性

• 镜像版本需与 Kubernetes 集群版本匹配（如 Dashboard v2.7.x 兼容 K8s 1.24+，具体参考 https://github.com/kubernetes/dashboard#compatibility-matrix%EF%BC%89%E3%80%82

5.3 持久化配置

• kubeconfig 文件、证书等敏感配置建议通过 Docker 挂载（-v 参数），避免硬编码到容器镜像中。

6. 参考链接

• 官方 GitHub 仓库：https://github.com/kubernetes/dashboard
• 官方部署文档：https://github.com/kubernetes/dashboard/blob/master/docs/user/installation.md
• 权限配置指南：https://github.com/kubernetes/dashboard/blob/master/docs/user/access-control.md