1. 持续集成环境搭建概述

在软件开发领域，持续集成(CI)已经成为现代工程实践的核心环节。通过将Jenkins、Maven和SVN这三个工具链整合，我们可以构建一个高效的自动化构建和部署流水线。这套组合特别适合传统Java Web项目的持续集成需求，能够实现代码提交后的自动构建、测试和部署。

我曾在多个企业级项目中实施过这种架构，实测下来这套方案具有以下优势：

• 版本控制与构建工具无缝衔接
• 构建过程标准化且可重复
• 部署效率提升显著（从手动部署的30分钟缩短到3分钟）
• 问题发现提前到开发阶段

2. 环境准备与工具安装

2.1 基础环境配置

在开始之前，我们需要准备以下基础环境：

• 操作系统：CentOS 7.x（生产环境推荐）或Windows Server
• Java环境：JDK 1.8+
• Web容器：Tomcat 8.5+

注意：JDK版本必须与项目要求的版本严格匹配，否则可能导致构建失败。我曾遇到过因JDK版本不兼容导致的NoSuchMethodError问题。

安装Tomcat时需要特别注意：

# 解压后需要配置环境变量 export CATALINA_HOME=/opt/tomcat export PATH=$PATH:$CATALINA_HOME/bin

2.2 SVN服务器搭建

SVN作为版本控制系统，需要特别关注权限配置：

1. 创建仓库：

svnadmin create /var/svn/repos

2. 配置权限文件：

• svnserve.conf：设置anon-access = none
• authz：配置用户组和路径权限
• passwd：设置用户密码

实际项目中，我建议采用分组权限管理，比如： [groups] dev = user1,user2 [repo:/trunk] @dev = rw

2.3 Maven安装与配置

Maven的配置有两个关键点：

1. settings.xml配置：

<mirrors> <mirror> <id>aliyun</id> <url>https://maven.aliyun.com/repository/public</url> <mirrorOf>central</mirrorOf> </mirror> </mirrors>

2. 环境变量配置：

export MAVEN_HOME=/opt/apache-maven export PATH=$PATH:$MAVEN_HOME/bin

3. Jenkins核心配置

3.1 Jenkins安装与初始化

将jenkins.war部署到Tomcat的webapps目录后，首次访问时需要：

1. 获取初始密码：

cat ~/.jenkins/secrets/initialAdminPassword

2. 插件安装选择"安装推荐插件"
3. 创建管理员账户

踩坑提醒：网络不稳定时插件安装容易失败，建议先配置国内镜像源： 修改hudson.model.UpdateCenter.xml中的url为： https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

3.2 系统工具配置

在"全局工具配置"中需要设置：

1. JDK：指定JAVA_HOME路径
2. Maven：指定MAVEN_HOME路径
3. 可选配置Git（如果项目使用）

建议配置示例：

• JDK: /usr/java/jdk1.8.0_251
• Maven: /opt/apache-maven-3.6.3

3.3 必要插件安装

必须安装的插件包括：

• Maven Integration
• Subversion
• Deploy to container
• Locale（中文支持）

插件安装技巧：

1. 先安装Maven Integration插件
2. 重启Jenkins后再安装其他插件
3. 遇到安装失败时，多尝试几次或更换镜像源

4. 项目配置与自动化构建

4.1 创建Maven项目

1. 新建Item → 选择"Maven项目"
2. 配置SVN仓库地址：svn://your-svn-server/project/trunk
3. 配置构建触发器：Poll SCM（建议H/5 * * * *）

经验分享：SVN URL建议添加@HEAD后缀，如svn://server/repo@HEAD，可以避免缓存问题导致无法获取最新代码。

4.2 构建配置关键点

在项目配置中需要特别注意：

1. POM文件位置：通常是pom.xml
2. 构建目标和选项：clean package
3. 高级设置中的MAVEN_OPTS：

-Xms512m -Xmx1024m -Dmaven.test.skip=true

4.3 构建后部署配置

在"构建后操作"中添加"Deploy war/ear to a container"：

1. 指定WAR文件路径：target/*.war
2. 选择容器类型：Tomcat 8.x
3. 配置管理凭据（Tomcat manager账号）

配置示例：

<role rolename="manager-script"/> <user username="deploy" password="deploy123" roles="manager-script"/>

5. 自动化触发与钩子配置

5.1 SVN钩子脚本配置

post-commit钩子示例：

#!/bin/sh REPOS="$1" REV="$2" curl -X post -u jenkins:password http://jenkins-server/job/project/build?token=TOKEN

权限设置：

chmod +x /var/svn/repos/hooks/post-commit

5.2 Jenkins安全配置

对于Jenkins 2.0+版本，需要处理CSRF防护：

1. 获取crumb：

curl -u admin:password http://jenkins/crumbIssuer/api/json

2. 在钩子脚本中添加crumb：

curl -X post -H "Jenkins-Crumb:crumb-value" -u jenkins:password http://jenkins/job/project/build?token=TOKEN

6. 常见问题排查

6.1 构建失败常见原因

1. 代码编译错误：

• 检查控制台输出中的具体错误
• 本地执行mvn clean package验证

2. 依赖下载失败：

• 检查Maven镜像配置
• 删除本地仓库中.lastUpdated文件后重试

3. 权限问题：

• SVN访问权限
• Tomcat部署权限
• Jenkins执行权限

6.2 性能优化建议

1. Jenkins JVM参数调整：

JAVA_OPTS="-Xms1024m -Xmx2048m -XX:MaxPermSize=512m"

2. 构建节点分离：将构建任务分配到slave节点
3. 定期清理工作空间：

# 在构建后操作中添加 rm -rf *

6.3 日志分析技巧

1. 关键日志位置：

• Jenkins日志：/var/log/jenkins/jenkins.log
• Tomcat日志：/opt/tomcat/logs/catalina.out
• Maven构建日志：工作空间下的构建编号目录

2. 日志分析命令：

grep -i error jenkins.log | tail -n 50

7. 进阶配置与扩展

7.1 多环境部署策略

通过参数化构建实现：

1. 在项目配置中勾选"参数化构建过程"
2. 添加Choice参数：DEPLOY_ENV（dev/test/prod）
3. 在构建脚本中根据参数选择不同配置

7.2 邮件通知配置

1. 安装Email Extension插件
2. 配置系统管理员邮箱
3. 在项目配置中添加构建后操作"Editable Email Notification"

邮件模板示例：

构建项目：${PROJECT_NAME} 构建状态：${BUILD_STATUS} 构建编号：${BUILD_NUMBER} 变更记录：${CHANGES} 构建日志：${BUILD_URL}console

7.3 与IDE集成技巧

1. Eclipse集成：

• 安装Jenkins插件
• 配置Jenkins服务器连接
• 右键项目 → Team → Show History

2. IntelliJ IDEA集成：

• 安装Jenkins Control插件
• 配置服务器URL和凭证
• 通过工具栏直接触发构建

这套持续集成环境在实际项目中表现稳定，特别是在中型Java Web项目中，从代码提交到生产部署的全流程自动化可以节省大量时间。根据我的经验，团队采用这套方案后，部署频率可以从每周1-2次提升到每天多次，同时显著降低了人为错误率。