基于Docker的集群部署教程

What this page covers

• Docker 背景与集群部署目标（4 个容器、5 节点拓扑）。
• License 与节点规模限制及放置路径要求。
• 虚拟子网固定 IP 与 controller/agent/datanode 配置示例。
• Docker 虚拟网络下 UDP 限制与 lanCluster=0 配置。
• 前置环境：docker 与 docker-compose 安装与版本查看。
• 下载部署包、构建镜像与查看镜像信息的步骤。
• docker-compose 启动容器与输出结果（网络、容器）。

技能认证特训营第二期报名推广

页面顶部包含活动报名引导，并提供限时报名链接。

• 提供“技能认证特训营第二期”的报名入口链接。
• 报名链接指向 qingsuyun.com 的活动页面。

基于Docker的集群部署教程（标题、作者与日期）

本节给出文章标题、作者署名与发布日期信息。

• 作者署名为 liang.lin。
• 发布日期为 2021-05-14。

背景与目标：使用 Docker 部署 DolphinDB 分布式集群

介绍 Docker 与 DolphinDB 的 docker 集群部署包，并说明以 4 个 CentOS 容器搭建 5 节点多机集群的目标与拓扑。

• Docker 被描述为可为应用创建轻量级可移植容器的开源引擎。
• DolphinDB 提供基于 docker 的分布式集群部署包。
• 本文部署目标为使用 4 个 CentOS 容器搭建集群。
• 目标拓扑为 5 节点多机集群（含 controller 与多个 datanode）。

License 与节点规模限制说明

社区版 license 不支持目标节点规模，并要求使用支持 6+ 节点的企业版 license 放到指定目录。

• 免费社区版 license 无法支持 5 个数据节点和 1 个控制器节点。
• 需申请支持 6 个以上节点的企业版 license。
• 企业版 license 文件 dolphindb.lic 需放到 ./cfg 目录下。

网络与端口配置：controller/agent/datanode 与虚拟子网

部署包通过容器虚拟子网为 4 个容器分配固定 IP，并给出 controller、agent 与节点列表的配置示例。

• 需要分别配置 controller、agent、datanode 的网络 IP 和端口。
• 容器虚拟子网为 4 个容器分配 10.5.0.2 到 10.5.0.5 的固定 IP。
• 部署包内置包含 IP/端口信息的配置文件（无需手工逐一配置）。
• controller.cfg 示例包含 localSite=10.5.0.5:8888:master。
• agent1.cfg 示例包含 mode=agent 与 controllerSite=10.5.0.5:8888:master。

UDP 在 Docker 虚拟网络的限制与 lanCluster 配置

UDP 在 docker 虚拟网络环境中无法正常工作，需要设置 lanCluster=0，且部署包已默认添加。

• 在 Docker 虚拟网络环境中，UDP 协议无法正常工作。
• agent.cfg 与 cluster.cfg 需要添加 lanCluster=0。
• 部署包配置文件已默认添加 lanCluster=0。

前置环境：安装 docker 与 docker-compose、查看版本

提供 docker 与 docker-compose 安装参考链接，并给出查询版本号的命令。

• 部署前需要搭建 docker 环境并安装 docker-compose。
• 提供 Docker 安装教程链接：https://docs.docker.com/install/。
• 提供 docker-compose 安装教程链接：https://docs.docker.com/compose/install/#install-compose。
• Docker 版本查询命令为 docker -v。
• docker-compose 版本查询命令为 docker-compose --version。

步骤 1：下载并编译 DolphinDB docker 集群部署包

说明下载部署包、通过修改 DockerFile 版本参数构建镜像，并展示构建与查看镜像的命令与示例输出。

• 文中给出部署包下载链接（Gitee）。
• 解压后可修改 Dockerbuild/DockerFile 的 dolphindb_version 参数。
• 文中给出 Release Notes 查询链接：https://github.com/dolphindb/release。
• DockerFile 示例包含 ARG dolphindb_version = "DolphinDB_Linux64_V1.00.10.zip"。
• 构建镜像命令示例为 docker build -t ddb:latest ./（在指定目录执行）。
• 示例镜像信息包含 ddb:latest 的大小为 420MB。

步骤 2：使用 docker-compose 创建并启动 controller 与 agent 容器

使用 docker-compose up -d 启动容器，并展示创建网络与容器的输出。

• 启动容器命令示例为 docker-compose up -d（在指定目录执行）。
• 默认启动脚本会自动启动 controller 与 agent 节点。
• 示例输出包含创建的网络名称 20190121-dolphindb-docker-compose_dbnet（bridge）。
• 示例输出包含容器名称 ddbcontroller、ddbagent1、ddbagent2、ddbagent3。

步骤 3：查看集群与 Web 管理界面

完成创建与初始化后可访问本地 8888 端口的集群管理 Web 页面并启动数据节点；本节还包含截图与说明块。

• 创建结果包含 1 个 controller 容器与 3 个 agent 容器。
• 集群管理 Web 页面访问地址为 http://localhost:8888/。
• 可在管理界面全选并启动数据节点。
• 说明块提到左侧列表显示三个代理节点已连接（低置信度）。
• 说明块提到表格包含一个控制器节点与五个数据节点（低置信度）。
• 说明块提到节点状态为绿色勾选标记表示正常运行（低置信度）。

步骤 4：自定义 docker 集群（端口/IP 与集群配置文件）

通过修改 docker-compose.yml 与 ./cfg 目录下配置文件来自定义网络与集群参数，并提供文件清单与帮助文档链接。

• 自定义 docker 网络端口与 IP 需要修改 docker-compose.yml。
• 自定义 DolphinDB 集群配置需要修改 ./cfg/ 下各配置文件。
• 提供集群配置帮助文档链接（ClusterSetup）。
• cluster.nodes 用于配置所有代理节点和数据节点的位置。
• controller.cfg、cluster.cfg 与 agent*.cfg 分别用于对应节点的配置参数。

步骤 5：如何升级版本

给出升级流程：下载新包、删除 license、复制覆盖容器目录并重启容器。

• 下载最新 server 安装包并解压。
• 删除 server 目录下的 dolphindb.lic 文件。
• 使用 docker cp 覆盖每个容器的 /data/ddb/server 目录。
• 重启 docker 容器以完成升级。

步骤 6：常见问题（tzdata、机器指纹）

列出 tzdata 缺失导致的启动错误及解决方法，以及 docker 中机器指纹获取失败导致的 license 校验问题与解决方法。

• 某些镜像（如 ubuntu:latest）可能不包含 tzdata，导致启动报错。
• tzdata 缺失的解决方法为 apt-get install tzdata。
• 正式 license 需要校验服务器硬件信息，docker 中可能无权限获取。
• 报错日志示例包含 “Failed to retrieve machine fingerprint”。
• 解决方法示例为映射宿主机 /etc/ 到容器 /dolphindb/etc（-v /etc:/dolphindb/etc）。

Facts Index