severalnines/pxc56

Percona XtraDB Cluster 5.6 Docker镜像

目录

1. 概述
2. 核心功能
3. 使用场景
4. 配置说明
5. 部署示例
6. 构建镜像
7. 已知限制

概述

本镜像基于https://github.com/Percona-Lab/percona-xtradb-cluster-docker%E5%BC%80%E5%8F%91%EF%BC%8C%E6%94%AF%E6%8C%81%E8%BF%90%E8%A1%8CPercona XtraDB Cluster 5.6，可配合Docker Engine Swarm Mode、Kubernetes等编排工具使用，也可在独立环境部署，需依赖etcd集群实现节点发现与状态管理。

核心功能

• 包含Percona XtraDB Cluster 5.6完整组件
• 集成MySQL客户端、Percona Xtrabackup工具
• 内置jq JSON处理器，用于数据解析
• 提供report_status.sh脚本，定期向etcd报告Galera集群状态（默认每30秒更新一次）

使用场景

• 高可用分布式数据库集群部署
• 支持临时存储、持久化存储及自定义配置的场景
• 适用于需要强一致性、高容错的业务系统

配置说明

镜像支持以下关键参数：

• MYSQL_ROOT_PASSWORD：必填，设置MySQL root用户密码
• XTRABACKUP_PASSWORD：可选，设置xtrabackup用户密码（用于SST同步）
• DISCOVERY_SERVICE：可选，etcd集群地址（多地址用逗号分隔），用于节点发现
• CLUSTER_NAME：可选，集群名称，配合etcd使用
• CLUSTER_JOIN：可选，无etcd时指定现有集群节点IP列表（空值则新建集群）
• TTL：可选，状态报告过期时间（默认30秒）

部署示例

Docker Swarm Mode部署

临时存储

bash
docker service create \
--name mysql-galera \
--replicas 3 \
-p 3306:3306 \
--network galera-net \
--env MYSQL_ROOT_PASSWORD=mypassword \
--env DISCOVERY_SERVICE=192.168.55.111:2379,192.168.55.112:2379,192.168.55.113:2379 \
--env XTRABACKUP_PASSWORD=mypassword \
--env CLUSTER_NAME=my_wsrep_cluster \
severalnines/pxc56

持久化存储

bash
docker service create \
--name mysql-galera \
--replicas 3 \
-p 3306:3306 \
--network galera-net \
--mount type=volume,source=galera-vol,destination=/var/lib/mysql \
--env MYSQL_ROOT_PASSWORD=mypassword \
--env DISCOVERY_SERVICE=192.168.55.111:2379,192.168.55.112:2379,192.168.55.113:2379 \
--env XTRABACKUP_PASSWORD=mypassword \
--env CLUSTER_NAME=my_wsrep_cluster \
severalnines/pxc56

自定义my.cnf

bash
docker service create \
--name mysql-galera \
--replicas 3 \
-p 3306:3306 \
--network galera-net \
--mount type=volume,source=galera-vol,destination=/var/lib/mysql \
--mount type=bind,src=/mnt/docker/mysql-config,dst=/etc/my.cnf.d \
--env MYSQL_ROOT_PASSWORD=mypassword \
--env DISCOVERY_SERVICE=192.168.55.111:2379,192.168.55.112:2379,192.168.55.113:2379 \
--env XTRABACKUP_PASSWORD=mypassword \
--env CLUSTER_NAME=my_wsrep_cluster \
severalnines/pxc56

独立环境部署

bash
for i in 1 2 3; 
do \
docker run -d \
-p 3306 \
--name=galera${i} \
-e MYSQL_ROOT_PASSWORD=mypassword \
-e DISCOVERY_SERVICE=192.168.55.111:2379,192.168.55.112:2379,192.168.55.113:2379 \
-e CLUSTER_NAME=my_wsrep_cluster \
-e XTRABACKUP_PASSWORD=mypassword \
docker.xuanyuan.run/severalnines/pxc56;
done

构建镜像

bash
git clone https://github.com/severalnines/galera-docker-pxc56
cd galera-docker-pxc56
docker build -t --rm=true severalnines/pxc56 .

已知限制

• 镜像基于Docker 1.12.3在CentOS7.1上测试构建
• 集群发生脑裂时（所有节点处于Non-Primary状态）需手动干预恢复：

  bash
  docker exec -it [container] mysql -uroot -pyoursecret -e 'set global wsrep_provider_option="pc.bootstrap=1"'
  

• etcd注册信息需手动清理：

  bash
  curl http://192.168.55.111:2379/v2/keys/galera/my_wsrep_cluster?recursive=true -XDELETE
  

或使用etcdctl：

bash
etcdctl rm /galera/my_wsrep_cluster --recursive