背景
Jenkins 是一个非常实用的 CI/CD 开源工具，在我所工作的项目中大部分都使用了 Jenkins 来实现自动化集成和部署。
面对的问题
项目后端有 2 个 project，BFF A 是一个 Backend For Front 项目， 调用 Project B 提供的接口。由于我们是一个团队同时开发两个项目，所以没有用契约测试这种复杂的测试来保证接口的正确性，而是直接用 API 测试来真实保证所有的调用的返回值及 schema 都是正确的。
正因为每一次 merge 代码时都需要通过 API 测试来保证功能的正确性，导致 BFF A 的 pipeline 每次都需要去 pull Project B 的代码构建 Jar 包。这一步骤需要耗费 2 分钟左右的时间，但实际上每次 Project B 在 merge master 时都会生成临时的 Jar 包，如果能临时保存这个 Jar 包，那我只需要 Copy 它就可以了。
所以我希望能在 Project B 每次通过 Pipeline 时能够把它的 Jar 包存起来。
实现方式
- 首先在 Project B 通过所有测试后添加一个保存 Jar 包的 Stage
stage('Archive Jar') {
when {
anyOf { branch 'master' } // run this stage on master branch only
}
steps {
container('maven') {
script {
// implement later
}
}
}
}
- 在 script 中调用 Jenkins 官方提供的 archiveArtifacts() 方法
stage('Archive Jar') {
when {
anyOf { branch 'master' } // run this stage on master branch only
}
steps {
container('maven') {
script {
archiveArtifacts('core/build/libs/*.jar')
}
}
}
}
注意，通过 archiveArtifacts 方法保存的文件在/var/jenkins_home/jobs/<projectName>/builds/<buildNumber>/archive 这个目录下。
- 在 BFF A 中将保存的 Jar 包 Copy 到制定路径，这里使用了 Jenkins 官方提供的 copyArtifacts 方法
stage('API test') {
steps {
container('maven') {
script {
copyArtifacts(projectName: "${projectName}/master", filter: "**/core/build/libs/*.jar", target: "lib/jars/bffA")
... // run API test
}
}
}
}
注意 copyArtifacts 方法中的三个变量
-
projectName从哪个 Jenkins Project 中拷贝文件 -
filter拷贝满足 filter 条件的所有文件 -
target拷贝到哪个路径下
这样，就可以不用再去 remote repository 拉代码以及编译打包了。可以节省“不少”时间。
总结
这个方法不仅仅可以用来保存我们的 Jar 包，还可以用来保存我们生成的测试报告等等。关于这个的官方使用指南请查阅这里。
