Liquibase Docker镜像文档

快速参考

• 维护者：Liquibase
• 获取帮助：Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow
• 支持的标签及对应Dockerfile链接：
  • 5.0, 5.0.1, latest
  • 5.0-alpine, 5.0.1-alpine, alpine
• 问题反馈：[***]
• 支持的架构（更多信息）：amd64、arm64v8
• 镜像详情：repo-info仓库的repos/liquibase/目录（历史记录）（包含镜像元数据、传输大小等）
• 镜像更新：official-images仓库的library/liquibase标签、official-images仓库的library/liquibase文件（历史记录）
• 描述来源：docs仓库的liquibase/目录（历史记录）

关于Liquibase

Liquibase是数据库的DevOps工具。它通过比较变更日志（Change Log）与数据库内容，确定需要应用到数据库的变更，例如创建表、添加列等。本Docker镜像提供Liquibase的容器化部署，方便用户在CI/CD流程中集成使用。

!logo

使用方法

如果您当前通过命令行使用Liquibase，命令通常如下：

$ liquibase update --driver=org.postgresql.Driver --url="jdbc:postgresql://<数据库IP>:<数据库端口>/<数据库名>" --changeLogFile=/liquibase/changelog/changelog.xml --username=<用户名> --password=<密码>

使用Docker镜像时，只需通过docker run命令运行，并将包含变更日志文件（如changelog.xml、.yml、.json或.sql）的目录挂载到容器内的/liquibase/changelog路径。示例命令如下：

$ docker run -v /本地路径/changelog:/liquibase/changelog liquibase --driver=org.postgresql.Driver --url="jdbc:postgresql://<数据库IP>:<数据库端口>/<数据库名>" --changeLogFile=/liquibase/changelog/changelog.xml --username=<用户名> --password=<密码>

说明：

• -v /本地路径/changelog:/liquibase/changelog：将本地存放变更日志的目录挂载到容器内的/liquibase/changelog，使Liquibase能够访问变更日志文件。
• 支持所有Liquibase命令（如rollback、updateSQL等），只需在上述命令中替换update为相应命令即可。

镜像变体

liquibase镜像提供多种变体，适用于不同场景：

liquibase:<version>（标准版本）

默认镜像，适用于大多数场景。既可作为临时容器使用（挂载源代码并启动容器运行应用），也可作为基础镜像构建其他镜像。

liquibase:<version>-alpine（Alpine版本）

基于Alpine Linux（alpine官方镜像）构建，体积更小（约5MB基础镜像），适合对最终镜像大小有严格要求的场景。

注意：Alpine Linux使用musl libc而非glibc，部分依赖glibc的软件可能存在兼容性问题。此外，为精简体积，通常不包含git、bash等工具，需在自定义Dockerfile中按需安装。

许可证

Liquibase软件的许可证信息参见LICENSE.txt。 与所有Docker镜像一样，本镜像可能包含其他软件（如基础发行版中的Bash等），其许可证可能不同。 自动检测的额外许可证信息可在repo-info仓库的liquibase/目录中查看。 使用本镜像前，请确保遵守所有包含软件的相关许可证。