Jenkins基础教程（42）配置Jenkins 服务器之配置Subversion：深度分析：Jenkins与Subversion完美联姻，打造自动化部署的“神雕侠侣”

最新推荐文章于 2025-11-24 20:51:43 发布

原创最新推荐文章于 2025-11-24 20:51:43 发布 · 352 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#jenkins #服务器 #自动化

Jenkins基础教程专栏收录该内容

199 篇文章

订阅专栏

引言：为什么Jenkins需要“版本记忆”

想象一下：凌晨三点，你被紧急呼叫惊醒——生产环境崩了！你战战兢兢地回滚代码，却绝望地发现根本不知道哪个版本是稳定的……这就是没有版本控制的灾难现场！

Jenkins作为CI/CD领域的超级明星，能够自动化完成构建、测试和部署。但如果它不能与版本控制系统（如Subversion）完美配合，就如同失去了记忆的超人，无法追溯代码的来龙去脉。

本文将带你一步步配置Jenkins与Subversion，打造一个拥有完美“版本记忆”的自动化部署系统。别担心，即使你是Jenkins新手，也能跟着我们的示例轻松上手！

一、基础准备：让Jenkins“认识”Subversion

1. 初识Jenkins与Subversion

Jenkins是一个开源的自动化服务器，专门用于自动化各种任务，包括构建、测试和部署软件。Subversion（简称SVN）是一个集中式版本控制系统，它帮助你跟踪源代码的所有更改历史。

为什么需要将它们结合？简单说，就是让Jenkins知道该从哪里获取代码，获取哪个版本的代码。当你在SVN中提交了新代码，Jenkins能自动感知并开始工作，实现真正的持续集成。

2. 安装Subversion插件

Jenkins本身并不直接具备与SVN对话的能力，需要安装专门的插件：

登录Jenkins，点击左侧菜单的 "Manage Jenkins" （管理Jenkins）
选择 "Manage Plugins" （管理插件）
切换到 "Available" （可用插件）选项卡
在搜索框中输入 "Subversion"
找到插件后勾选，点击 "Install without restart" （安装无需重启）或 "Download now and install after restart" （立即下载，重启后安装）

安装完成后，最好重启一下Jenkins服务确保插件完全加载。

坑位预警：有时插件会安装失败，通常是因为网络问题。可以尝试更换更新中心镜像或手动上传插件。

3. 配置SVN环境

在Jenkins服务器上，确保已经安装了SVN客户端：

# 在CentOS/RHEL上
sudo yum install -y subversion

# 在Ubuntu/Debian上  
sudo apt-get update
sudo apt-get install -y subversion

验证安装是否成功：

svn --version

二、实战演练：创建第一个SVN连接的Jenkins任务

1. 配置SVN认证信息

在与SVN通信前，Jenkins需要知道如何登录你的SVN仓库：

在Jenkins首页，点击 "Manage Jenkins" > "Manage Credentials"
找到 "Global credentials (unrestricted)" （全局凭证）并点击
点击 "Add Credentials" （添加凭证）
选择凭证类型为 "Username with password" （用户名和密码）
输入你的SVN用户名和密码
在ID字段留空（Jenkins会自动生成）或设置一个易记的ID
点击 "Create" （创建）

2. 创建自由风格项目并配置SVN

现在让我们创建一个实际使用SVN的Jenkins任务：

点击Jenkins首页的 "New Item" （新建任务）
输入任务名称，例如 "My-SVN-Project"
选择 "Freestyle project" （自由风格项目）
点击 "OK"

在项目配置页面，找到 "Source Code Management" （源码管理）部分：

选择 "Subversion" 单选框
在 "Repository URL" （仓库URL）字段中输入你的SVN地址，例如：http://svn.example.com/svn/myproject/trunk
从Credentials（凭证）下拉菜单中选择之前创建的凭证
其他选项保持默认即可

3. 高级SVN配置揭秘

有时候，你的项目可能需要更复杂的SVN配置：

