kilna/liquibase-mysql

liquibase-mysql-docker

用于运行 Liquibase 与 MySQL 数据库的轻量级Docker镜像

DockerHub: https://hub.docker.com/r/kilna/liquibase-mysql/ - GitHub: https://github.com/kilna/liquibase-mysql-docker

镜像概述和主要用途

该镜像提供了一个预配置的环境，使开发人员和运维人员能够轻松使用Liquibase工具对MySQL数据库执行版本控制和变更管理。通过环境变量配置和自动生成的liquibase.properties文件，简化了Liquibase与MySQL数据库的集成流程，适用于各类数据库变更场景。

核心功能和特性

• 轻量级设计：基于精简基础镜像构建，减少资源占用
• 自动配置：启动时自动生成liquibase.properties文件，无需手动编写
• 环境变量支持：通过环境变量灵活配置数据库连接参数和Liquibase行为
• 多使用方式：支持基于Dockerfile构建自定义镜像或直接挂载本地目录运行
• 完整Liquibase功能：包含完整的Liquibase可执行文件，支持所有标准Liquibase命令

使用场景和适用范围

• 开发环境中数据库结构变更的版本控制
• CI/CD流程中自动化执行数据库迁移脚本
• 多环境（开发、测试、生产）数据库版本同步
• 需要快速验证数据库变更回滚能力的场景

使用方法和配置说明

使用自定义Dockerfile构建

通过创建继承自该镜像的Dockerfile，可将变更日志文件打包到自定义镜像中：

dockerfile
FROM kilna/liquibase-mysql
ENV LIQUIBASE_HOST=database.server
ENV LIQUIBASE_DATABASE=dbname
ENV LIQUIBASE_USERNAME=user
ENV LIQUIBASE_PASSWORD=pass
COPY changelog.xml /workspace

确保在Dockerfile同级目录中创建有效的changelog.xml文件。

构建自定义镜像：

bash
$ docker build --tag changelog-image .

运行Liquibase命令（例如执行更新并测试回滚）：

bash
$ docker run changelog-image liquibase updateTestingRollback

容器工作目录为/workspace，默认查找changelog.xml文件，可通过环境变量修改此行为。

直接挂载卷运行

无需构建自定义镜像，通过挂载本地变更日志目录直接运行：

bash
$ docker run -e LIQUIBASE_HOST=database.server -e LIQUIBASE_USERNAME=user -e LIQUIBASE_PASSWORD=pass \
    -e LIQUIBASE_DATABASE=dbname -v /local/path/to/changelog/:/workspace/ kilna/liquibase-mysql \
    liquibase updateTestingRollback

其中/local/path/to/changelog/是包含有效changelog.xml文件的本地目录。

环境变量和liquibase.properties

该镜像的入口点会根据环境变量自动生成liquibase.properties文件，支持以下环境变量配置：

生成的liquibase.properties文件位于/workspace目录（可作为Docker卷共享）。文件中的变量（如${HOST}）会被相应的环境变量值替换。

查看生成的配置文件内容：

bash
$ docker run image-name cat liquibase.properties