Jenkinsfile上传构件到Artifactory如何捕获完整下载链接用于邮件通知
实现结论
该需求完全可以在Jenkinsfile内直接实现,不需要额外写脚本或者手动查询构建日志、预设文件名。
核心逻辑
JFrog官方Jenkins插件提供的rtUpload步骤本身会返回本次上传操作的完整元数据,包含所有成功上传文件的Artifactory端相对路径,只需接收该返回值、拼接成完整直链后传入邮件模板即可。
改造步骤
- 接收上传步骤的返回值
原配置中rtUpload直接执行没有接收返回值,需将其赋值给变量,获取本次上传的全量文件列表。 - 批量拼接下载直链
遍历返回值中的文件条目,使用现有Artifactory基础域名拼接每个文件的相对路径,生成可直接访问的下载链接,存入环境变量供后续邮件步骤调用。 - 更新邮件模板
将原来的目录路径替换为拼接好的链接列表,邮件发送时会自动展示所有产物的直链。
改造后的完整Jenkinsfile片段
stage('Artifactory') { when{ anyOf{ branch 'UploadBranch' } } steps{ // 接收rtUpload返回的上传结果对象 def uploadResult = rtUpload ( serverId: 'Artifactory_Server', spec: '''{ "files": [ { "pattern": "path/to/file/*", "target": "Project/${BUILD_TIMESTAMP}/folder1/" }, { "pattern": "path/to/other/file/*", "target": "Project/${BUILD_TIMESTAMP}/folder2/" } ]} ''' ) // 批量生成所有上传产物的直链,格式为「Artifactory域名/文件完整路径」 env.ARTIFACT_DOWNLOAD_LINKS = uploadResult.files .findAll { it.type == 'file' } // 过滤掉非文件类的条目 .collect { // 如需收件人直接识别文件名,可追加文件名信息,示例: // "文件名:${it.localPath.split('/').last()} 下载链接:https://fake.artifactory.com/${it.relPath}" "https://fake.artifactory.com/${it.relPath}" } .join('\n') // 用换行分隔所有链接 } post { always { emailext attachLog: true, body: '''A new file has been uploaded into Artifactory. Please find download links below: ${ARTIFACT_DOWNLOAD_LINKS}''', subject: 'New file in Artifactory', recipientProviders: [[$class: 'DevelopersRecipientProvider']] cleanWs() } } }
注意事项
- 需确保当前安装的JFrog Jenkins插件(原Artifactory Jenkins插件)版本≥1.0.0,低版本不支持
rtUpload返回值特性。若插件版本过低,可在上传完成后追加rtFind步骤,按上传路径规则查询所有产物文件的元数据,同样可以生成直链。 - 若你的Artifactory路径存在额外前缀(如虚拟仓库路径),只需修改拼接的基础域名部分,与原有目录链接的前缀保持一致即可。
- 默认
rtUpload执行时若有单个文件上传失败会直接抛出异常,不会进入后续步骤,因此生成的链接均对应上传成功的产物,无需额外校验有效性。
内容的提问来源于stack exchange,提问作者ChrisP
相关产品推荐
相关产品推荐