多模块检出：如果你的项目由多个SVN模块组成，点击 "Add Module" （添加模块）即可添加多个仓库路径
排除区域：在 "Exclude Regions" （排除区域）中，你可以使用正则表达式指定哪些文件的变更不触发构建
本地目录自定义：在 "Local module directory" （本地模块目录）中，你可以指定代码检出到工作空间的哪个目录

4. 验证配置并执行首次构建

配置完成后，点击页面底部的 "Save" （保存）。现在，让我们手动触发第一次构建：

在项目主页，点击 "Build Now" （立即构建）
在Build History（构建历史）中，你会看到一个新的构建项
点击构建编号，然后选择 "Console Output" （控制台输出）查看详细日志

如果一切正常，你会看到类似这样的输出：

Started by user admin
Checking out a fresh workspace because there's no workspace at /var/lib/jenkins/workspace/My-SVN-Project
Checking out http://svn.example.com/svn/myproject/trunk at revision '2025-01-01T10:30:00.000Z'
U src/main/java/com/example/MyClass.java
At revision 12345
Finished: SUCCESS

恭喜！Jenkins已经成功从SVN检出代码！

三、进阶技巧：Pipeline中的SVN操作

1. 声明式Pipeline与SVN

对于更复杂的项目，推荐使用Jenkins Pipeline。Pipeline-as-Code允许你将构建流程定义为代码并存储在源代码库中（通常命名为Jenkinsfile）。

以下是一个基本的声明式Pipeline示例，它从SVN检出代码：

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                // 使用checkout步骤从SVN检出代码
                checkout([
                    $class: 'SubversionSCM',
                    locations: [[
                        credentialsId: 'your-credentials-id',
                        depth: 'infinity',
                        ignoreExternals: true,
                        local: '.',
                        remote: 'http://svn.example.com/svn/myproject/trunk'
                    ]],
                    workspaceUpdater: [
                        $class: 'UpdateUpdater'
                    ]
                ])
            }
        }
        stage('Build') {
            steps {
                // 这里添加你的构建步骤，例如使用Maven或Gradle
                sh 'mvn clean compile'
            }
        }
        stage('Test') {
            steps {
                // 运行测试
                sh 'mvn test'
            }
        }
    }
    post {
        always {
            // 构建后操作，例如发送通知
            echo 'Build completed'
        }
        success {
            mail to: 'team@example.com', subject: 'Build Success', body: 'The build was successful!'
        }
        failure {
            mail to: 'team@example.com', subject: 'Build Failed', body: 'The build failed!'
        }
    }
}

2. 脚本式Pipeline中的SVN

如果你更喜欢灵活的脚本式Pipeline，可以这样使用SVN：

node {
    stage('Checkout') {
        // 使用svn命令直接检出
        svn 'http://svn.example.com/svn/myproject/trunk'
    }
    stage('Build') {
        // 你的构建步骤
        bat 'msbuild MySolution.sln'  // Windows环境
        // 或 sh 'make'              // Linux/Unix环境
    }
}

3. 在多分支Pipeline中使用SVN

虽然Jenkins的多分支Pipeline功能最初是为Git设计的，但通过一些技巧也可以在SVN环境中实现类似功能：

为每个分支创建单独的Jenkins任务
使用Parameterized Trigger Plugin（参数化触发器插件）在不同分支的任务间传递参数
在Pipeline中通过参数指定要构建的分支

properties([parameters([string(name: 'BRANCH', defaultValue: 'trunk')])])

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                script {
                    // 使用参数化的分支路径
                    def svnUrl = "http://svn.example.com/svn/myproject/${params.BRANCH}"
                    checkout scm: [
                        $class: 'SubversionSCM', 
                        locations: [[
                            credentialsId: 'your-credentials-id',
                            local: '.',
                            remote: svnUrl
                        ]]
                    ]
                }
            }
        }
    }
}

四、SVN钩子与自动化触发

1. 配置SVN提交后自动构建

要实现SVN提交后自动触发Jenkins构建，需要配置SVN的post-commit钩子：

