温馨提示×

Ubuntu Jenkins如何测试运行

小樊
51
2025-10-20 17:36:58
栏目: 智能运维

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

输入密码后,按照界面提示完成以下步骤:

  • 安装插件:选择“安装推荐的插件”(包含Pipeline、Git、JUnit等核心插件,支持自动化测试流程);
  • 创建管理员账户:填写用户名、密码、邮箱等信息,完成账户创建;
  • 配置实例:保持默认URL(http://<服务器IP>:8080),点击“保存并完成”。

4. 配置测试环境(以Maven项目为例)
若测试项目基于Maven(常见Java项目),需安装Maven插件并配置环境变量:

  • 安装Maven插件:进入Jenkins“Manage Jenkins”→“Manage Plugins”,搜索“Maven Integration”,点击“安装”;
  • 配置Maven:进入“Manage Jenkins”→“Global Tool Configuration”,找到“Maven” section,点击“新增Maven”,填写名称(如apache-maven-3.9.6),若已安装Maven可指定安装路径,否则勾选“Install automatically”自动下载。

5. 创建Pipeline项目并配置Jenkinsfile
在Jenkins主页点击“New Item”,输入项目名称(如my-test-project),选择“Pipeline”类型,点击“OK”。

  • 配置代码仓库:在“Pipeline” section,选择“Pipeline script from SCM”,SCM类型选“Git”,填写代码仓库URL(如https://github.com/yourname/my-test-project.git),并添加仓库凭证(若仓库私有);
  • 指定Jenkinsfile路径:在“Script Path”中填写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. 触发构建并查看测试结果

  • 触发构建:回到Jenkins项目页面,点击“Build Now”(立即构建),构建状态会在“Build History”中显示(如“蓝色圆圈”表示成功,“红色圆圈”表示失败);
  • 查看构建日志:点击构建编号(如#1),进入构建详情页,查看实时日志(确认mvn test命令是否执行成功);
  • 查看测试报告:在构建详情页,点击“Test Result” tab,即可查看JUnit测试报告(包含测试用例数、通过率、失败用例详情等)。

常见问题排查

  • 无法访问Web界面:检查服务器防火墙是否开放8080端口(sudo ufw allow 8080),或Jenkins服务是否启动(sudo systemctl status jenkins);
  • 测试报告无法发布:确认Jenkinsfile中的junit路径是否正确(指向项目生成的测试报告目录,如Maven项目的target/surefire-reports);
  • 构建失败:查看构建日志中的错误信息(如Java版本不匹配、依赖缺失),调整Jenkins配置或项目代码。

0