devopsiaci/cruise-control-ui

Apache Kafka的Cruise Control UI镜像

概述

本镜像为Apache Kafka的Cruise Control及Cruise Control UI提供优化的多阶段Docker镜像，基于https://github.com/linkedin/cruise-control%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%E3%80%82%E5%8C%85%E5%90%ABJava-based%E7%9A%84Cruise Control服务器和Nginx-based的UI界面，支持多集群管理、非root用户运行及AWS MSK IAM认证。

默认版本：

• Cruise Control: 3.0.3
• Cruise Control UI: 0.4.0
• AWS IAM Auth: 2.3.5
• Java（Amazon Corretto）: 17
• Nginx: 1.25-alpine

核心功能

1. 多组件支持：包含Cruise Control服务器（Java）和UI界面（Nginx）两个独立镜像
2. 优化构建：多阶段构建减少镜像体积，降低***面
3. 安全特性：非root用户运行，最小化权限
4. 多集群管理：UI支持多Kafka集群配置
5. 云服务集成：内置AWS MSK IAM认证支持

使用场景

• Kafka集群的可视化监控与管理
• 多环境（开发、测试、生产）Kafka集群统一管理
• 需要AWS MSK认证的Kafka集群运维

配置说明

快速启动

Cruise Control服务器

bash
docker run --name cruise-control-server \
  -p 9090:9090 \
  -v $(pwd)/config:/cruise-control/config \
  devopsiaci/cruise-control:jdk17-cc3.0.3-iam2.3.5

Cruise Control UI

bash
docker run --name cruise-control-ui \
  -p 8080:80 \
  -v $(pwd)/config.csv:/usr/share/nginx/html/static/config.csv:ro \
  devopsiaci/cruise-control-ui:0.4.0

多集群配置文件config.csv格式：

csv
<分组>,<集群名称>,<Cruise Control API路径>
develop,cluster-dev,/cluster-dev/kafkacruisecontrol/
staging,cluster-staging,/cluster-staging/kafkacruisecontrol/

关键配置

cruise-control.properties配置

需自定义Kafka集群信息，关键参数：

properties
bootstrap.servers=<kafka-broker-1>:9092,<kafka-broker-2>:9092
zookeeper.connect=<zookeeper-1>:2181,<zookeeper-2>:2181
webserver.http.port=9090
webserver.api.urlprefix=/kafkacruisecontrol

Docker Compose示例

yaml
version: '3.8'
services:
  cruise-control:
    image: devopsiaci/cruise-control:jdk17-cc3.0.3-iam2.3.5
    container_name: cruise-control-server
    ports: ["9090:9090"]
    volumes: ["./config:/cruise-control/config:ro"]
    environment: {"JAVA_OPTS": "-Xms512m -Xmx2g"}
    restart: unless-stopped

  cruise-control-ui:
    image: devopsiaci/cruise-control-ui:0.4.0
    container_name: cruise-control-ui
    ports: ["8080:80"]
    volumes: ["./config.csv:/usr/share/nginx/html/static/config.csv:ro"]
    restart: unless-stopped
    depends_on: [cruise-control]

反向代理配置（Nginx）

若需在特定路径下部署UI，可配置Nginx反向代理：

nginx
location /cruise-control {
    rewrite ^/cruise-control/(.*) /$1 break;
    proxy_pass http://cruise-control-ui:80;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    sub_filter /static /cruise-control/static;
    sub_filter /kafkacruisecontrol /cruise-control/kafkacruisecontrol;
    sub_filter_once off;
}

自定义构建

构建参数

构建命令

构建UI镜像：

bash
docker build \
  --target cruise-control-ui \
  --build-arg CC_UI_TAG=0.4.0 \
  --build-arg NGINX_VERSION=1.25-alpine \
  -t my-cruise-control-ui:latest \
  .

贡献

欢迎提交Issue或Pull Request参与项目改进。