pukoren/mariadb-galera

mariadb-galera

基于Withblue.ink的实用主题构建，为Docker Cloud打造的可集群、自动发现的MariaDB Galera集群。

镜像概述和主要用途

本项目旨在创建易于部署的MariaDB集群，可动态扩展且无需复杂配置。通过HOSTNAME（或Docker Cloud上的DOCKERCLOUD_CONTAINER_HOSTNAME）环境变量自动发现其他节点（如mariadb-1、mariadb-2、mariadb-3等），命名为{name}-1的容器将作为Galera集群创建者。该容器可直接用于Docker Cloud环境。

核心功能和特性

• 自动发现：通过主机名自动识别集群节点
• 动态扩展：支持集群节点的横向扩展和缩减，无需手动配置
• Docker Cloud兼容：原生支持Docker Cloud环境
• 灵活配置：通过环境变量自定义数据库参数、用户和权限
• 高可用性：基于Galera集群技术，提供数据同步和故障转移能力

使用场景和适用范围

• 需要高可用数据库集群的生产环境
• Docker Cloud平台上的数据库部署
• 需动态调整规模的数据库服务
• 希望简化集群配置和维护的场景

使用方法和配置说明

Docker Cloud/Docker Compose配置

yml
mariadb-production:
  environment:
    - MYSQL_ROOT_PASSWORD=password  # 集群root密码
  image: 'docker.xuanyuan.run/pukoren/mariadb-galera:latest'
  ports:
    - '3306:3306'  # 映射数据库端口
  volumes:
    - '/data/mysql:/data'  # 持久化数据存储

部署后，通过扩展容器数量即可自动扩展集群。

本地手动测试

sh
# 创建网络
docker network create --driver bridge galera

# 启动第一个节点（集群创建者）
docker run -it -e MYSQL_ROOT_PASSWORD=root --name=mariadb-1 -e HOSTNAME=mariadb-1 --rm --network galera -p 3306:3306 docker.xuanyuan.run/pukoren/mariadb-galera:latest

# 启动第二个节点（自动加入集群）
docker run -it -e MYSQL_ALLOW_EMPTY_PASSWORD=true --name=mariadb-2 -e HOSTNAME=mariadb-2 --rm --network galera --link mariadb-1:mariadb-1 docker.xuanyuan.run/pukoren/mariadb-galera:latest

环境变量说明

注意事项

集群关闭与恢复

切勿关闭整个集群——否则节点可能无法恢复。若必须关闭整个集群并稍后重启，需删除第一个容器（{name}-1）共享卷中的clustered文件。

始终采用滚动部署流程，避免更新时集群关闭。

部署示例

反向代理后（HAProxy），通过IP过滤保护（Docker Cloud）

创建位于反向代理后的MariaDB Galera集群，实现负载均衡并基于源IP地址过滤入站请求：

yml
mariadb-production:
  environment:
    - 'EXCLUDE_PORTS=4567,4568,4444'  # 排除的端口
    - 'EXTRA_SETTINGS=acl network_allowed src 192.168.1.0,block if !network_allowed'  # IP过滤规则
    - MYSQL_ROOT_PASSWORD=password  # 集群root密码
    - TCP_PORTS=3306  # 开放的TCP端口
  image: 'pukoren/mariadb-galera:latest'
  sequential_deployment: true  # 启用顺序部署
  volumes:
    - '/data/mysql:/data'  # 数据持久化

mariadb-production-lb:
  environment:
    - 'STATS_AUTH=user:pass'  # 统计页面认证信息
    - STATS_PORT=1936  # 统计页面端口
  image: 'dockercloud/haproxy:latest'  # HAProxy镜像
  links:
    - mariadb-production  # 链接到MariaDB集群
  ports:
    - '1936:1936'  # 统计页面端口映射
    - '3306:3306'  # 数据库端口映射
  roles:
    - global  # 全局角色