Hazelcast Management Center Docker镜像文档

镜像概述和主要用途

Hazelcast Management Center 用于监控和管理运行 Hazelcast 的集群成员。除监控集群整体状态外，还支持详细分析数据结构、更新映射配置、获取成员线程转储，以及通过脚本（JavaScript、Groovy 等）和控制台模块在成员上执行命令。

更多信息请参考 Hazelcast IMDG 文档 和 Management Center 文档。

核心功能和特性

• 监控集群状态：实时查看集群健康状况和性能指标
• 数据结构分析：详细浏览和分析集群中的分布式数据结构
• 配置管理：动态更新映射（Map）等配置
• 诊断工具：获取成员线程转储，排查性能问题
• 脚本与命令执行：通过脚本模块运行自定义脚本，通过控制台模块执行集群命令

使用场景和适用范围

适用于需要监控、管理 Hazelcast 集群的场景，包括：

• 生产环境中 Hazelcast 集群的实时监控与运维
• 开发/测试环境中集群配置调试与优化
• 集群管理员对成员状态、数据分布的跟踪管理
• 需要自动化集群操作的场景（如通过脚本执行批量任务）

目录

• 快速开始
• 配置选项
• 示例配置
  • 修改上下文路径
  • 挂载主目录
  • 设置许可证密钥
  • 启用 TLS/SSL
  • 修改日志级别
  • 使用自定义 Log4j 配置文件
  • 添加额外类路径
  • 启用健康检查端点
  • 自定义容器启动设置
  • 预配置管理员用户
  • 预配置集群
  • JVM 堆配置
• 在自定义 Docker 镜像中配置
• Hazelcast 成员配置

快速开始

通过以下命令启动 Hazelcast Management Center。$MC_VERSION 需替换为 Docker Hub 上的可用版本：

bash
docker run --rm -p 8080:8080 hazelcast/management-center:$MC_VERSION

通过浏览器访问：http://localhost:8080。

• 若在云环境中运行，需使用机器公网 IP 替换 localhost，可通过 docker ps 或 docker inspect <container-id> 获取 host-ip，访问地址为 [***]。

默认情况下，容器会根据资源限制或可用内存自动调整 Java 堆内存大小。

配置选项

Management Center 5.1+ 版本支持系统属性与环境变量互换配置。完整配置参考见 Management Center 系统属性手册。以下为 Docker 环境常用配置示例。

示例配置

修改上下文路径

默认使用根路径 (/)，可通过 MC_CONTEXT_PATH 环境变量自定义：

bash
docker run --rm -p 8080:8080 --env MC_CONTEXT_PATH=/hz-mc hazelcast/management-center:$MC_VERSION

访问地址变为：[***]

注意：3.x 版本默认上下文路径为 /hazelcast-mancenter。

挂载主目录

Management Center 需持久化数据（如配置、日志），默认存储于容器内，重启后丢失。通过挂载 /data 目录实现外部存储：

bash
docker run --rm -p 8080:8080 -v <本地持久化目录>:/data hazelcast/management-center:$MC_VERSION

替换 <本地持久化目录> 为宿主机实际路径（如 /opt/hazelcast/mc-data）。

设置许可证密钥

通过 MC_LICENSE 环境变量传入许可证密钥：

bash
docker run --rm -p 8080:8080 --env MC_LICENSE='<license-key>' hazelcast/management-center:$MC_VERSION

启用 TLS/SSL

需提供密钥库并暴露 HTTPS 端口（默认 8443）：

bash
docker run --rm \
  -e JAVA_OPTS='-Dhazelcast.mc.tls.enabled=true \
    -Dhazelcast.mc.tls.keyStore=/keystore/yourkeystore.jks \
    -Dhazelcast.mc.tls.keyStorePassword=yourpassword' \
  -v <密钥库目录>:/keystore \
  -p 8443:8443 \
  hazelcast/management-center:$MC_VERSION

自定义 HTTPS 端口

通过 MC_HTTPS_PORT 修改默认端口（如 8444）：

bash
docker run --rm \
  -e MC_HTTPS_PORT=8444 \
  -e JAVA_OPTS='-Dhazelcast.mc.tls.enabled=true \
    -Dhazelcast.mc.tls.keyStore=/keystore/yourkeystore.jks \
    -Dhazelcast.mc.tls.keyStorePassword=yourpassword' \
  -v <密钥库目录>:/keystore \
  -p 8444:8444 \
  hazelcast/management-center:$MC_VERSION

