maprtech/edf-seed-container

Ezmeral Data Fabric Seed Container镜像文档

1. 镜像概述

Ezmeral Data Fabric Seed Container镜像（以下简称"Seed Container"）是HPE Ezmeral Data Fabric大数据平台的集群部署工具容器，用于作为集群初始化的种子节点，简化Data Fabric集群的搭建、配置与扩展流程。该镜像集成了集群部署所需的核心组件与配置逻辑，可快速引导单节点或多节点Data Fabric集群的启动与初始化，降低大数据平台部署的技术门槛。

2. 核心功能与特性

2.1 集群初始化

• 自动生成集群基础配置（如集群ID、节点标识、网络参数）
• 初始化Data Fabric核心服务（包括文件系统、数据库、流处理等组件）
• 支持自定义集群名称、服务端口与存储路径

2.2 多节点集群支持

• 作为集群初始节点，支持其他节点通过Seed Container加入集群
• 自动同步集群元数据至新加入节点，确保配置一致性
• 支持跨主机网络部署，适配Docker桥接网络与自定义网络环境

2.3 配置管理

• 内置配置验证机制，自动检测网络连通性、端口可用性与存储权限
• 支持通过环境变量或配置文件自定义集群参数（如副本数、内存分配、安全策略）
• 提供配置导出功能，便于集群备份与迁移

2.4 集成与兼容性

• 与Ezmeral Data Fabric全版本兼容（支持6.x及以上版本）
• 兼容Docker、Kubernetes等容器化部署环境
• 支持与Ezmeral Runtime Enterprise等HPE生态组件集成

3. 使用场景

3.1 开发/测试环境

• 快速搭建单节点Data Fabric集群，用于应用开发与功能测试
• 模拟多节点集群环境，验证分布式应用在集群中的运行逻辑

3.2 生产环境部署

• 作为生产集群的初始节点，引导多节点集群标准化部署
• 简化集群扩容流程，新节点可通过Seed Container自动加入现有集群

3.3 教学与演示

• 用于大数据平台教学，快速搭建可交互的Data Fabric环境
• 技术演示场景中，通过容器化部署展示Data Fabric功能特性

4. 使用方法与配置说明

4.1 前置要求

• Docker Engine 19.03+ 或兼容的容器运行时
• 宿主机需满足Ezmeral Data Fabric的系统要求（如内存≥8GB、磁盘空间≥50GB）
• 多节点部署时需确保节点间网络互通（建议使用主机网络模式或Docker overlay网络）

4.2 基础使用（单节点集群）

4.2.1 Docker Run命令示例

bash
docker run -d \
  --name data-fabric-seed \
  --net=host \
  -v /data/fabric:/opt/mapr/data \
  -v /data/fabric/logs:/opt/mapr/logs \
  -e CLUSTER_NAME=my-fabric-cluster \
  -e NODE_TYPE=seed \
  -e INIT_CLUSTER=true \
  hpe/ezmeral-data-fabric-seed:latest

4.2.2 参数说明

• --net=host：使用主机网络模式（推荐，确保集群网络通信正常）
• -v /data/fabric:/opt/mapr/data：挂载数据存储目录（持久化集群数据）
• -v /data/fabric/logs:/opt/mapr/logs：挂载日志目录（便于问题排查）
• CLUSTER_NAME：自定义集群名称（默认：ezmeral-fabric-cluster）
• NODE_TYPE：节点类型（固定为"seed"，标识为种子节点）
• INIT_CLUSTER：是否初始化集群（true：首次部署时启用）

4.3 多节点集群部署

4.3.1 种子节点启动（节点1）

bash
docker run -d \
  --name data-fabric-seed \
  --net=host \
  -v /data/fabric:/opt/mapr/data \
  -v /data/fabric/logs:/opt/mapr/logs \
  -e CLUSTER_NAME=my-fabric-cluster \
  -e NODE_TYPE=seed \
  -e INIT_CLUSTER=true \
  -e SEED_IP=192.168.1.100 \  # 种子节点IP（需替换为实际IP）
  hpe/ezmeral-data-fabric-seed:latest

4.3.2 工作节点加入（节点2）

bash
docker run -d \
  --name data-fabric-worker \
  --net=host \
  -v /data/fabric:/opt/mapr/data \
  -v /data/fabric/logs:/opt/mapr/logs \
  -e CLUSTER_NAME=my-fabric-cluster \
  -e NODE_TYPE=worker \
  -e SEED_IP=192.168.1.100 \  # 指向种子节点IP
  hpe/ezmeral-data-fabric-seed:latest

4.4 关键环境变量配置

5. 验证与管理

容器启动后，可通过以下方式验证集群状态：

1. 查看容器日志：docker logs data-fabric-seed
2. 访问Data Fabric管理界面：http://<seed-ip>:8443（默认用户名/密码：admin/mapr）
3. 执行集群状态命令：docker exec -it data-fabric-seed maprcli cluster info -cluster <cluster-name>

6. 注意事项

• 生产环境中建议使用持久化存储卷（如Docker Volume或外部存储），避免数据丢失
• 多节点部署时需确保所有节点时间同步（建议配置NTP服务）
• 容器运行用户需具备主机目录读写权限（可通过-u root临时调试，生产环境建议使用非root用户）
• 如需自定义端口或网络策略，需在启动时通过-p参数映射端口，并确保防火墙规则开放相关端口（如9997、7222等）