You need to enable JavaScript to run this app. Jenkinsfile上传构件到Artifactory如何捕获完整下载链接用于邮件通知
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.26 03:36:10