基于 Docker、Playwright 与 Jenkins 的 Web 自动化测试实践

三、部署 Jenkins

3.1 拉取 Jenkins 镜像

建议拉取长期支持版本：

docker pull jenkins:lts

3.2 创建并启动 Jenkins 容器

docker run -d \
  --name zjjenkins \
  -p 8001:8080 \
  -p 50001:50000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /usr/bin/docker:/usr/bin/docker \
  -v /home/jenkins:/var/jenkins_home \
  -v /etc/localtime:/etc/localtime:ro \
  jenkins/jenkins:lts

3.3 权限问题的解决

以 root 用户进入容器并修改权限：

docker exec -u root -it zjjenkins bash
chmod 755 /usr/bin/docker
exit

四、Jenkins 流水线配置

4.1 创建流水线任务

在 Jenkins 中创建流水线任务，命名为 test。

4.2 配置流水线脚本

pipeline {
   agent { 
      docker { 
         image 'mcr.microsoft.com/playwright/python:v1.57.0-noble'
         args '-v ${WORKSPACE}:/workspace -w /workspace --user root'
      } 
   }

   stages {  
      stage('e2e-tests') {  
         steps {  
            sh '''  
               # 安装依赖  
               pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple/

               # 修正包名  
               pip uninstall -y pytest-playwright || true

               # 安装 allure-pytest  
               pip install allure-pytest -i https://pypi.tuna.tsinghua.edu.cn/simple/

               # 关键修改：使用 python -m pytest 而不是 pytest  
               python -m pytest testcases/ -v -s  
            '''  
         }  
      }  
   }  
}

4.3 测试失败的处理

如果测试用例中有断言失败的情况，Pipeline 任务会失败。如果希望测试失败时 Pipeline 不失败，可以使用 pytest 的 --tb=no 和 -x 选项。

五、生成测试报告

最后一步是在 Jenkins 中生成测试报告，具体操作可以根据项目的需要进行配置。