dreameagle/mariadb-galera

MariaDB Galera (ARM64) 镜像文档

镜像概述

本镜像为自制的ARM64架构版本，基于bitnami/mariadb-galera构建，专为ARM64平台优化，提供与原版兼容的MariaDB Galera集群功能。适用于需要在ARM64架构环境（如ARM服务器、边缘设备）部署高可用数据库集群的场景。

核心功能与特性

• ARM64架构支持：针对ARM64处理器优化，可在ARM服务器、嵌入式设备等平台运行
• Galera集群功能：支持同步多主复制，确保集群中所有节点数据一致
• 高可用性：自动故障检测与恢复，节点故障时集群仍可正常服务
• 兼容性：保留bitnami/mariadb-galera的核心功能与配置方式，易于迁移
• 轻量级：基于Alpine Linux，镜像体积小，资源占用低

使用场景

• ARM64架构服务器部署高可用数据库集群
• 边缘计算环境中的数据存储与同步
• 嵌入式系统或ARM开发板上的数据库服务
• 需要跨节点数据一致性的分布式应用

使用方法

基本运行（单节点引导）

bash
docker run -d \
  --name mariadb-galera-node1 \
  -e MARIADB_ROOT_PASSWORD=your_root_password \
  -e MARIADB_GALERA_CLUSTER_BOOTSTRAP=yes \
  -e MARIADB_GALERA_CLUSTER_ADDRESS=gcomm:// \
  -p 3306:3306 \
  -p 4567:4567 \
  -p 4568:4568 \
  -p 4444:4444 \
  docker.xuanyuan.run/your-image-name:tag

加入集群（其他节点）

bash
docker run -d \
  --name mariadb-galera-node2 \
  -e MARIADB_ROOT_PASSWORD=your_root_password \
  -e MARIADB_GALERA_CLUSTER_ADDRESS=gcomm://node1-ip:4567 \
  -e MARIADB_GALERA_NODE_NAME=node2 \
  -p 3307:3306 \
  -p 4569:4567 \
  -p 4570:4568 \
  -p 4445:4444 \
  docker.xuanyuan.run/your-image-name:tag

Docker Compose 示例

yaml
version: '3'
services:
  node1:
    image: docker.xuanyuan.run/your-image-name:tag
    environment:
      - MARIADB_ROOT_PASSWORD=your_root_password
      - MARIADB_GALERA_CLUSTER_BOOTSTRAP=yes
      - MARIADB_GALERA_CLUSTER_ADDRESS=gcomm://
      - MARIADB_GALERA_NODE_NAME=node1
    ports:
      - "3306:3306"
      - "4567:4567"
      - "4568:4568"
      - "4444:4444"
    volumes:
      - node1-data:/bitnami/mariadb

  node2:
    image: docker.xuanyuan.run/your-image-name:tag
    environment:
      - MARIADB_ROOT_PASSWORD=your_root_password
      - MARIADB_GALERA_CLUSTER_ADDRESS=gcomm://node1:4567
      - MARIADB_GALERA_NODE_NAME=node2
    ports:
      - "3307:3306"
      - "4569:4567"
      - "4570:4568"
      - "4445:4444"
    depends_on:
      - node1
    volumes:
      - node2-data:/bitnami/mariadb

volumes:
  node1-data:
  node2-data:

核心环境变量

端口说明

• 3306：MariaDB数据库端口
• 4567：Galera集群复制端口（TCP）
• 4568：Galera增量同步端口（TCP）
• 4444：Galera SST（状态快照传输）端口（TCP）

注意事项

• 集群至少需要3个节点以确保高可用性
• 所有节点需确保网络互通，特别是上述端口需开放
• 生产环境建议使用持久化存储（如Docker volumes）保存数据
• 首次启动集群时，仅一个节点设置MARIADB_GALERA_CLUSTER_BOOTSTRAP=yes，其他节点通过MARIADB_GALERA_CLUSTER_ADDRESS加入