docker/desktop-kubernetes-dashboard-helper

Kubernetes Dashboard (Docker Desktop 内置版)

镜像概述和主要用途

Kubernetes Dashboard (Docker Desktop 内置版) 是Docker Desktop集成的官方可视化管理工具，专为简化Docker Desktop内置Kubernetes集群的管理而设计。作为Kubernetes官方提供的Web UI，该镜像无需额外部署，在用户启用Docker Desktop的Kubernetes功能后自动可用，旨在帮助开发者和管理员直观地监控、管理和调试本地K8s集群资源。

核心功能和特性

集群资源可视化

• 实时展示集群节点、命名空间、Pod、服务、部署(Deployment)、有状态集(StatefulSet)等核心资源的状态和拓扑关系
• 提供资源使用率（CPU、内存、存储）的图表化展示，支持多维度筛选和搜索

工作负载管理

• 支持创建、编辑、删除Deployment、StatefulSet、DaemonSet等工作负载资源
• 提供Pod生命周期管理（启动、停止、重启、删除）及事件追踪功能
• 支持滚动更新、回滚等部署策略的可视化配置

配置与存储管理

• 可视化管理ConfigMap、Secret、PersistentVolumeClaim等配置和存储资源
• 支持密钥(Secret)的安全展示（敏感信息脱敏）和编辑功能

日志与监控集成

• 直接查看Pod容器日志，支持日志过滤和实时刷新
• 集成基础监控指标，展示容器和节点的资源使用趋势

安全与权限控制

• 与Docker Desktop内置Kubernetes的认证机制深度集成，支持基于Service Account的访问控制
• 遵循Kubernetes RBAC权限模型，确保操作符合集群安全策略

简化部署体验

• 无需手动安装或配置，启用Docker Desktop的Kubernetes后自动部署
• 与Docker Desktop UI无缝集成，提供便捷的访问入口

使用场景和适用范围

适用用户

• Docker Desktop用户（Windows/macOS）
• 本地Kubernetes开发环境的开发者
• 学习Kubernetes基础操作的初学者
• 需要快速验证K8s应用部署的测试人员

典型场景

• 开发环境中查看本地K8s集群的资源状态和运行情况
• 调试部署在Docker Desktop K8s集群中的应用程序
• 通过可视化界面学习Kubernetes核心概念和资源关系
• 快速创建和修改测试环境的K8s资源配置
• 监控本地集群的资源使用情况，优化开发环境配置

使用方法和配置说明

前提条件

1. 安装Docker Desktop（版本2.5.0及以上，需支持Kubernetes集成）
2. 在Docker Desktop设置中启用Kubernetes：
   • 打开Docker Desktop → 进入设置(Settings) → 选择Kubernetes选项卡
   • 勾选启用Kubernetes(Enable Kubernetes)，点击应用 & 重启(Apply & Restart)
   • 等待Docker Desktop完成Kubernetes集群初始化（状态栏显示"Kubernetes running"）

访问Dashboard

通过Docker Desktop UI访问（推荐）

1. 确保Kubernetes已启动，点击Docker Desktop状态栏图标
2. 在弹出菜单中选择Kubernetes → Dashboard，自动打开浏览器访问Dashboard

通过命令行获取访问链接

1. 打开终端，执行以下命令获取Dashboard访问令牌：

   bash
   kubectl -n kubernetes-dashboard describe secret $(kubectl -n kubernetes-dashboard get secret | grep admin-user | awk '{print $1}')
   

2. 复制输出中的token字段值
3. 执行以下命令启动代理：

   bash
   kubectl proxy
   

4. 在浏览器中访问：http://localhost:8001/api/v1/namespaces/kubernetes-dashboard/services/https:kubernetes-dashboard:/proxy/
5. 粘贴之前获取的令牌，点击登录即可进入Dashboard

基本操作示例

查看集群资源

1. 登录后，在左侧导航栏选择工作负载(Workloads) → Pod，查看集群中所有Pod的状态
2. 点击任意Pod名称，可查看详细信息（容器状态、资源使用、事件日志等）

创建Deployment

1. 导航至工作负载(Workloads) → Deployment，点击右上角**+ 创建(CREATE)**
2. 选择通过表单创建(Create from form)，填写基本信息：
   • 名称：例如nginx-deploy
   • 容器镜像：nginx:latest
   • 副本数：2
3. 点击部署(Deploy)，完成后可在Deployment列表中查看新创建的资源

查看日志

1. 进入目标Pod详情页，切换至日志(Logs) 选项卡
2. 选择目标容器（若Pod包含多个容器），即可查看实时日志，支持搜索和下载功能

注意事项

• 该镜像仅随Docker Desktop的Kubernetes功能自动部署，不支持独立运行
• 主要用于开发/测试环境，不建议在生产环境中依赖Docker Desktop的Kubernetes集群
• 访问权限受Docker Desktop的Kubernetes配置限制，默认使用admin-user权限（本地开发环境）
• 如需自定义Dashboard配置（如插件、主题），需通过Kubernetes API或kubectl命令修改相关ConfigMap

常见问题

• Q: 启用Kubernetes后未找到Dashboard？
  A: 检查Docker Desktop版本是否支持Kubernetes集成，或尝试重置Kubernetes集群（Docker Desktop设置 → Kubernetes → 重置集群）

• Q: 无法获取访问令牌？
  A: 确保Kubernetes集群已完全启动，执行kubectl get pods -n kubernetes-dashboard确认dashboard相关Pod正常运行

• Q: 登录后提示权限不足？
  A: Docker Desktop内置集群默认配置了管理员权限，若自定义了RBAC规则，需检查admin-user的ClusterRoleBinding配置