10-实战：RuoYi-Cloud的自动化发布

一、项目准备1.微服务拆分Ruoyi-Cloud在设计上有7个微服务分别负责不同功能以下信息将在后续配置用到模块微服务代码根目录dockerfile路径网关模块RuoYi-Gatewayruoyi-gateway/docker/ruoyi/gateway认证模块RuoYi-Authruoyi-auth/docker/ruoyi/auth系统模块RuoYi-Systemruoyi-modules/ruoyi-system/docker/ruoyi/modules/system代码生成RuoYi-Genruoyi-modules/ruoyi-gendocker/ruoyi/modules/gen定时任务RuoYi-Jobruoyi-modules/ruoyi-jobdocker/ruoyi/modules/job文件服务RuoYi-Fileruoyi-modules/ruoyi-filedocker/ruoyi/modules/file监控中心RuoYi-Monitorruoyi-visual/ruoyi-monitor/docker/ruoyi/visual/monitor针对这些微服务我们需要创建7条Jenkins多分支流水线来分别对这些微服务进行CICD2.数据库文件导入在若依根目录sql/路径中有预设的数据库脚本需要创建对应数据库导入在数据库服务器10.0.0.138中将sql/路径下的脚本全部传输到服务器进入数据库create database ry-cloud; create database ry-config; # 编写导入脚本 vim ry-data.sh ------------------------------------------------------------------------ echo $(date) mysql -uroot -pPangle123 -f ry-cloud ry_20250523.sql echo $(date) ​ echo $(date) mysql -uroot -pPangle123 -f ry-cloud quartz.sql echo $(date) ​ echo $(date) mysql -uroot -pPangle123 -f ry-config ry_config_20260311.sql echo $(date) ------------------------------------------------------------------------ ​ # 执行脚本 nohup sh ry-data.sh ry-data.log 3.nacos安装我们的操作基于master分支而该分支代码已升级至SpringBoot4 对应nacos版本为3.X.X在10.0.0.140服务器上部署nacos前往nacos官网下载压缩版https://nacos.io/# 下载解压 cd /usr/local wget https://download.nacos.io/nacos-server/nacos-server-3.1.1.zip unzip nacos-server-3.1.1.zip ​ cd nacos/ # 配置文件编辑数据库路径 vim conf/application.properties ------------------------------------------------------------------------ spring.sql.init.platformmysql db.num1 db.url.0jdbc:mysql://{数据库服务器ip}:3306/ry-config?characterEncodingutf8connectTimeout5000socketTimeout10000autoReconnecttrueuseUnicodetrueuseSSLfalseserverTimezoneUTCallowPublicKeyRetrievaltrue db.userroot db.password{root用户密码} ------------------------------------------------------------------------ ​ # 单机模式启动 sh bin/startup.sh -m standalone4.配置地址- 配置微服务注册地址若依微服务依赖nacos进行服务注册和读取配置首先要为每个微服务配置nacos地址在每个微服务代码根目录下src/main/resources/bootstrap.yml文件中修改修改每个配置文件中每个server-addr:后的内容将127.0.0.1改为nacos服务器ip10.0.0.140- nacos配置数据库地址nocos将从数据库的ry-config库读取配置文件登录nacos主页 配置管理 配置列表修改ruoyi-gateway-dev.yml、ruoyi-auth-dev.yml、ruoyi-system-dev.yml、ruoyi-gen-dev.yml、ruoyi-job-dev.ymlredis的配置地址 host: {数据库服务器ip}datasource中的 url: 和 password: 设置成自己数据库相关配置- 配置后端API地址前端将部署到10.0.0.135后端将以微服务容器部署到10.0.0.137因此在前端代码文件需要配置后端服务器地址和访问端口在前端目录ruoyi-ui中编辑配置文件vue.config.js找到target: http://127.0.0.0:8080将其改为自定义的target: http://10.0.0.137:8080二、编写配置文件1.Jenkinsfile在对项目完成准备工作后将其上传到Gitlab仓库Ruoyi-Cloud然后新建分支prod-peizhi将其作为生产Jenkins需要发布的分支在prod-peizhi分支中在每个微服务代码根目录新建文件Jenkinsfile并编辑内容针对不同微服务只需要配置SERVICE_TYPE、BASE_NAME、HOST_PORT和CONTAINER_PORT就可复用该JenkinsfileSERVICE_TYPEBASE_NAMEHOST_PORT CONTAINER_PORTbasicgateway8080basicauth9200modulessystem9201modulesgen9202modulesjob9203modulesfile9300visualmonitor9100在Jenkins全局配置中添加前后端目标服务器信息命名为若依微服务-前端和若依微服务-后端供Jenkinsfile调用pipeline { agent any tools { // 全局工具已配置 maven Maven-3.8.9 jdk JDK-17 } environment { // 不同微服务需修改此处gateway/auth为 basic、job/file/gen/system为 modules、monitor为 visual SERVICE_TYPE basic BASE_NAME gateway // 基础服务名称 HOST_PORT8080 // 宿主机端口 CONTAINER_PORT8080 // 容器内端口 ​ // --------------------------------------------------------以下信息自动拼接---- // 根据微服务类型和基础名称动态生成应用名称基于RuoYi的项目结构 // APPNAME 根据生成的jar包名将作为镜像名称 APPNAME ruoyi-${SERVICE_TYPE basic ? BASE_NAME : (SERVICE_TYPE modules ? modules-${BASE_NAME} : visual-${BASE_NAME})} APP_DIR ${SERVICE_TYPE basic ? ./ruoyi-${BASE_NAME} : (SERVICE_TYPE modules ? ./ruoyi-modules/ruoyi-${BASE_NAME} : ./ruoyi-visual/ruoyi-${BASE_NAME})} // 拼接jar包完整路径供Dockerfile使用 JAR_PATH ${APP_DIR}/target/${APPNAME}.jar ​ // Dockerfile路径根据微服务类型动态选择 DOCKERFILE_DIR ${SERVICE_TYPE basic ? ./docker/ruoyi/${BASE_NAME} : (SERVICE_TYPE modules ? ./docker/ruoyi/modules/${BASE_NAME} : ./docker/ruoyi/visual/${BASE_NAME})} ​ // --------------------------------------------------------以下信息无需修改---- VERSIONV1.0.${env.BUILD_NUMBER} // 拼接为符合Harbor镜像规范的完整镜像名 HARBOR_URL121.4.90.98:80 IMAGE_NAME${HARBOR_URL}/ruoyi/${APPNAME}:${VERSION} // Harbor用户名密码 HARBOR_USERadmin HARBOR_PASSHarbor12345 // 前后端服务器地址在Jenkins系统配置中添加命名 NGINX_SERVER若依微服务-前端 APP_SERVER若依微服务-后端 } options { disableConcurrentBuilds() // 禁止并行构建 timestamps() // 日志添加时间戳 } stages { stage(Npm打包前端) { when { // 仅微服务名为ruoyi-gateway的流水线执行 expression { return env.APPNAME ruoyi-gateway } } steps { script { dir(ruoyi-ui) { sh rm -rf dist*.zip npm install --registryhttps://registry.npmmirror.com npm run build:prod zip -r dist-${VERSION}.zip ./dist/* } } } } stage(Maven打包后端) { steps { script { sh # 将jar包构建后复制到Docker构建目录供Dockerfile使用 mvn clean package -Dmaven.test.skiptrue -pl ${APP_DIR} -am -f ./pom.xml cp ${JAR_PATH} ${DOCKERFILE_DIR}/jar } } } stage(本地构建镜像) { steps { script { sh cd ${DOCKERFILE_DIR} docker build -t ${APPNAME}:${VERSION} . } } } stage(镜像推送Harbor) { steps { script { sh docker login ${HARBOR_URL} -u ${HARBOR_USER} -p ${HARBOR_PASS} docker tag ${APPNAME}:${VERSION} ${IMAGE_NAME} docker push ${IMAGE_NAME} } } } stage(部署前端) { when { expression { return env.APPNAME ruoyi-gateway } } steps { script { echo 部署前端 // sshPublisherJenkins SSH插件实现远程服务器操作 sshPublisher(publishers: [ sshPublisherDesc( configName: NGINX_SERVER, // 指定前端部署的SSH服务器 transfers: [ sshTransfer( sourceFiles: ruoyi-ui/dist-${VERSION}.zip, // 要推送的前端压缩包 removePrefix: , // 不删除压缩包的前缀路径 remoteDirectory: , // 推送至远程服务器的当前目录 // 远程服务器执行的命令解压压缩包并删除源文件 execCommand: # 切换到前端部署目录--解压并覆盖旧文件--删除压缩包 cd /usr/local/RuoYi-Cloud/ruoyi-ui unzip -o dist-${VERSION}.zip rm -rf dist-${VERSION}.zip ​ ) ], verbose: true // 输出详细SSH操作日志 ) ]) } } } stage(部署后端) { options { timeout(time: 30, unit: MINUTES) // 超时时间10分钟 } steps { script { echo 部署后端 sshPublisher(publishers: [ sshPublisherDesc( configName: APP_SERVER, // 指定后端部署的SSH服务器 transfers: [ sshTransfer( sourceFiles: , // 无需推送文件 removePrefix: , remoteDirectory: , // 远程执行部署脚本标准镜像名、端口等参数 execCommand: sh /usr/bin/ry-cloud.sh ${IMAGE_NAME} ${HOST_PORT} ${CONTAINER_PORT} ) ], verbose: true ) ]) } } } } }2.脚本文件部署后端阶段是调用后端服务器的/usr/bin/ry-cloud.sh脚本文件需在后端服务器添加改文件vim /usr/bin/ry-cloud.sh ------------------------------------------------------------------------ #!/bin/bash FULL_IMAGE_NAME$1 HOST_PORT$2 CONTAINER_PORT$3 ​ # 根据Jenkins传入参数解析镜像名 # 1按最后一个:分割 地址/项目名/镜像名 和 版本号 IMAGE_PREFIX${FULL_IMAGE_NAME%:*} # 取:左侧部分 → 121.4.90.98:80/ruoyi/ruoyi-gateway VERSION${FULL_IMAGE_NAME##*:} # 取:右侧部分 → V1.0.11 ​ # 2按最后一个/分割 地址/项目名 和 镜像名 APP_NAME${IMAGE_PREFIX##*/} # 取最后一个/右侧 → ruoyi-gateway HARBOR_ADDR${IMAGE_PREFIX%/*} # 取最后一个/左侧 → 121.4.90.98:80/ruoyi ​ # 打印解析结果 echo 部署参数解析结果 echo 完整镜像名: ${FULL_IMAGE_NAME} echo Harbor地址项目名: ${HARBOR_ADDR} echo 微服务名: ${APP_NAME} echo 版本号: ${VERSION} echo 主机端口: ${HOST_PORT} echo 容器端口: ${CONTAINER_PORT} echo ​ # 停止并删除旧容器 echo 停止并删除旧容器 OLD_CONTAINER$(docker ps -aq --filter name${APP_NAME}) if [ -n ${OLD_CONTAINER} ]; then echo 发现运行中的旧容器ID: ${OLD_CONTAINER}正在停止 docker stop ${OLD_CONTAINER} || echo 警告容器可能已停止 echo 删除旧容器: ${OLD_CONTAINER} docker rm ${OLD_CONTAINER} || echo 警告容器可能已删除 else echo 未发现运行中的旧容器跳过 fi ​ # 删除旧镜像 echo 删除旧镜像 # 检查旧镜像是否存在 if docker images -q ${FULL_IMAGE_NAME} /dev/null 21; then echo 发现旧镜像 ${FULL_IMAGE_NAME}正在删除 docker rmi ${FULL_IMAGE_NAME} || echo 警告镜像可能已删除 else echo 未发现旧镜像 ${FULL_IMAGE_NAME}跳过 fi ​ # 登录Harbor并拉取新镜像 echo 登录Harbor并拉取新镜像 # Harbor用户名密码也可由Jenkins传入 HARBOR_USERadmin HARBOR_PASSHarbor12345 docker login ${HARBOR_ADDR%/*} -u ${HARBOR_USER} -p ${HARBOR_PASS} || echo 警告Harbor登录失败 docker pull ${FULL_IMAGE_NAME} || { echo ERROR拉取新镜像失败; exit 1; } ​ # 启动新容器 echo 启动新容器 docker run -d \ --name ${APP_NAME} \ --restartalways \ -p ${HOST_PORT}:${CONTAINER_PORT} \ ${FULL_IMAGE_NAME} ​ # 验证容器是否启动成功 if docker ps --filter name${APP_NAME} | grep -q ${APP_NAME}; then echo 部署成功 echo 容器名: ${APP_NAME} echo 映射端口: ${HOST_PORT}:${CONTAINER_PORT} exit 0 else echo ERROR容器启动失败 docker logs ${APP_NAME} # 打印日志便于排查 exit 1 fi ------------------------------------------------------------------------三、配置Jenkins任务按微服务名在Jenkins新建任务并命名选择多分支流水线类型分支源选择Git项目仓库填写Ruoyi-Cloud的Gitlab仓库地址并配置Gitlab凭据行为发现分支后添加根据名称过滤支持通配符选择包含prod*匹配生产分支prod-peizhiBuild Configuration的脚本路径填写对应微服务的代码根目录➕/Jenkinsfile如ruoyi-gateway/Jenkinsfile点击应用后保存Jenkins就会自动扫描对应分支并根据其Jenkinsfile进行构建其他微服务同理建立Jenkins多分支流水线任务并做好配置总结文档从自由风格的项目到多分支流水线的任务搭建配置我们可以发现在篇幅上自由风格项目的Jenkins配置较多而多分支流水线的Jenkins配置非常少只需要编写好Jenkinsfile然后告诉Jenkins去哪里找Jenkinsfile文件即可这也就体现出流水线任务的优势不用过多去关注Jenkins的插件、系统设置、配置等只需要根据需求编写Jenkinsfile即可后续修改也很好找修改点。在内容上按 单前、后端的简单项目、前后端分离项目 最后到 微服务项目的项目设计由浅入深通过Jenkins完成不同项目的CICD已适配较多互联网公司的自动化发布任务。在自动化发布上后续将设计编写K8s集群整合Jenkins、Gitlab CI/CD、Gitlab Runner以及Argo CD等更多CICD工具完成不同项目的自动化发布。在制品保存、链路追踪上后续将搭建加入nexus的maven私有仓库、skywalking全链路追踪进一步为项目高并发能力的提升作支持在日志收集分析、监控告警上将搭建ELK日志处理、Prometheuskibana监控告警一体化平台保障项目高可用与问题的告警及时处理对于文档内容、设计以及后续文档有任何建议或意见欢迎交流裴东青956143827qq.com