kubetail/kubetail-dashboard

Kubetail Dashboard Docker镜像文档

概述

Kubetail Dashboard Docker镜像是Kubetail Dashboard的容器化部署方案，专为Kubernetes集群日志管理设计。该镜像封装了Kubetail Dashboard应用，提供Web可视化界面，支持实时日志流查看、多Pod日志聚合、关键词过滤与搜索等功能，帮助用户高效监控和分析Kubernetes集群中的容器日志。

核心功能与特性

• 实时日志流：支持实时查看Kubernetes Pod日志，日志更新低延迟，还原容器运行时状态
• 多Pod日志聚合：可同时聚合同一Deployment/StatefulSet下多个Pod的日志，按时间顺序合并展示
• 日志过滤与搜索：支持按命名空间、Pod名称、容器名称、时间范围及关键词筛选日志
• 用户友好的Web界面：提供直观的操作界面，包含日志颜色高亮、行号显示、日志下载等增强功能
• 轻量级部署：容器化设计，资源占用低，无需复杂依赖，可快速集成到现有Kubernetes环境

使用场景与适用范围

适用场景

• Kubernetes集群日常运维：实时监控关键业务Pod运行日志
• 开发调试：开发人员快速定位应用部署后的运行异常
• 日志审计：按时间范围追溯特定Pod/容器的历史日志
• 多团队协作：提供统一日志查看入口，支持多用户并行操作

适用对象

• Kubernetes集群管理员
• 应用开发人员
• DevOps工程师
• 负责集群监控的运维团队

使用方法与配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 具备Kubernetes集群访问权限（需提供有效的kubeconfig文件，包含pods和pods/log资源的访问权限）

Docker快速启动

通过以下命令启动容器（替换<本地kubeconfig路径>为实际文件路径）：

bash
docker run -d \
  --name kubetail-dashboard \
  -p 8080:8080 \
  -v <本地kubeconfig路径>:/app/config/kubeconfig \
  -e KUBECONFIG_PATH=/app/config/kubeconfig \
  kubetail-dashboard:latest

参数说明：

• -p 8080:8080：端口映射，将容器内8080端口映射到主机（可修改主机端口，如-p 9000:8080）
• -v <本地kubeconfig路径>:/app/config/kubeconfig：挂载本地kubeconfig文件至容器，用于访问Kubernetes集群
• -e KUBECONFIG_PATH：指定容器内kubeconfig文件路径（需与挂载路径一致）

Docker Compose部署

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

yaml
version: '3'
services:
  kubetail-dashboard:
    image: kubetail-dashboard:latest
    container_name: kubetail-dashboard
    ports:
      - "8080:8080"
    volumes:
      - <本地kubeconfig路径>:/app/config/kubeconfig
    environment:
      - KUBECONFIG_PATH=/app/config/kubeconfig
      - PORT=8080
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
      - THEME=light  # 界面主题：light/dark
    restart: unless-stopped

执行以下命令启动服务：

bash
docker-compose up -d

环境变量配置

支持通过环境变量自定义应用配置，参数说明如下：

访问与使用

1. 服务启动后，通过浏览器访问 http://<主机IP>:<映射端口>（如http://localhost:8080）
2. 在界面左侧选择目标命名空间，然后选择需查看日志的Pod/容器
3. 使用顶部工具栏的过滤框输入关键词，或通过时间范围选择器筛选日志
4. 点击"下载日志"按钮可导出当前查看的日志内容（支持txt格式）

注意事项

• 权限要求：挂载的kubeconfig文件需包含至少以下Kubernetes权限：

  yaml
  apiVersion: rbac.authorization.k8s.io/v1
  kind: ClusterRole
  metadata:
    name: kubetail-dashboard-role
  rules:
  - apiGroups: [""]
    resources: ["pods", "pods/log"]
    verbs: ["get", "list"]
  

• 性能优化：大规模集群建议适当调大LOG_RETENTION参数，避免频繁日志缓存清理影响性能
• 安全建议：生产环境建议通过反向代理（如Nginx）配置HTTPS，并限制访问来源IP