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

在软件开发领域，持续集成(CI)已经成为现代工程实践的基石。通过将代码变更频繁地集成到共享主干中，团队能够尽早发现并解决集成问题，显著提高软件质量和交付效率。Jenkins作为最流行的开源持续集成工具，配合Maven构建工具和SVN版本控制系统，可以构建一套稳定可靠的自动化构建部署流水线。

这套技术组合特别适合中小型团队的Java Web项目开发场景。我曾在多个电商后台系统和金融支付平台项目中成功实施过类似方案，实测能够将代码提交到测试环境部署的时间从原来的2-3小时缩短到15分钟以内。下面将详细介绍从零开始搭建这套环境的完整过程，包含我在实际项目中积累的优化技巧和避坑指南。

2. 环境准备与基础安装

2.1 系统环境要求

推荐使用CentOS 7.x或Ubuntu 18.04 LTS作为基础操作系统，这两个版本在长期支持周期内，社区资源丰富。硬件配置建议至少2核CPU、4GB内存和50GB磁盘空间，特别是当需要并行执行多个构建任务时，内存容量直接影响构建效率。

注意：生产环境强烈建议使用专用服务器或虚拟机，避免在开发机上混用。我曾遇到过因开发机资源不足导致构建过程被中断的案例。

2.2 JDK安装与配置

Jenkins和Maven都依赖Java环境，推荐安装OpenJDK 11：

# CentOS
sudo yum install -y java-11-openjdk-devel

# Ubuntu
sudo apt-get install -y openjdk-11-jdk

安装后验证版本：

java -version

配置JAVA_HOME环境变量（路径可能因系统而异）：

echo 'export JAVA_HOME=/usr/lib/jvm/java-11-openjdk' >> ~/.bashrc
source ~/.bashrc

2.3 Tomcat部署优化

虽然Jenkins提供了直接运行的war包，但通过Tomcat部署更便于管理：

1. 下载Tomcat 9.x（与JDK 11兼容性最好）：

wget https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.54/bin/apache-tomcat-9.0.54.tar.gz
tar -xzf apache-tomcat-9.0.54.tar.gz
mv apache-tomcat-9.0.54 /usr/local/tomcat

2. 关键配置优化：

• 修改 /usr/local/tomcat/conf/server.xml 中的Connector配置，添加URIEncoding="UTF-8"：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443" 
           URIEncoding="UTF-8" />

• 调整JVM参数（在 /usr/local/tomcat/bin/setenv.sh 中）：

export CATALINA_OPTS="-Xms512m -Xmx1024m -XX:MaxPermSize=256m"

2.4 Maven安装与仓库配置

1. 下载并安装Maven 3.8.x：

wget https://dlcdn.apache.org/maven/maven-3/3.8.6/binaries/apache-maven-3.8.6-bin.tar.gz
tar -xzf apache-maven-3.8.6-bin.tar.gz
mv apache-maven-3.8.6 /usr/local/maven

2. 配置环境变量：

echo 'export MAVEN_HOME=/usr/local/maven' >> ~/.bashrc
echo 'export PATH=$PATH:$MAVEN_HOME/bin' >> ~/.bashrc
source ~/.bashrc

3. 关键配置优化（ /usr/local/maven/conf/settings.xml ）：

• 配置阿里云镜像仓库加速依赖下载：

<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>*</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

• 调整本地仓库位置（避免默认放在用户目录）：

<localRepository>/var/lib/maven-repo</localRepository>

2.5 SVN服务器搭建

1. 安装Subversion：

# CentOS
sudo yum install -y subversion

# Ubuntu
sudo apt-get install -y subversion

2. 创建版本库：

sudo mkdir -p /var/svn/repos
sudo svnadmin create /var/svn/repos/myproject

3. 权限配置（ /var/svn/repos/myproject/conf 目录下）：

• svnserve.conf：

[general]
anon-access = none
auth-access = write
password-db = passwd
authz-db = authz

• passwd文件添加用户：

[users]
dev1 = password1
dev2 = password2

• authz文件配置权限：

[groups]
developers = dev1,dev2

[/]
@developers = rw
* =

4. 启动SVN服务：

svnserve -d -r /var/svn/repos

3. Jenkins核心配置详解

3.1 Jenkins部署与初始化

1. 将Jenkins war包部署到Tomcat：

wget https://get.jenkins.io/war-stable/2.346.3/jenkins.war
mv jenkins.war /usr/local/tomcat/webapps/

2. 启动Tomcat并访问：

/usr/local/tomcat/bin/startup.sh

访问 http://服务器IP:8080/jenkins

3. 初始解锁：

cat /root/.jenkins/secrets/initialAdminPassword

4. 插件安装策略：

• 生产环境建议"选择插件来安装"，仅安装必要插件
• 必须安装的初始插件列表：
  • Maven Integration
  • Subversion
  • Deploy to container
  • Pipeline

经验：国内环境插件安装常因网络问题失败，可先配置清华镜像源再安装： 修改 /root/.jenkins/hudson.model.UpdateCenter.xml ：

<url>https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json</url>

3.2 系统全局配置

1. 工具链配置（系统管理 > 全局工具配置）：

• JDK：配置JAVA_HOME路径（/usr/lib/jvm/java-11-openjdk）
• Maven：配置MAVEN_HOME路径（/usr/local/maven）
• Git：如不使用可移除

2. 安全配置建议：

• 启用"矩阵授权策略"
• 为不同角色分配精确权限
• 开启"防止跨站点请求伪造"

3. 系统设置优化：

• 调整执行者数量（建议CPU核心数×2）
• 配置系统管理员邮箱
• 设置Jenkins URL（重要！后续webhook依赖此配置）

3.3 邮件通知配置

