当前位置：首页 > news >正文

jenkins集成liquibase

news 2025/8/28 7:04:03

一、前言

liquibase的功能非常强大，只需要按规则编写sql文件，就可以实现自动化的数据库更新，发布的时候就不用依赖人工去操作更新数据库，而且liquibase还具有数据库版本回滚功能，一旦发现新版本有问题，就可以进行回滚到老版本的操作，下面就将liquibase集成到jenkins的cicd中，实现全自动化的发布

二、部署

在github下载liquibase安装包：https://github.com/liquibase/liquibase/releases

在mysql官网下载连接器：https://dev.mysql.com/downloads/connector/j/

我这里分别下载的是liquibase-4.32.0.tar.gz和mysql-connector-j-8.0.33.tar.gz

放到部署jenkins的主机中解压

mkdir /opt/liquibase && cd /opt/liquibase
tar -zxvf liquibase-4.32.0.tar.gz
tar -zxvf mysql-connector-j-8.0.33.tar.gz
ls /opt/liquibase

配置变量

vi /etc/profile
#在末尾添加以下内容
PATH=$PATH:/opt/liquibase/liquibase执行命令生效
source /etc/profile验证是否有效
liquibase --help

编写liquibase配置文件

vi liquibase.properties
#在文件中添加以下内容#连接器类型
driver=com.mysql.cj.jdbc.Driver
#mysql连接器压缩包解压后路径下的可执行jar包路径
classpath=/opt/liquibase/mysql-connector-j-8.0.33/mysql-connector-j-8.0.33.jar
#数据库用户名
username=xxxx
#数据库密码
password=xxxx

将配置文件上传到jenkins的凭证配置中

Manage Jenkins>Credentials>Global(全局)>Add Credentials

选择secret file类型并上传刚刚编辑的liquibase配置文件

在jenkins pipeline中加入liquibase更新数据库的步骤

pipeline {agent anyenvironment {database_name= "demeter_foundation"prd_mysql_url= "10.1.60.8:6033"test_mysql_url= "10.1.60.5:6033"}stages {stage('change mysql') {parallel {stage('change test mysql') {when {expression {params.status == 'deploy' && env.gitlabBranch != null }}steps {   #使用withCredentials调用凭证中的liquibase配置withCredentials([file(credentialsId: 'liquibase_conf', variable: 'LIQUIBASE_CONF')]) {sh '''   #以下liquibase命令指定了配置文件,数据库连接,还有变更的sql文件路径/opt/liquibase/liquibase --defaultsFile=${LIQUIBASE_CONF} --url=jdbc:mysql://${test_mysql_url}/${database_name} --changeLogFile=db/${database_name}/update/change_mysql.sql update'''}}}stage('change prd mysql') {when {expression {params.status == 'deploy' && env.gitlabBranch == null }}steps {withCredentials([file(credentialsId: 'liquibase_conf', variable: 'LIQUIBASE_CONF')]) {sh '''/opt/liquibase/liquibase --defaultsFile=${LIQUIBASE_CONF} --url=jdbc:mysql://${prd_mysql_url}/${database_name} --changeLogFile=db/${database_name}/update/change_mysql.sql update'''}}}}}}

有一个注意点是使用了proxysql+mysql mgr集群会导致出现报错，报错的原因是找不到主键，需要在liquibase创建的两张表中设置主键即可解决

以上的sql文件包含在代码仓库中由开发提交，只需在执行liquibase命令时使用--changeLogFile指定sql文件路径即可

以上配置没有包含回滚命令，回滚需要开发特殊配置sql文件，并且搭配回滚命令rollback命令

更多命令参考：Rollback Commands

查看全文

http://www.dtcms.com/a/353298.html