在SVN服务器上，找到你的仓库hooks目录（例如/var/svn/repos/hooks/）
创建或编辑post-commit文件（在Windows上可能是post-commit.bat）
添加以下内容：

#!/bin/bash
REPOS="$1"
REV="$2"
# 触发Jenkins构建
curl -X POST "http://jenkins.example.com/job/My-SVN-Project/build?token=MY_SECRET_TOKEN"

确保脚本有执行权限：chmod +x post-commit

2. 使用Jenkins的Poll SCM功能

如果无法直接访问SVN服务器设置钩子，可以使用Jenkins的Poll SCM（轮询SCM）功能：

在Jenkins任务配置中，找到 "Build Triggers" （构建触发器）部分
选择 "Poll SCM" （轮询SCM）
设置轮询计划，例如：H/5 * * * *（每5分钟检查一次SVN变更）

3. 参数化构建与SVN修订版

在某些场景下，你可能需要构建特定的SVN修订版，而不是最新版本。可以通过参数化构建来实现：

在任务配置中，勾选 "This project is parameterized" （此项目已参数化）
添加一个String Parameter（字符串参数），命名为SVN_REVISION
在SVN配置的Revision（修订版）字段中引用该参数：${SVN_REVISION}

这样，每次构建时都可以指定要构建的特定修订版。

五、避坑指南：常见问题与解决方案

1. 认证失败问题

问题：svn: E170001: Authentication failed for...

解决方案：

检查凭证的用户名和密码是否正确
确认Jenkins凭证配置中的用户名格式（有时需要域名前缀）
尝试在SVN仓库URL中直接包含凭证：http://username:password@svn.example.com/svn/myproject

2. SSL/TLS证书问题

问题：svn: E230001: Server SSL certificate verification failed...

解决方案：

在SVN服务器上安装有效的SSL证书
或者（不推荐用于生产环境）在Jenkins的SVN配置中勾选**"Manage SSL Protocol(s)"**（管理SSL协议）并忽略证书验证

3. 修订版冲突问题

问题：构建时出现svn: E160024: Already locked或类似修订版冲突

解决方案：

清理Jenkins工作空间
在SVN配置中设置合适的**"Check-out Strategy"**（检出策略）
对于Pipeline，可以配置workspaceUpdater来处理工作空间更新

4. 大仓库性能优化

当SVN仓库非常大时，可能会遇到性能问题：

使用**"Sparse checkout"**（稀疏检出）只检出需要的目录
调整**"Depth"**（深度）设置，避免检出完整历史
在不需要外部引用时勾选**"Ignore Externals"**（忽略外部引用）

六、完整示例：从零构建Java项目

让我们通过一个完整的示例，演示如何使用Jenkins和SVN构建一个Java Web应用：

1. 项目结构假设

假设你的SVN仓库结构如下：

http://svn.example.com/svn/myapp/
├── trunk/
│   ├── src/
│   ├── pom.xml
│   └── WebRoot/
├── branches/
└── tags/

2. Jenkins任务配置

创建名为**"MyApp-CI"**的自由风格项目
SVN仓库URL：http://svn.example.com/svn/myapp/trunk
添加构建步骤："Invoke top-level Maven targets"（调用顶层Maven目标）
Maven命令：clean compile war:war
添加后构建动作："Archive the artifacts"（归档制品）
归档文件：**/*.war

3. 对应的Pipeline版本

pipeline {
    agent any
    tools {
        // 假设已在Jenkins中配置了Maven
        maven 'M3'
    }
    stages {
        stage('Checkout') {
            steps {
                checkout([
                    $class: 'SubversionSCM',
                    locations: [[
                        credentialsId: 'svn-creds',
                        depth: 'infinity',
                        ignoreExternals: true,
                        local: '.',
                        remote: 'http://svn.example.com/svn/myapp/trunk'
                    ]]
                ])
            }
        }
        stage('Build') {
            steps {
                sh 'mvn clean compile'
            }
        }
        stage('Package') {
            steps {
                sh 'mvn war:war'
            }
        }
        stage('Archive') {
            steps {
                archiveArtifacts '**/*.war'
            }
        }
    }
}