在系统设置中配置SMTP服务器，确保构建失败能及时通知：

1. 系统管理 > 系统配置
2. 填写SMTP服务器信息
3. 测试邮件发送
4. 配置默认邮件模板（可参考以下内容）：

构建项目：${PROJECT_NAME}
构建编号：${BUILD_NUMBER}
构建状态：${BUILD_STATUS}
触发原因：${CAUSE}
构建日志：${BUILD_URL}console
变更记录：${JELLY_SCRIPT,template="html"} 

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

4.1 创建Maven项目

1. 新建Item > 选择"Maven项目"
2. 基础配置：

• 项目名称：建议包含环境标识（如myproject-dev）
• 描述：简要说明项目用途
• 丢弃旧构建：设置保留策略（如保留最近10次）

3. 源码管理：

• 选择Subversion
• Repository URL：svn://服务器IP/myproject/trunk
• 认证：添加SVN账号凭证
• 高级选项：设置检出策略（推荐"使用SVN更新"）

4.2 构建触发器配置

1. 轮询SCM（简单但不推荐）：

H/5 * * * *  # 每5分钟检查一次变更

2. Webhook触发（推荐方案）：

• 安装"Generic Webhook Trigger"插件
• 生成随机token
• 配置SVN的post-commit钩子调用此URL

3. 定时构建（适用于每日构建）：

0 2 * * *  # 每天凌晨2点执行

4.3 Maven构建配置

1. 根POM：指定pom.xml相对路径（默认为./pom.xml）
2. 目标和选项：

clean package -DskipTests

注意：首次构建建议不加-DskipTests参数，确保测试能通过

3. 高级选项：

• 设置MAVEN_OPTS：-Xmx512m -XX:MaxPermSize=128m
• 勾选"增量构建"加速后续构建

4.4 构建后操作

1. 归档制品：

**/target/*.war

2. 部署到容器：

• 添加"Deploy war/ear to a container"
• 选择Tomcat 9.x
• 配置Manager凭证（需先在Tomcat的conf/tomcat-users.xml中添加）

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

3. 邮件通知：

• 配置失败时发送
• 添加开发团队邮件列表

5. 高级配置与优化技巧

5.1 构建性能优化

1. 并行构建配置：

• 系统配置 > 执行者数量（建议CPU核心数×2）
• 项目配置 > 勾选"在必要时并行构建"

2. Maven构建缓存：

• 配置settings.xml中的localRepository为共享目录
• 对多模块项目使用--projects参数指定变更模块

3. 构建节点扩展：

• 添加Linux/Windows从节点分担构建负载
• 配置标签匹配构建环境需求

5.2 安全加固措施

1. 权限控制矩阵：

• 为不同角色创建独立账号
• 精确控制"构建"、"配置"、"查看"等权限

2. 凭证管理：

• 使用Jenkins凭证存储数据库密码等敏感信息
• 定期轮换凭证

3. 审计日志：

• 安装Audit Trail插件记录关键操作
• 配置日志自动归档

5.3 备份与恢复策略

1. 定期备份JENKINS_HOME：

tar -czf jenkins-backup-$(date +%Y%m%d).tar.gz /root/.jenkins

2. 关键配置文件备份：

• jobs目录下的config.xml
• credentials.xml
• config.xml

3. 使用ThinBackup插件：

• 配置定时备份
• 设置保留策略
• 测试恢复流程

6. 常见问题排查指南

6.1 构建失败分析

1. 依赖下载失败：

• 检查Maven镜像配置
• 清理本地仓库后重试
• 网络连通性测试

2. 测试用例失败：

• 查看具体失败的测试类
• 检查测试环境差异
• 临时跳过：mvn test -Dtest=!MyTestClass

3. 内存不足：

• 调整MAVEN_OPTS增加内存
• 分模块构建

6.2 部署问题排查

1. Tomcat Manager访问403：

• 检查tomcat-users.xml角色配置
• 确认IP没有被拒绝

2. 文件权限问题：

chown -R tomcat:tomcat /usr/local/tomcat/webapps

3. 端口冲突：

netstat -tulnp | grep 8080

6.3 SVN集成问题

1. 认证失败：

• 检查SVN服务是否运行
• 确认authz和passwd文件权限
• 测试命令行svn co

2. 钩子不触发：

• 检查post-commit可执行权限
• 手动执行测试
• 查看SVN服务日志

3. 中文路径问题：

• 确认locale设置为zh_CN.UTF-8
• 检查Jenkins系统编码设置

7. 生产环境最佳实践

7.1 高可用架构设计

1. Jenkins Master-Slave架构：

• 主节点只做调度
• 构建任务分发到多个从节点

2. 负载均衡配置：

• Nginx反向代理
• 会话保持配置

3. 数据库分离：

• 将Jenkins元数据迁移到外部MySQL
• 定期优化表结构

7.2 监控与告警

1. 基础资源监控：

• CPU/内存/磁盘使用率
• 构建队列长度

2. 构建质量指标：

• 构建成功率
• 构建时长趋势
• 测试覆盖率

3. 集成Prometheus：

• 安装Metrics插件
• 配置Grafana仪表盘

7.3 版本升级策略

1. 测试环境验证：

• 完整备份
• 验证插件兼容性

2. 滚动升级：

• 逐个节点升级
• 监控异常情况

3. 回退方案：

• 备份恢复演练
• 关键时点快照

这套Jenkins+Maven+SVN持续集成环境经过多个项目的实战检验，能够显著提升开发团队的交付效率。特别是在应对紧急修复和频繁迭代的场景下，自动化构建部署的优势更加明显。建议团队在初期先建立基础流程，再逐步引入代码质量扫描、自动化测试等高级功能，最终形成完整的DevOps流水线。