本文主要是针对springboot多模块项目，参数化构建、分包部署到maven私仓的记录。本文以上篇文章为基础进行记录。
系列文章：
Jenkins入门（一）：从搭建到部署第一个Springboot项目(踩坑记录)_ub24.04安装jenkins-CSDN博客
Jenkins入门（二）：流水线方式部署多模块Springboot项目-CSDN博客
目录
一、Maven私仓搭建
1.1 创建Ubuntu虚拟机
1.2 安装NATAPP内网穿透工具
1.3 安装 JDK8
1.4 安装 Nexus
1.5 配置Nexus私库地址
二、Jenkinsfile分包部署脚本
2.1 Jenkinsfile修改
2.2 idea 格式化Jenkins
三、Jenkins多参数配置
一、Maven私仓搭建
目前Jenkins和项目部署到服务器上，Maven私仓部署到ubuntu虚拟机上。
1.1 创建Ubuntu虚拟机
使用VMware创建Ubuntu虚拟机。注意记住创建的用户和密码
参考：VMware 虚拟机图文安装和配置 Ubuntu Server 22.04 LTS 教程_00-installer-config.yaml-CSDN博客
1.2 安装NATAPP内网穿透工具
用于提供Maven私仓的外网地址。
NATAPP1分钟快速新手图文教程 - NATAPP-内网穿透 基于ngrok的国内高速内网映射工具 参考官方文档：NATAPP1分钟快速新手图文教程 - NATAPP-内网穿透 基于ngrok的国内高速内网映射工具
1.3 安装 JDK8
参考：Linux开发环境搭建(二)之安装JDK和Maven_amazon linux2 安装java-CSDN博客
1.4 安装 Nexus
下载
Nexus3.x官网
Unix 3.54.1版本：unix或者linux下载
提取码：tymn
解压
tar -zxvf nexus-3.54.1-01-unix.tar.gz -C /home/mlj/soft/Nexus/修改环境变量
vi /etc/profile
export NEXUS_HOME=/home/hsp/data/Nexus/nexus-3.54.1-01
export PATH=$NEXUS_HOME/bin
source /etc/profile启动nexus
进入路径/home/mlj/soft/Nexus/nexus-3.54.1-01/bin执行
./nexus start
默认端口为8081，访问ip:8081进去，按照步骤填写密码，修改密码。
注意：用户名和密码谨慎填写，需要记住，后面项目中要使用
启动natapp
设置映射端口为8081，启动natapp，访问日志打印的域名就进入了nexus控制台
关于nexus控制台的学习可以参考如下文档：
使用Nexus在Ubuntu环境下搭建Maven私服_ubuntu 安装 nexus-CSDN博客
1.5 配置Nexus私库地址
修改Maven settings文件
<servers>
<!-- 这是配置访问私有仓库的用户名密码 -->
<server>
<!-- id标签可以随便填，只需要在servers中唯一即可，后面很多地方会使用该id -->
<id>self-maven</id>
<username>nexus</username>
<password>deplyment123</password>
</server>
</servers>
<profiles>
<profile>
<id>nexus</id>
<!--声明一个或多个远程仓库 -->
<repositories>
<!-- 声明一个 Nexus 私服上的仓库 -->
<repository>
<!--仓库id,这个id就是上面配置的账号密码id -->
<id>self-maven</id>
<!-- 仓库的名称 -->
<name>nexus</name>
<!--仓库的地址 修改为natapp动态域名-->
<url>http://localhost:8081/repository/maven-public/</url>
<!-- 是否开启该仓库的 release 版本下载支持 -->
<releases>
<enabled>true</enabled>
</releases>
<!-- 是否开启该仓库的 snapshot 版本下载支持 -->
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<!-- 声明一个或多个远程插件仓库 修改为natapp动态域名 -->
<pluginRepositories>
<!--声明一个 Nexus 私服上的插件仓库 -->
<pluginRepository>
<!--插件仓库 id -->
<id>self-maven</id>
<!--插件仓库 名称 -->
<name>nexus</name>
<!-- 配置的插件仓库的地址 -->
<url>http://localhost:8081/repository/maven-public/</url>
<!-- 是否开启该插件仓库的 release 版本下载支持 -->
<releases>
<enabled>true</enabled>
</releases>
<!-- 是否开启该插件仓库的 snapshot 版本下载支持 -->
<snapshots>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>
<properties>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
<maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
</properties>
<!-- 默认该profile生效 -->
<activation>
<activeByDefault>true</activeByDefault>
</activation>
</profile>
</profiles>
修改项目中pom文件，主要用于依赖上传
<distributionManagement>
<repository>
<!--注意这个id一定要填写我们maven的setting.xml当中配置的id-->
<id>self-maven</id>
<url>http://i97e4t.natappfree.cc/repository/maven-releases/</url>
</repository>
<snapshotRepository>
<!--注意这个id一定要填写我们maven的setting.xml当中配置的id-->
<id>self-maven</id>
<url>http://i97e4t.natappfree.cc/repository/maven-snapshots/</url>
</snapshotRepository>
</distributionManagement>部署测试:
mvn deploy -Dmaven.test.skip=true刷新nexus控制台能看到依赖已上传：
测试下载：
<dependency>
<groupId>com.xx</groupId>
<artifactId>xx-common</artifactId>
<version>1.2.1-SNAPSHOT</version>
</dependency>报错：Since Maven 3.8.1 http repositories are blocked
解决：
使用私服作为mirrors，如果maven是3.8.1+的版本，会提示：Since Maven 3.8.1 http repositories are blocked。3.8.1版本开始，处于安全考虑，maven禁用了http的镜像仓库，但是我们安装的私服通常都是http的地址，所以报这个错误。
将setting里下面配置注释掉：
<mirrors>
<mirror>
<id>maven-default-http-blocker</id>
<mirrorOf>dummy</mirrorOf>
<name>Dummy mirror to override default blocking mirror that blocks http</name>
<url>http://0.0.0.0/</url>
<blocked>true</blocked>
</mirror>
</mirros>参考：【有手就行】：从无到有搭建个人Maven私有仓库_maven搭建私有仓库-CSDN博客
二、Jenkinsfile分包部署脚本
背景：springboot项目模块太多，主项目只有一个，每次修改代码需要编译所有模块会浪费资源，也会导致jenkins构建很慢，后面考虑优化成增量部署，可选择修改过的模块进行编译部署，没改过的从私仓拉取，最后对主项目进行打包即可。
项目结构：
思路：
- 对基础模块进行编译部署上传私仓，包括业务模块的api（因为可能会引用业务模块的api）
- 对业务模块的biz进行编译部署上传私仓
- 对server启动类模块打包，不上传私仓
2.1 Jenkinsfile修改
#!groovy
pipeline {
agent any
environment {
// DockerHub 凭证 ID(登录您的
DOCKER_CREDENTIAL_ID = 'dockerhub-id'
// GitHub 凭证 ID (推送 tag 到 GitHub 仓库)
// GITHUB_CREDENTIAL_ID = 'github-id'
// kubeconfig 凭证 ID (访问接入正在运行的 Kubernetes 集群)
KUBECONFIG_CREDENTIAL_ID = 'demo-kubeconfig'
// 镜像的推送
REGISTRY = 'docker.io'
// DockerHub 账号名
DOCKERHUB_NAMESPACE = 'docker_username'
// GitHub 账号名
// GITHUB_ACCOUNT = 'https://gitee.com/zhijiantianya/ruoyi-vue-pro'
// 应用名称
APP_NAME = 'hbintrade-server'
// 应用部署路径
APP_DEPLOY_BASE_DIR = '/var/jenkins_home/workspace/'
// /var/jenkins_home/workspace/hbintrade-framework
def SERVER_NAME = "$project_name"
def BASIC_MODULE_NAME = "$basic_module_name"
def BUSINESS_MODULE_NAME = "$business_module_name"
}
stages {
stage('打印信息') { //打印信息
steps {
echo '变量打印信息'
echo "Project_Pipeline_name: $JOB_NAME"
echo "BASIC_MODULE_NAME: $BASIC_MODULE_NAME"
echo "BUSINESS_MODULE_NAME: $BUSINESS_MODULE_NAME"
echo "SERVER_NAME: $SERVER_NAME"
echo "workspace: $WORKSPACE"
echo "branch: $branch_name" //gitlab分支名
echo "build_id: $BUILD_ID"
// echo "target_action: $action"
// echo "registryUrl: $registryUrl"
// echo "image_repository: $registryUrl/$Project_name"
}
}
stage('检出') {
steps {
git credentialsId: 'xxx', url: 'https://gitee.com/xxx/xxx-framework.git',
branch: "$branch_name"
}
}
stage('构建') {
steps {
// echo "跳过构建！！！ "
// sh 'mvn deploy -Dmaven.test.skip=true'
script {
// 使用 replace 方法去除双引号
def BASIC_MODULE_NAME_STR = BASIC_MODULE_NAME.replace("\"", "")
def BUSINESS_MODULE_NAME_STR = BUSINESS_MODULE_NAME.replace("\"", "")
def SERVER_NAME_STR = SERVER_NAME.replace("\"", "")
if (BASIC_MODULE_NAME_STR != '') {
for (item in BASIC_MODULE_NAME.tokenize(',')) {
echo "开始构建基础模块并上传到maven私仓 " + item
END_STR = item[-3..-1]
if ("$END_STR" == "api") {
sh 'cd ' + item[0..-5] + ' && mvn deploy -pl ' + item + ' -Dmaven.test.skip=true'
} else {
sh 'mvn deploy -pl ' + item + ' -Dmaven.test.skip=true'
}
}
}
if (BUSINESS_MODULE_NAME_STR != '') {
for (item in BUSINESS_MODULE_NAME.tokenize(',')) {
echo "开始构建业务模块并上传到maven私仓 " + item + '-biz'
sh 'cd ' + item + ' && mvn deploy -pl ' + item + '-biz -Dmaven.test.skip=true'
}
}
if (SERVER_NAME_STR != '') {
for (item in SERVER_NAME.tokenize(',')) {
echo "开始打包主项目" + item
sh 'mvn clean package -pl ' + item + ' -Dmaven.test.skip=true'
}
}
}
}
}
stage('部署') {
steps {
sh 'cp -f ' + ' script/shell/deploy.sh ' + "${env.APP_DEPLOY_BASE_DIR}" + "${env.APP_NAME}" + '/'
sh 'cp -f ' + "${env.APP_NAME}" + '/target/*.jar ' + "${env.APP_DEPLOY_BASE_DIR}" + "${env.APP_NAME}" + '/build/'
archiveArtifacts "${env.APP_NAME}" + '/target/*.jar'
sh 'chmod +x ' + "${env.APP_DEPLOY_BASE_DIR}" + "${env.APP_NAME}" + '/deploy.sh'
sh 'bash ' + "${env.APP_DEPLOY_BASE_DIR}" + "${env.APP_NAME}" + '/deploy.sh'
}
}
}
}
注意：部署业务模块时，由于项目结构不同，需要进入 业务模块目录内执行构建，否则找不到业务模块的api子模块。
问题：groovy.lang.MissingPropertyException: No such property: Missing for class: Script3
解决：Jenkins里Quote Value勾选，Jenkinsfile获取变量值后要去除引号
2.2 idea 格式化Jenkins
Jenkinsfile是Groovy语言编写的，写Jenkinsfile过程中发现idea没办法对Jenkinsfile格式化，需要设置一下。
打开idea -> 设置 -> File Types -> Groovy ->添加新的文件类型，即添加上Jenkinsfile即可
三、Jenkins多参数配置
注意：参数name与Jenkins里面保持一致，Quote Value勾选否则不选择模块的话会报错“变量未定义”，选择后Jenkins里面处理参数值，去除双引号。具体参考Jenkinsfile
3.1 Jenkins项目参数配置
basic_module_name基础模块配置
business_module_name业务模块
project_name主项目
3.2 选择需要的模块构建
