Bitnami MariaDB Galera 镜像文档

镜像概述和主要用途

MariaDB Galera 是一个多主数据库集群解决方案，提供同步复制和高可用性。Bitnami MariaDB Galera 镜像是由 Bitnami 打包的容器化版本，旨在简化 MariaDB Galera 集群的部署和管理，适用于开发、测试及生产环境（注：生产环境建议使用 Bitnami Secure Images）。

MariaDB Galera 概述
商标说明：本软件列表由 Bitnami 打包，所提及的商标分属各自公司所有，使用这些商标并不意味着任何关联或背书。

核心功能和特性

• 多主架构：支持多个主节点，任何节点均可读写，提高系统可用性和负载均衡能力
• 同步复制：集群节点间数据实时同步，确保数据一致性
• 自动故障转移：节点故障时自动检测并恢复，无需手动干预
• 安全加固：遵循 Bitnami Secure Images 标准，采用最小化操作系统（Photon Linux），减少攻击面
• 非 root 容器：以非特权用户运行，增强容器安全性
• 灵活配置：通过环境变量自定义数据库参数、集群配置及访问控制
• 数据持久化：支持卷挂载，确保容器重启后数据不丢失
• 标准化部署：与 Bitnami 虚拟机、云镜像使用相同组件和配置方式，便于跨环境迁移

使用场景和适用范围

• 高可用性数据库需求：需要避免单点故障的业务系统
• 分布式数据同步：多区域部署时需保持数据实时一致的场景
• 开发/测试环境：快速搭建 MariaDB Galera 集群进行功能验证和性能测试
• 中小规模生产环境：需简化集群管理的应用（生产环境建议使用 Bitnami Secure Images，获取长期支持和安全更新）

详细使用方法和配置说明

快速启动（TL;DR）

docker run --name mariadb-galera \
  -e ALLOW_EMPTY_PASSWORD=yes \
  bitnami/mariadb-galera:latest

警告：以上快速启动仅适用于开发环境。生产环境中应修改默认凭证，并参考 配置 部分进行安全部署。

⚠️ 重要通知：Bitnami 镜像目录即将变更

自 2025 年 8 月 28 日起，Bitnami 将升级其公共镜像目录，通过新的 Bitnami Secure Images 计划 提供精选的安全加固镜像：

• 首次向社区用户开放流行容器镜像的安全优化版本
• Bitnami 将逐步弃用免费层中非加固的 Debian 基础镜像，并从公共目录中移除非最新标签。社区用户将只能访问数量减少的加固镜像，且仅发布 "latest" 标签，适用于开发目的
• 2025 年 8 月 28 日起，两周内所有现有容器镜像（包括旧版本标签，如 2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移至 "Bitnami Legacy" 仓库（docker.io/bitnamilegacy），且不再接收更新
• 对于生产工作负载和长期支持，建议采用 Bitnami Secure Images，包含加固容器、更小攻击面、CVE 透明度（通过 VEX/KEV）、SBOM 及企业支持

这些变更旨在通过推广软件供应链完整性最佳实践和最新部署，提升所有 Bitnami 用户的安全态势。更多详情参见 Bitnami Secure Images 公告。

为什么使用 Bitnami Secure Images

• 安全加固与企业就绪：Bitnami Secure Images 和 Helm 图表旨在使开源软件更安全、更适合企业环境
• 漏洞透明管理：通过行业标准漏洞可利用性交换（VEX）、KEV 和 EPSS 评分，更快分类安全漏洞并透明呈现 CVE 风险
• 最小化操作系统：基于 Photon Linux 构建，减少攻击面的同时通过标准包格式保持可扩展性
• 持续更新：上游补丁发布后数小时内更新镜像，确保安全性和合规性
• 跨格式一致性：容器、虚拟机和云镜像使用相同组件和配置方式，便于根据项目需求切换格式
• 安全元数据：加固镜像附带签名证明（Notation）、SBOM、病毒扫描报告等 SLSA-3 合规元数据

在 Kubernetes 中部署

使用 Helm Chart 是在 Kubernetes 上部署 Bitnami 应用的最简单方式。详见 Bitnami MariaDB Galera Chart GitHub 仓库。

为什么使用非 root 容器

非 root 容器镜像增加了额外安全层，通常推荐用于生产环境。但由于以非 root 用户运行，特权操作通常受限。更多信息参见 Bitnami 非 root 容器文档。

支持的标签及 Dockerfile 链接

注意：Debian 9 和 Oracle Linux 7 基础镜像已弃用，Bitnami 不再发布基于这些系统的新 Docker 镜像。

Bitnami 标签策略及滚动标签与固定标签的区别详见 文档。各标签对应关系可查看分支文件夹中的 tags-info.yaml 文件（如 bitnami/ASSET/BRANCH/DISTRO/tags-info.yaml）。

可通过关注 bitnami/containers GitHub 仓库 获取项目更新。

获取镜像

推荐从 Docker Hub 仓库 拉取预构建镜像：

docker pull bitnami/mariadb-galera:latest

如需指定版本，可拉取带版本标签的镜像。可用版本列表 参见 Docker Hub。

docker pull bitnami/mariadb-galera:[TAG]

也可手动构建镜像：

git clone [***]
cd bitnami/APP/VERSION/OPERATING-SYSTEM  # 替换 APP、VERSION、OPERATING-SYSTEM 为实际值
docker build -t bitnami/APP:latest .

数据持久化

若删除容器，所有数据将丢失。为避免数据丢失，需挂载持久化卷至 /bitnami/mariadb 路径。挂载空目录时，首次运行会自动初始化数据。

Docker 命令行

docker run \
  -e ALLOW_EMPTY_PASSWORD=yes \
  -v /path/to/mariadb-persistence:/bitnami/mariadb \
  bitnami/mariadb-galera:latest

Docker Compose

修改仓库中的 docker-compose.yml：

services:
  mariadb:
  ...
    volumes:
      - /path/to/mariadb-persistence:/bitnami/mariadb
  ...

连接其他容器

通过 Docker 容器网络，容器内的 MariaDB 服务可被其他应用容器访问，同一网络中的容器可通过容器名作为主机名通信。

使用命令行

步骤 1：创建网络

docker network create app-tier --driver bridge

步骤 2：启动 MariaDB Galera 服务

docker run -d --name mariadb-galera \
  -e ALLOW_EMPTY_PASSWORD=yes \
  --network app-tier \
  bitnami/mariadb-galera:latest

步骤 3：启动客户端容器

docker run -it --rm \
  --network app-tier \
  bitnami/mariadb-galera:latest mysql -h mariadb-galera -u root

使用 Docker Compose

以下示例定义 app-tier 桥接网络，假设应用服务名为 myapp：

version: '2'

networks:
  app-tier:
    driver: bridge

services:
  mariadb-galera:
    image: bitnami/mariadb-galera:latest
    environment:
      - ALLOW_EMPTY_PASSWORD=yes
    networks:
      - app-tier
  myapp:
    image: YOUR_APPLICATION_IMAGE  # 替换为实际应用镜像
    networks:
      - app-tier

重要：

1. 需将 YOUR_APPLICATION_IMAGE 替换为实际应用镜像
2. 应用容器中使用主机名 mariadb-galera 连接数据库

启动容器：

docker-compose up -d

配置说明

环境变量

可自定义环境变量

只读环境变量