如何在Jenkins流水线中实现SVN版本下拉选择并执行构建

核心方案 #

利用Jenkins的**主动选择参数（Active Choice Parameter）**插件，通过Groovy脚本（或调用你已有的Python脚本）动态拉取SVN仓库的历史修订版本列表，让用户触发构建时从下拉菜单中选择目标版本。

步骤1：安装必要插件 #

在Jenkins插件管理中安装Active Choices插件，该插件支持动态生成参数选项，适配脚本化流水线的需求。

步骤2：脚本化流水线实现代码 #

以下是完整的流水线示例，包含参数配置、SVN版本拉取、构建逻辑：

node {
    // 配置构建参数：动态生成SVN修订版本下拉列表
    properties([
        parameters([
            activeChoiceReactiveParam(
                name: 'TARGET_SVN_REVISION',
                description: '选择需要构建的SVN修订版本（HEAD代表最新版本）',
                choiceType: 'PT_SINGLE_SELECT', // 单选下拉框
                script: [
                    script: '''
                        // 配置SVN仓库地址和Jenkins凭证ID
                        def svnRepoUrl = "https://your-svn-repo-url"
                        def svnCredId = "svn-auth-credentials" // Jenkins中已配置的SVN用户名密码凭证ID
                        
                        // 从Jenkins凭证库获取账号密码
                        def svnCreds = com.cloudbees.plugins.credentials.CredentialsProvider.lookupCredentials(
                            com.cloudbees.plugins.credentials.common.StandardUsernameCredentials.class,
                            Jenkins.instance,
                            null,
                            null
                        ).find { it.id == svnCredId }
                        
                        def svnUser = svnCreds.username
                        def svnPass = svnCreds.password.getPlainText()
                        
                        // 执行SVN命令获取最近20个修订版本（可调整--limit参数控制数量）
                        def svnLogCmd = "svn log --limit 20 --quiet ${svnRepoUrl} --username ${svnUser} --password ${svnPass}"
                        def logProcess = svnLogCmd.execute()
                        logProcess.waitFor()
                        
                        // 提取修订号并整理成选项列表
                        def revisionList = logProcess.in.text.split("\\n")
                            .findAll { it.startsWith("r") }
                            .collect { it.split(" ")[0].substring(1) } // 去掉前缀'r'
                        
                        // 添加最新版本选项并倒序排列（最新版本在前）
                        revisionList.add(0, "HEAD")
                        return revisionList.unique().reverse()
                    ''',
                    sandbox: false // 需要关闭沙箱以允许Jenkins凭证操作
                ]
            )
        ])
    ])

    stage('拉取指定SVN版本') {
        checkout([
            $class: 'SubversionSCM',
            locations: [[
                remote: 'https://your-svn-repo-url',
                local: '.',
                credentialsId: 'svn-auth-credentials',
                depthOption: 'infinity',
                ignoreExternalsOption: false
            ]],
            revision: params.TARGET_SVN_REVISION // 使用用户选择的版本号
        ])
        echo "已拉取SVN版本: ${params.TARGET_SVN_REVISION}"
    }

    stage('执行构建') {
        // 替换为你的构建逻辑，比如调用已有的Python构建脚本
        sh 'python your-build-script.py'
        echo "构建完成"
    }
}

替代方案：调用已有Python脚本生成版本列表 #

如果你更倾向于用Python处理SVN交互，可以将版本获取逻辑封装到Python脚本中，再在Groovy脚本中调用：

Python脚本示例（get-svn-revisions.py）

import subprocess

def get_svn_revisions():
    svn_url = "https://your-svn-repo-url"
    svn_user = "your-svn-username"
    svn_pass = "your-svn-password"
    
    # 执行SVN log命令获取最近20个版本
    result = subprocess.run(
        ["svn", "log", "--limit", "20", "--quiet", svn_url, "--username", svn_user, "--password", svn_pass],
        capture_output=True,
        text=True,
        check=True
    )
    
    revisions = []
    for line in result.stdout.splitlines():
        if line.startswith("r"):
            rev_num = line.split()[0][1:]
            revisions.append(rev_num)
    
    # 添加HEAD选项并倒序
    revisions.insert(0, "HEAD")
    return reversed(revisions)

if __name__ == "__main__":
    print("\n".join(get_svn_revisions()))

流水线中调用Python脚本的参数配置部分

activeChoiceReactiveParam(
    name: 'TARGET_SVN_REVISION',
    description: '选择需要构建的SVN修订版本',
    choiceType: 'PT_SINGLE_SELECT',
    script: [
        script: '''
            // 调用Python脚本获取版本列表
            def pyScriptProcess = "python ${WORKSPACE}/get-svn-revisions.py".execute()
            pyScriptProcess.waitFor()
            return pyScriptProcess.in.text.split("\\n").findAll { it }
        ''',
        sandbox: false
    ]
)

注意事项 #

• 确保Jenkins服务器已安装SVN客户端，否则无法执行svn命令。
• 不要在脚本中硬编码账号密码，通过Jenkins凭证库管理更安全。
• 可根据需求调整--limit参数，控制下拉列表显示的历史版本数量。
• 如果不需要HEAD选项，可删除对应的添加逻辑。

内容的提问来源于stack exchange，提问作者Peter John