KnowStreaming UI Docker镜像文档

概述

KnowStreaming UI是KnowStreaming Kafka管控平台的前端用户界面组件。该Docker镜像提供了一个便捷的方式来部署和运行KnowStreaming的Web界面，使用户能够通过可视化方式管理和监控Kafka集群。

核心功能

• 可视化Kafka集群管理界面
• 主题(Topic)创建、配置和监控
• 消费者组(Consumer Group)监控和管理
• brokers状态监控和配置
• 分区(Partition)管理和负载均衡查看
• 性能指标实时监控和图表展示

使用场景

• Kafka集群的日常管理和运维
• Kafka集群监控和性能分析
• 主题和消费者组的可视化管理
• Kafka初学者的学***和实践环境
• 开发和测试环境中的Kafka管理界面
• 生产环境中的Kafka运维平台

部署要求

• Docker引擎 1.13.0+
• 已部署KnowStreaming后端服务
• 网络可访问KnowStreaming API服务
• 80或自定义端口的网络访问权限

快速开始

基本使用

bash
docker run -d -p 80:80 --name knowstreaming-ui knowstreaming-ui

指定后端API地址

bash
docker run -d -p 80:80 \
  -e KNOWSTREAMING_API_URL=[***] \
  --name knowstreaming-ui knowstreaming-ui

Docker Compose配置

yaml
version: '3'
services:
  knowstreaming-ui:
    image: knowstreaming-ui
    ports:
      - "80:80"
    environment:
      - KNOWSTREAMING_API_URL=[***]
    depends_on:
      - knowstreaming-api
    restart: always

环境变量配置

持久化数据

KnowStreaming UI本身不存储持久化数据，所有配置和状态都通过API从后端服务获取。

网络配置

确保容器能够访问KnowStreaming后端API服务，同时宿主机端口映射正确以允许外部访问UI界面。

注意事项

• 该镜像仅包含前端UI组件，需要配合KnowStreaming后端服务使用
• 确保UI与后端API版本匹配，避免兼容性问题
• 生产环境中建议配置HTTPS以确保数据传输安全
• 对于大规模部署，建议配置负载均衡和高可用

故障排除

• 无法连接到后端API: 检查KNOWSTREAMING_API_URL环境变量配置是否正确，确保后端服务正常运行且网络可通
• 界面显示异常: 检查浏览器控制台错误信息，确认UI与后端API版本兼容性
• 端口冲突: 使用-p参数指定不同的宿主机端口映射

维护和更新

bash
# 拉取最新镜像
docker pull knowstreaming-ui

# 停止并删除现有容器
docker stop knowstreaming-ui && docker rm knowstreaming-ui

# 使用新镜像启动
docker run -d -p 80:80 --name knowstreaming-ui knowstreaming-ui

注意: 本文档基于镜像名称"knowstreaming-ui"进行推断。实际功能和配置可能因具体镜像版本而有所不同，请参考***完整文档获取准确信息。