drevops/mariadb-drupal-data

用于Drupal的MariaDB数据容器：数据库以Docker层形式存储

镜像概述

该Docker镜像专为Drupal网站设计，通过将已展开的MariaDB数据库数据存储为Docker层，实现数据库的快速部署与使用。不同于传统MariaDB使用卷挂载数据目录的方式，本镜像采用自定义数据目录/usr/lib/db-data，使数据库文件可作为Docker层存储于镜像中，用户下载镜像后即可直接使用预导入的数据库，无需执行耗时的数据导入操作。

本镜像主要基于上游镜像https://github.com/uselagoon/lagoon-images/blob/main/images/mariadb-drupal/10.6.Dockerfile%E6%9E%84%E5%BB%BA%EF%BC%8C%E9%80%9A%E8%BF%87%E8%B0%83%E6%95%B4%E5%85%A5%E5%8F%A3%E7%82%B9%E8%84%9A%E6%9C%AC%E4%BB%A5%E6%94%AF%E6%8C%81%E8%87%AA%E5%AE%9A%E4%B9%89%E6%95%B0%E6%8D%AE%E7%9B%AE%E5%BD%95%E3%80%82

核心功能与特性

• 数据层存储：将MariaDB数据库文件以Docker层形式嵌入镜像，替代传统卷挂载方式
• 快速部署：用户拉取镜像后可直接启动容器，数据库已预导入，节省数据导入时间
• 跨环境一致性：CI流程中构建的数据库镜像可在开发、测试环境中复用，确保数据一致性
• 多架构支持：兼容linux/amd64和linux/arm64架构

使用场景与适用范围

适用于具有大型数据库的Drupal网站，尤其适合以下场景：

1. CI/CD流程集成：

   • 夜间CI构建生成最新数据库镜像
   • 后续CI构建或开发者本地环境直接拉取镜像，避免重复导入大型数据库

2. 团队协作：

   • 开发者无需手动导入数据库，重启容器即可使用最新数据
   • 确保团队成员使用相同数据库版本，减少环境差异问题

使用方法与配置说明

生成包含自定义数据库的镜像

通过./seed-db.sh脚本可快速创建包含自有数据库的镜像：

1. 基本用法：

   bash
   ./seed-db.sh path/to/your/database.sql your-org/your-image:latest
   

2. 推送镜像至仓库：

   bash
   docker push your-org/your-image:latest
   

3. 处理平台识别问题： 若终端错误识别平台，可强制指定平台：

   bash
   DOCKER_DEFAULT_PLATFORM=linux/amd64 ./seed-db.sh path/to/your/database.sql your-org/your-image:latest
   

维护指南

运行测试

使用Bats测试框架验证功能：

bash
# 基本测试
tests/bats/node_modules/.bin/bats tests/bats/data.bats --tap

# 强制指定平台测试
DOCKER_DEFAULT_PLATFORM=linux/amd64 tests/bats/node_modules/.bin/bats --tap tests/bats/data.bats

镜像发布规则

镜像通过CI自动构建并推送到DockerHub，标签规则如下：

• main分支提交：自动构建为canary标签
• 发布版本：自动构建为:<version>（版本号与上游镜像一致）和latest标签
• 特性分支（如feature/my-branch）：构建为feature-my-branch标签

版本号遵循https://hub.docker.com/r/uselagoon/mariadb-drupal/tags%EF%BC%8C%E4%BB%A5%E7%AE%80%E5%8C%96%E7%BB%B4%E6%8A%A4%E3%80%82