liuganquan/percona-xtradb-cluster-utf8

Percona XtraDB Cluster UTF8 Docker镜像

镜像概述

本镜像基于Percona XtraDB Cluster构建，默认支持UTF8编码，适用于快速部署高可用数据库集群。镜像兼容Docker网络（包括bridge、overlay网络），支持etcd发现服务，可跨主机部署节点，同时提供与ProxySQL的集成能力，满足企业级数据库的高可用与负载均衡需求。

核心功能

1. UTF8编码支持：默认启用UTF8字符集，满足多语言数据存储场景；
2. Docker网络兼容：支持bridge、overlay等网络类型，允许跨主机部署集群节点；
3. etcd发现服务：通过etcd自动发现现有集群节点，简化集群扩展与管理；
4. ProxySQL集成：可与ProxySQL镜像配合，实现数据库读写分离与负载均衡；
5. 灵活配置参数：支持根密码设置、xtrabackup用户密码配置等自定义选项。

使用场景

1. 企业级应用的高可用数据库集群部署；
2. 跨主机分布式系统的数据库支撑；
3. 多语言数据存储需求的业务场景；
4. 需要读写分离与负载均衡的数据库架构。

配置说明

镜像支持以下关键参数：

• 必填参数：需定义MYSQL_ROOT_PASSWORD（根密码）、MYSQL_ALLOW_EMPTY_PASSWORD（允许空密码）或MYSQL_RANDOM_ROOT_PASSWORD（随机根密码）中的一个；
• XtraBackup配置：XTRABACKUP_PASSWORD设置xtrabackup用户密码（用于SST同步）；
• 发现服务：DISCOVERY_SERVICE指定etcd服务地址（格式：IP:PORT）；
• 集群加入：CLUSTER_JOIN设置现有集群节点IP列表（空值则启动新集群）。

部署示例

1. 启动etcd服务

bash
ETCD_HOST=${ETCD_HOST:-10.20.2.4:2379}
docker run -d -v /usr/share/ca-certificates/:/etc/ssl/certs -p 4001:4001 -p 2380:2380 -p 2379:2379 \
 --name etcd quay.io/coreos/etcd \
 -name etcd0 \
 -advertise-client-urls http://${ETCD_HOST}:2379,http://${ETCD_HOST}:4001 \
 -listen-client-urls http://0.0.0.0:2379,http://0.0.0.0:4001 \
 -initial-advertise-peer-urls http://${ETCD_HOST}:2380 \
 -listen-peer-urls http://0.0.0.0:2380 \
 -initial-cluster-token etcd-cluster-1 \
 -initial-cluster etcd0=http://${ETCD_HOST}:2380 \
 -initial-cluster-state new

2. 启动集群节点

bash
export CLUSTER_NAME=cluster1
docker network create -d bridge ${CLUSTER_NAME}_net
docker run -d --net=${CLUSTER_NAME}_net \
 -e CLUSTER_NAME=${CLUSTER_NAME} \
 -e DISCOVERY_SERVICE=${ETCD_HOST} \
 -e MYSQL_ROOT_PASSWORD=your_root_password \
 -e XTRABACKUP_PASSWORD=your_xtrabackup_password \
 liuganquan/percona-xtradb-cluster-utf8

3. 集成ProxySQL

bash
docker run -d -p 3306:3306 -p 6032:6032 --net=${CLUSTER_NAME}_net --name=${CLUSTER_NAME}_proxysql \
 -e CLUSTER_NAME=${CLUSTER_NAME} \
 -e ETCD_HOST=${ETCD_HOST} \
 -e MYSQL_ROOT_PASSWORD=your_root_password \
 -e MYSQL_PROXY_USER=proxyuser \
 -e MYSQL_PROXY_PASSWORD=proxy_secret \
 perconalab/proxysql

# 注册集群节点到ProxySQL
docker exec -it ${CLUSTER_NAME}_proxysql add_cluster_nodes.sh