yonadev/yona-mariadb-liquibase-update

mariadb-liquibase-update 镜像文档

镜像概述

mariadb-liquibase-update 是一个用于Liquibase更新的基础层Docker镜像，设计作为包含应用版本数据库模式镜像的基础层。该镜像运行 Liquibase update 命令，使用 MariaDB JDBC 驱动，通过添加根变更日志文件实现对目标MariaDB数据库的变更管理。

核心功能与特性

• 基础层镜像：作为构建包含特定应用版本数据库模式镜像的基础，方便派生自定义镜像
• Liquibase update 执行：自动运行 Liquibase update 操作，应用变更日志中定义的数据库变更
• MariaDB 支持：集成 MariaDB JDBC 驱动，专门用于连接和操作 MariaDB 数据库
• 变更日志路径处理：变更日志文件需放置于 /changelogs/ 文件夹，数据库变更日志表（databasechangelog）的 FILENAME 列路径将相对该文件夹

使用场景

适用于需要通过 Liquibase 管理 MariaDB 数据库变更的应用场景，特别是在需要构建包含特定版本数据库模式的镜像时，可作为基础层简化镜像构建流程，确保数据库变更与应用版本同步。

使用方法与配置

派生自定义镜像

需从该镜像派生自定义镜像，并添加根变更日志文件至 /changelogs/changelog（可带任意文件扩展名）。示例 Dockerfile：

dockerfile
FROM yonadev/mariadb-liquibase-update:3.6.3

# 将本地变更日志文件复制到镜像的 /changelogs 目录
COPY liquibase/logs /changelogs

构建镜像

使用以下命令构建自定义镜像：

bash
docker build -t your/image:1.2.3 .

运行容器

运行容器时需通过环境变量指定数据库连接信息，示例命令：

bash
docker run -i \
  -e USER=sa \
  -e PASSWORD=TopSecret \
  -e URL=jdbc:mariadb://dbserver:3306/thedatabase \
  your/image:1.2.3

环境变量说明

运行容器时需提供以下必填环境变量：

• USER：目标数据库的用户名
• PASSWORD：目标数据库的密码
• URL：数据库的 JDBC 连接 URL（格式示例：jdbc:mariadb://dbserver:3306/thedatabase）

实现说明

本镜像的实现基于 Tom Beresford 的工作（https://hub.docker.com/r/beresfordt/pg-liquibase-update/~/dockerfile/%EF%BC%89%E3%80%82