integr8/alpine-liquibase-helper

alpine-liquibase-helper

https://travis-ci.org/integr8/alpine-liquibase-helper.svg?branch=development](https://travis-ci.org/integr8/alpine-liquibase-helper)

文档地址：https://integr8.github.io/alpine-liquibase-helper/

镜像概述

本镜像基于Alpine Linux构建，是一个轻量级的Liquibase辅助工具，旨在简化数据库版本控制与迁移流程。通过集成Liquibase核心功能及必要依赖，提供高效、便捷的数据库变更管理能力，适用于各类开发与生产环境。

核心功能

• 支持Liquibase常用命令（如update、rollback、status等），满足数据库变更全流程需求；
• 基于Alpine Linux，镜像体积小、启动速度快，资源占用低；
• 内置JDBC驱动支持主流数据库（MySQL、PostgreSQL等），无需额外安装；
• 支持通过环境变量或配置文件灵活配置数据库连接参数。

使用场景

• 开发环境：快速验证数据库变更脚本的正确性；
• 生产环境：自动化执行数据库版本迁移，确保变更一致性；
• 团队协作：统一数据库变更工具版本，避免环境差异导致的问题；
• CI/CD流水线：集成到持续集成流程中，实现数据库变更的自动化部署。

配置说明

环境变量配置

可通过以下环境变量指定数据库连接信息：

• DB_URL：数据库JDBC连接地址（如jdbc:mysql://db:3306/mydb）；
• DB_USER：数据库用户名；
• DB_PASSWORD：数据库密码；
• CHANGELOG_FILE：变更日志文件路径（默认：/liquibase/changelog/changelog.xml）。

挂载配置

将本地变更日志目录挂载到容器内的/liquibase/changelog路径，即可使用自定义的变更脚本。

部署示例

Docker Run命令

bash
docker run -v /本地变更日志目录:/liquibase/changelog \
  -e DB_URL=jdbc:mysql://db:3306/mydb \
  -e DB_USER=root \
  -e DB_PASSWORD=your_password \
  docker.xuanyuan.run/integr8/alpine-liquibase-helper update

Docker Compose示例

yaml
version: '3'
services:
  liquibase:
    image: integr8/alpine-liquibase-helper
    volumes:
      - ./changelog:/liquibase/changelog
    environment:
      - DB_URL=jdbc:mysql://mysql:3306/mydb
      - DB_USER=root
      - DB_PASSWORD=your_password
    command: update
  mysql:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=your_password
      - MYSQL_DATABASE=mydb