背景

---

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 包存起来。

实现方式

---

1. 首先在 Project B 通过所有测试后添加一个保存 Jar 包的 Stage

stage('Archive Jar') {
                when {
                    anyOf { branch 'master' } // run this stage on master branch only
                }
                steps {
                    container('maven') {
                        script {
                            // implement later
                        }
                    }
                }
            }

2. 在 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 这个目录下。

3. 在 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 包，还可以用来保存我们生成的测试报告等等。关于这个的官方使用指南请查阅这里。