1. 前置准备:安装Java环境
Jenkins是基于Java开发的自动化服务器,需先安装Java运行环境(推荐OpenJDK 11及以上)。在Ubuntu终端执行以下命令:
sudo apt update
sudo apt install openjdk-11-jdk -y
# 验证安装
java -version
若输出Java版本信息(如openjdk 11.0.xx),则说明安装成功。
2. 安装Jenkins
通过Ubuntu软件源安装Jenkins(官方源更稳定):
# 导入Jenkins官方GPG密钥
wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -
# 添加Jenkins源到APT
sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
# 更新包索引并安装Jenkins
sudo apt update
sudo apt install jenkins -y
安装完成后,启动Jenkins服务并设置开机自启:
sudo systemctl start jenkins
sudo systemctl enable jenkins
验证服务状态(显示“active (running)”即为成功):
sudo systemctl status jenkins
3. 访问Jenkins Web界面并初始化
在浏览器中输入http://<服务器IP>:8080(如http://192.168.1.100:8080),首次访问需输入初始管理员密码。密码可通过以下命令获取:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
输入密码后,按照界面提示完成以下步骤:
http://<服务器IP>:8080),点击“保存并完成”。4. 配置测试环境(以Maven项目为例)
若测试项目基于Maven(常见Java项目),需安装Maven插件并配置环境变量:
apache-maven-3.9.6),若已安装Maven可指定安装路径,否则勾选“Install automatically”自动下载。5. 创建Pipeline项目并配置Jenkinsfile
在Jenkins主页点击“New Item”,输入项目名称(如my-test-project),选择“Pipeline”类型,点击“OK”。
https://github.com/yourname/my-test-project.git),并添加仓库凭证(若仓库私有);Jenkinsfile(需与项目根目录下的文件名一致)。6. 编写Jenkinsfile定义测试流程
在项目根目录下创建Jenkinsfile(可使用文本编辑器或直接在Jenkins中编辑),内容示例如下(以Maven项目为例):
pipeline {
agent any // 使用任意可用节点执行
tools {
maven 'apache-maven-3.9.6' // 引用全局配置的Maven
jdk 'openjdk-11' // 引用全局配置的Java
}
stages {
stage('Checkout') {
steps {
git branch: 'main', url: 'https://github.com/yourname/my-test-project.git' // 拉取代码
}
}
stage('Build') {
steps {
sh 'mvn clean install' // 编译项目并打包
}
}
stage('Test') {
steps {
sh 'mvn test' // 运行单元测试(生成XML格式测试报告)
}
post {
always {
junit '**/target/surefire-reports/*.xml' // 发布测试报告(JUnit格式)
}
}
}
}
}
上述脚本依次完成“拉取代码→编译构建→运行测试→发布测试报告”的流程。
7. 触发构建并查看测试结果
#1),进入构建详情页,查看实时日志(确认mvn test命令是否执行成功);常见问题排查
sudo ufw allow 8080),或Jenkins服务是否启动(sudo systemctl status jenkins);junit路径是否正确(指向项目生成的测试报告目录,如Maven项目的target/surefire-reports);