mysql/mysql-cluster

MySQL Cluster Docker镜像文档

镜像概述

关于MySQL

MySQL是全球最流行的开源数据库，以其可靠的性能、稳定性和易用性，成为Web应用的首选数据库，应用范围从个人项目、网站到大型在线服务（如***、***、***等）。更多信息请访问MySQL官方网站。

关于MySQL Cluster

MySQL Cluster基于NDB存储引擎构建，是高可扩展、实时、ACID兼容的事务型数据库，结合99.999%可用性与开源技术的低成本优势。采用分布式多主架构设计，无单点故障，可在通用硬件上水平扩展，支持读/写密集型工作负载，提供SQL和NoSQL接口访问。更多信息请访问MySQL Cluster官方页面。

MySQL Cluster Docker镜像

这些是由Oracle MySQL团队创建和维护的优化MySQL Cluster Docker镜像，提供以下版本：

• MySQL Cluster 7.5（标签：7.5）
• MySQL Cluster 7.6（标签：7.6）
• MySQL Cluster 8.0（最新GA版本，标签：8.0或latest）

镜像会随MySQL Cluster维护版本和开发里程碑更新而同步更新。注意：所有MySQL Cluster Docker镜像均为实验性版本，不应在生产环境中使用。

核心功能与特性

• 高可用性：99.999%可用性保障，分布式架构无单点故障
• 事务支持：实时ACID兼容事务处理
• 架构优势：分布式多主架构，支持水平扩展
• 多接口访问：同时支持SQL和NoSQL接口
• 性能优化：针对读/写密集型工作负载优化
• 开源成本：基于开源技术，降低总体拥有成本（TCO）

适用场景

适用于开发和测试环境中需要构建分布式数据库集群的场景，支持以下工作负载：

• 读/写密集型应用系统
• 需要高可用性和实时数据处理的业务
• 分布式多节点数据存储与访问测试
• 验证MySQL Cluster分布式架构特性的实验环境

使用方法

使用默认配置启动MySQL Cluster

注意：容器启动顺序严格，若任何步骤失败，可能需要从头重新启动。

步骤1：创建Docker内部网络

bash
docker network create cluster --subnet=192.168.0.0/16

步骤2：启动管理节点

bash
docker run -d --net=cluster --name=management1 --ip=192.168.0.2 mysql/mysql-cluster ndb_mgmd

步骤3：启动数据节点（2个）

bash
docker run -d --net=cluster --name=ndb1 --ip=192.168.0.3 mysql/mysql-cluster ndbd
docker run -d --net=cluster --name=ndb2 --ip=192.168.0.4 mysql/mysql-cluster ndbd

步骤4：启动MySQL服务器节点

bash
docker run -d --net=cluster --name=mysql1 --ip=192.168.0.10 -e MYSQL_RANDOM_ROOT_PASSWORD=true mysql/mysql-cluster mysqld

步骤5：获取初始密码并登录

服务器初始化时会生成随机密码，需从日志获取并修改：

bash
# 获取初始密码（若提示"ERROR 2002 (HY000): Can't connect to local MySQL server through socket"，表示服务器尚未完成初始化，需等待）
docker logs mysql1 2>&1 | grep PASSWORD

# 登录并修改密码
docker exec -it mysql1 mysql -uroot -p
ALTER USER 'root'@'localhost' IDENTIFIED BY 'MyNewPass';  # 将'MyNewPass'替换为自定义密码

步骤6：验证集群状态

启动交互式管理客户端验证集群状态：

bash
docker run -it --net=cluster mysql/mysql-cluster ndb_mgm

在管理客户端中执行show命令，正常输出示例：

Starting ndb_mgm
-- NDB Cluster -- Management Client --
ndb_mgm> show
Connected to Management Server at: 192.168.0.2:1186
Cluster Configuration
---------------------
[ndbd(NDB)]	2 node(s)
id=2	@192.168.0.3  (mysql-5.7.18 ndb-7.6.2, Nodegroup: 0, *)
id=3	@192.168.0.4  (mysql-5.7.18 ndb-7.6.2, Nodegroup: 0)

[ndb_mgmd(MGM)]	1 node(s)
id=1	@192.168.0.2  (mysql-5.7.18 ndb-7.6.2)

[mysqld(API)]	1 node(s)
id=4	@192.168.0.10  (mysql-5.7.18 ndb-7.6.2)

自定义MySQL Cluster配置

默认镜像包含两个配置文件（可在https://github.com/mysql/mysql-docker/tree/mysql-cluster%E6%9F%A5%E7%9C%8B%EF%BC%89%EF%BC%9A

• /etc/my.cnf
• /etc/mysql-cluster.cnf

如需修改集群配置（如添加节点、调整网络设置），需更新上述文件。详细配置说明请参考MySQL Cluster官方文档。

启动容器时，可通过-v参数挂载外部配置文件，示例：

bash
docker run -d --net=cluster --name=management1 --ip=192.168.0.2 -v <本地配置文件路径>/mysql-cluster.cnf:/etc/mysql-cluster.cnf mysql/mysql-cluster ndb_mgmd

支持的Docker版本

MySQL团队正式支持Docker 1.9版本。对旧版本（低至1.0）提供尽力支持，但强烈建议使用最新Docker版本以确保兼容性。

用户反馈

欢迎用户反馈！一般意见或讨论可在下方评论区留言；bug和问题请提交至MySQL Bug系统，类别选择“MySQL Package Repos and Docker Images”。