本文主要是针对springboot多模块项目，参数化构建、分包部署到maven私仓的记录。本文以上篇文章为基础进行记录。
系列文章：
Jenkins入门（一）：从搭建到部署第一个Springboot项目(踩坑记录)_ub24.04安装jenkins-CSDN博客
Jenkins入门（二）：流水线方式部署多模块Springboot项目-CSDN博客
目录
一、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
下载
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 选择需要的模块构建
