<think>我们需要在Jenkins pipeline中添加归档(archive)步骤。归档通常用于保存构建产物，例如JAR文件、报告、日志等，以便后续访问。 在Jenkins pipeline中，可以使用`archiveArtifacts`指令来归档文件。 示例步骤： 1. 在pipeline的stage中添加一个步骤，使用`archiveArtifacts`指定要归档的文件路径（支持Ant风格路径匹配）。 2. 可以指定多个模式，也可以使用排除模式。 注意：归档的文件将保留在Jenkins的构建记录中，可以通过构建页面下载。 以下是一个简单的示例，在构建后归档`target`目录下的所有`*.jar`文件和`logs`目录下的所有文件： </think> ### 在 Jenkins Pipeline 中添加归档步骤 在 Jenkins Pipeline 中，归档操作通过 `archiveArtifacts` 指令实现，用于保留构建产物（如编译文件、测试报告等）。以下是完整实现： #### 1. **基础归档配置** ```groovy pipeline { agent any stages { stage('构建') { steps { sh 'mvn clean package' } } stage('归档') { steps { // 归档所有匹配文件 archiveArtifacts artifacts: 'target/*.jar', fingerprint: true, // 记录文件指纹 onlyIfSuccessful: true // 仅构建成功时归档 } } } } ``` --- #### 2. **多文件模式归档** ```groovy stage('高级归档') { steps { archiveArtifacts artifacts: ''' build/libs/*.war, // WAR包 reports/junit/*.xml, // 测试报告 logs/**/*.log, // 所有日志文件 !logs/temp/* // 排除临时文件夹 ''', allowEmptyArchive: true // 允许空归档 } } ``` --- #### 3. **归档后自动化操作** ```groovy post { always { archiveArtifacts artifacts: 'build/reports/**/*.html' // 总是归档报告 } success { // 归档成功后通知 slackSend(channel: '#ci', message: "构建产物已归档: ${BUILD_URL}/artifact") } } ``` --- ### 🔑 关键参数说明 | 参数 | 作用 | 示例 | |-----|------|------| | `artifacts` | 文件匹配路径 | `**/target/*.jar` | | `fingerprint` | 文件追踪 | `true` (跨构建跟踪) | | `excludes` | 排除文件 | `ignored-files/**` | | `onlyIfSuccessful` | 仅成功时归档 | `true` | | `allowEmptyArchive` | 允许空归档 | `false` (默认禁止) | --- ### 🛠️ 实用技巧 1. **使用归档别名** ```groovy archiveArtifacts artifacts: "app/build/outputs/**", artifactsOnly: true, // 仅归档不包含路径 defaultExcludes: false // 包含隐藏文件 ``` 2. **跨节点归档** ```groovy // 当使用分布式构建时 stash name: 'binaries', includes: 'bin/**' unstash 'binaries' archiveArtifacts 'bin/*' ``` 3. **与制品库集成** ```groovy // 归档后上传到Nexus archiveArtifacts 'target/*.jar' nexusArtifactUploader artifacts: [[artifactId: 'myapp', file: 'target/app.jar']] ``` --- ### ⚠️ 常见问题处理 **报错：`No artifacts found`** - 原因：路径错误或构建未生成文件 - 解决： ```groovy // 先确认文件存在 sh 'ls -R target/' archiveArtifacts 'target/*.jar' // 使用相对路径 ``` **大量文件归档慢** - 优化方案： ```groovy // 仅归档必要文件 archiveArtifacts artifacts: 'target/*-final.jar', excludes: '**/*.tmp' ```