详细配置见 Management Center TLS/SSL 手册。

修改日志级别

通过 LOGGING_LEVEL 环境变量设置日志级别（默认 INFO）：

bash
docker run --env LOGGING_LEVEL=DEBUG hazelcast/management-center:$MC_VERSION

可用级别（从高到低）：OFF、FATAL、ERROR、WARN、INFO、DEBUG、TRACE、ALL。无效级别自动设为 OFF。

使用自定义 Log4j 配置文件

挂载自定义 Log4j 配置文件至 /opt/hazelcast/mc_ext 目录：

bash
docker run \
  --env JAVA_OPTS='-Dlog4j.configurationFile=/opt/hazelcast/mc_ext/<自定义配置文件名>' \
  -v <本地配置目录>:/opt/hazelcast/mc_ext \
  -p 8080:8080 \
  hazelcast/management-center:$MC_VERSION

替换 <自定义配置文件名>（如 log4j2-custom.properties）和 <本地配置目录>。

添加额外类路径

通过 MC_CLASSPATH 添加额外类（如 JAAS 认证依赖）：

bash
docker run --env MC_CLASSPATH='/path/to/extra.jar' -p 8080:8080 hazelcast/management-center:$MC_VERSION

启用健康检查端点

暴露健康检查端口（默认 8081），用于容器编排系统（如 Kubernetes）监控：

bash
docker run -p 8080:8080 -p 8081:8081 \
  --env MC_HEALTH_CHECK_ENABLE=true \
  hazelcast/management-center:$MC_VERSION

详细说明见 健康检查手册。

自定义容器启动设置

通过环境变量在启动前执行命令或脚本：

• MC_INIT_CMD：执行分号分隔的命令（如 command1; command2）
• MC_INIT_SCRIPT：执行 Bash 脚本（需通过挂载或镜像构建使脚本可用）

命令/脚本按定义顺序在 Management Center 启动前执行。

预配置管理员用户

通过环境变量设置默认管理员用户：

bash
docker run --name hazelcast-mc \
  --env MC_ADMIN_USER=admin \
  --env MC_ADMIN_PASSWORD=myPassword11 \
  --rm hazelcast/management-center:$MC_VERSION

预配置集群

通过环境变量预设集群连接信息：

bash
docker run --name hazelcast-mc \
  --env MC_DEFAULT_CLUSTER=my-cluster \  # 集群名称，默认 dev
  --env MC_DEFAULT_CLUSTER_MEMBERS=192.168.0.10,192.168.0.11 \  # 成员地址（逗号分隔）
  --rm hazelcast/management-center:$MC_VERSION

JVM 堆配置

默认通过 -XX:+UseContainerSupport -XX:MaxRAMPercentage=80 自动适配容器内存。可通过以下变量自定义：

示例（手动配置堆大小）：

bash
docker run --rm --name hazelcast-mc \
  --env CONTAINER_SUPPORT='false' \
  --env MIN_HEAP_SIZE='512M' \
  --env MAX_HEAP_SIZE='1024M' \
  --env JAVA_OPTS='-XX:MaxGCPauseMillis=200' \
  hazelcast/management-center:$MC_VERSION

在自定义 Docker 镜像中配置

以 hazelcast/management-center 为基础镜像，通过 hz-mc conf 工具预配置：

dockerfile
FROM hazelcast/management-center:$MC_VERSION

# 预配置集群
ENV MC_DEFAULT_CLUSTER="my-cluster"
ENV MC_DEFAULT_CLUSTER_MEMBERS="192.168.0.10,192.168.0.11"

# 启动命令：创建管理员用户并启动服务
CMD ["bash", "-c", "set -euo pipefail \
  && ./bin/hz-mc conf user create -n admin -r admin -p s3cr3tP@ss \
  && ./bin/hz-mc start \
"]

注意：5.0.x 及更早版本需使用 ./bin/mc-conf.sh 替换 ./bin/hz-mc conf。

Hazelcast 成员配置

Hazelcast 成员配置及 Hello World 示例见 Hazelcast Docker 仓库。