測試實戰”：Jenkins+Docker+Playwright自動化測試全鏈路

自動化測試當然需要自動的運行，Jenkins作為一款經典的持續集成工具仍被廣泛應用于企業的自動化測試部署和執行。

作為測試工程師掌握Jenkins的使用，能夠有效提升測試效率從而擴大自動化測試的影響力！

本篇文章主打一個實戰干貨，直接帶大家通過一個demo project學習使用Jenkins運行Playwright測試并生成報告的完整鏈路實現。

最終效果：我們將實現什么？

一鍵執行，全程自動化

在 Jenkins 點擊“構建”，流水線將自動拉取最新代碼，在隔離的容器中準備好所有環境，并運行 Playwright 測試。

Allure報告集成

生成Allure測試報告并且可以通過Jenkins直接查看

郵件即時通知

運行測試結束后，自動發送包含構建狀態、測試信息和Allure報告鏈接的郵件。

準備工作

1.Docker

本文將會使用Docker的方式安裝Jenkins，并且playwright測試也會在容器中執行

2.Playwright 測試項目

●準備一個可正常運行的 Python Playwright + Pytest 項目。

●如果需要一個示例項目，可以從我的 GitHub 倉庫獲?。篬https://github.com/bridgeshi85/playwright-pytest-allure-framework]

3.郵件發送服務

準備一個 SMTP 郵箱賬號（推薦163郵箱）

部署Jenkins服務

1. 準備 Jenkins 鏡像

首先創建一個 Dockerfile，代碼如下

FROM jenkins/jenkins:lts USER root # -------- Install Docker CLI -------- RUN apt-get update && \ apt-get install -y \ ca-certificates \ curl \ gnupg \ lsb-release && \ install -m 0755 -d /etc/apt/keyrings && \ curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /etc/apt/keyrings/docker.gpg && \ chmod a+r /etc/apt/keyrings/docker.gpg && \ echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null && \ apt-get update && \ apt-get install -y docker-ce-cli docker-compose-plugin && \ rm -rf /var/lib/apt/lists/* # -------- Install Jenkins plugins (as root) -------- COPY plugins.txt /usr/share/jenkins/plugins.txt RUN jenkins-plugin-cli --plugin-file /usr/share/jenkins/plugins.txt EXPOSE 8080

重點說明:

●Jenkins需要通過docker命令啟動容器，playwright的測試會運行在宿主機的容器中(稍后會提到)，所以需要安裝docker cli命令行工具

●為了避免Jenkins Pipeline 中執行 Docker 命令時出現 permission denied，使用了root用戶。但是需注意，盡量避免在生產環境中這樣操作

● 通過jenkins-plugin-cli預先安裝了以下plugin，具體文件在示例項目jekins目錄下plugins.txt中, 內容如下：

workflow-aggregator:2.7git:5.8.0docker-workflow:1.28credentials-binding:702.vfe613e537e88ssh-agent:295.v9ca_a_1c7cc3a_a_email-ext:2.102allure-jenkins-plugin:2.33.0

準備完成后在Dockerfile和plugins.txt所在目錄下執行以下命令來構建鏡像：

docker build -t my-jenkins:latest .

2. 啟動 Jenkins

首先通過以下命令確認自己的 Docker Socket 使用的路徑：

docker context ls

運行后可以看到以下內容：

NAME DESCRIPTION DOCKER ENDPOINT ERRORdefault DOCKER_HOST based configuration unix:///var/run/docker.sockdesktop-linux* Docker Desktop unix:///Users/xxxx/.docker/run/docker.sock

接著使用 docker 運行 Jenkins 容器

docker run -d \ --name my-jenkins \ -p 8080:8080 \ -p 50000:50000 \ -v jenkins_home:/var/jenkins_home \ -v ~/.docker/run/docker.sock:/var/run/docker.sock \ my-jenkins:latest

注意啟動 Jenkins 容器時，需要將宿主機上 Docker Desktop 使用的 socket 路徑（~/.docker/run/docker.sock）掛載到容器內的 /var/run/docker.sock。

它的作用是什么？默認情況下，容器內部無法直接運行底層的 Docker 命令。

因此，我們將宿主機的 Docker Socket 目錄映射到 Jenkins 容器中，使 Jenkins 能夠調用宿主機的 Docker 啟動測試容器。這種方式通常稱為 Docker outside Docker（DoD）模式。

3. 初始化 Jenkins

Jenkins 容器成功運行后，打開瀏覽器訪問 http://localhost:8080，將會看到 Jenkins 的“解鎖”頁面

初始密碼可以從容器日志中獲取。因為之前啟動的容器名為 my-jenkins，可以執行以下命令查看其啟動日志：

docker logs my-jenkins

在日志輸出中向下滾動，找到被 ***包圍的部分，其中的字符串就是密碼。

[LF]> [LF]> *************************************************************[LF]> *************************************************************[LF]> *************************************************************[LF]> [LF]> Jenkins initial setup is required. An admin user has been created and a password generated.[LF]> Please use the following password to proceed to installation:[LF]> [LF]> d26b15f6f46f415ca77ee3f06faa1fbc[LF]> [LF]> This may also be found at: /var/jenkins_home/secrets/initialAdminPassword[LF]> [LF]> *************************************************************[LF]> *************************************************************[LF]> *************************************************************

將初始密碼復制并粘貼到瀏覽器的輸入框中，點擊“繼續”。隨后按照引導安裝推薦的插件，等待安裝完成并設置好你的管理員賬號后，就可以正式進入我們的 Jenkins 了！

創建 Pipeline Job 并運行測試

準備測試環境：啟動被測應用與構建測試鏡像

為了讓測試順利運行，本文準備了一個簡單的 demo 前端項目（demo-frontend）作為被測系統。你可以通過倉庫獲取相關代碼：

[https://github.com/bridgeshi85/playwright-pytest-allure-framework]

接下來，我們將搭建測試環境并構建Playwright測試鏡像。

構建并運行前端應用

為了讓 Jenkins 中的測試容器能夠訪問到被測應用，我們首先需要創建一個Docker網絡

docker network create e2e-test

進入 demo-frontend 目錄，構建應用鏡像并啟動容器。關鍵點在于使用 --network 參數將容器加入我們剛創建的 e2e-test 網絡。

# 構建鏡像docker build -t demo-frontend:latest .# 啟動容器，并加入網絡docker run -d \ --name demo-frontend \ --network e2e-test \ -p 3000:80 \ demo-frontend:latest

構建測試代碼運行鏡像

在測試代碼所在的目錄（playwright-automation-test）下，打開終端執行以下命令。請注意，鏡像名稱 playwright-test-agent:latest 必須與后續 Jenkinsfile 中指定的名稱保持一致。

docker build -t playwright-test-agent:latest .

至此，測試所需的基礎設施（測試應用和鏡像）已準備完成。

第一步:在Jenkins Pipeline中運行測試

1、在 Jenkins 首頁左側點擊 New Item（新建任務）。

2、輸入任務名稱(例如：Playwright-UI-E2E)，選擇 Pipeline（流水線），點擊 OK。

3、下拉至 Pipeline 區域，選擇 Pipeline script 并將以下代碼貼入

pipeline { agent any stages { stage('Checkout') { agent any steps { git branch: 'main', url: 'https://github.com/bridgeshi85/playwright-pytest-allure-framework' } } stage('Run UI Tests (Playwright Agent)') { agent { docker { image 'playwright-test-agent:latest' args '--network e2e-test' pipeline { agent any stages { stage('Checkout') { agent any steps { git branch: 'main', url: 'https://github.com/bridgeshi85/playwright-pytest-allure-framework' } } stage('Run UI Tests (Playwright Agent)') { agent { docker { image 'playwright-test-agent:latest' args '--network e2e-test' reuseNode true } } steps { sh ''' set -euxo pipefail echo "Running tests..." cd playwright-automation-test pytest tests/test_login.py --env=jenkins -s ''' } } } }

該 Pipeline 中定義了兩個主要階段：代碼拉取和在執行測試。

階段一：代碼拉?。╯tage('Checkout')）

從 GitHub 倉庫拉取代碼，指定分支為 main

階段二：運行 UI 測試（stage('Run UI Tests (Playwright Agent)')）

① 使用 docker agent，指定鏡像 playwright-test-agent:latest，并通過加入網絡 e2e-test，這樣我們的測試容器就能找到 demo-frontend 應用

② 在容器內執行以下命令 Shell 命令。

●set -euxo pipefail：設置 Bash 選項，確保腳本嚴格執行、打印命令并在錯誤時退出。

●echo "Running tests..."：輸出日志。

●cd playwright-automation-test：切換到測試目錄。

●pytest tests/test_login.py --env=jenkins -s：通過 pytest 執行測試

備注：本示例倉庫已設為公開訪問，因此可以直接拉取。如果是私有倉庫，請使用自己的 GitHub Token。

4、運行測試

準備就緒后，點擊左側菜單欄中的 立即構建（Build Now） 運行測試，運行完成后可以在任務日志中看到如下內容

第二步：展示 Allure 報告

測試通過后會在工作區生成 Allure 報告文件，我們可以通過 Jenkins 的 Allure 插件直接在 Jenkins 中展示報告。

配置步驟

1、進入全局工具配置：在 Jenkins 頁面右上角點擊 系統配置，然后找到并點擊 Tools（全局工具配置）

2、添加 Allure Commandline：

●在配置頁面中向下滾動，找到 Allure Commandline 區域，點擊 Add Allure Commandline

●輸入別名，并勾選自動安裝

●在下拉菜單中選擇一個較新的版本，并選擇默認從 Maven Central 下載即可。

3、在 Job 中配置 Allure

回到之前創建的 Pipeline Job，修改 Pipeline 腳本，在 stages 部分之后添加以下代碼：

post { always { allure( includeProperties: false, jdk: '', resultPolicy: 'LEAVE_AS_IS', results: [[path: 'playwright-automation-test/reports/allure-results']] ) }}

再次 Build 之后，我們可以在構建頁面中看到 Allure Report 的鏈接

第三步：發送郵件報告

最后一步是將測試結果和報告鏈接及時推送給團隊郵箱，便于測試成果的共享與同步。Jenkins 提供了郵件插件 emailext（Extended E-mail Notification）來幫助我們實現。

Jenkins Email 插件配置步驟

首先，需要準備一個已開通 SMTP 的郵箱，這里以 163 郵箱為例（SMTP 設置方法不再贅述）。郵箱準備好后，回到 Jenkins 進行插件配置：

1、添加郵箱 Credentials：

●進入 Manage Jenkins（系統管理）→ Security → Credentials

●點擊 + Add Credentials，選擇 Username with password

●Username 填寫郵箱地址，Password 填寫 SMTP 授權碼（不是郵箱登錄密碼）

2、配置插件：

●進入 Manage Jenkins（系統管理）→ System

●向下滾動找到 Extended E-mail Notification（注意：頁面中還有一個普通的“E-mail Notification”，實測兩者任選其一即可，也可都填寫）

3、填寫參數：

●SMTP server：輸入 smtp.163.com

●SMTP port：輸入 465

●Use SSL：勾選

●Credentials：選擇之前創建的 163 郵箱憑證

●Default user e-mail suffix：輸入 @163.com

4、配置 Jenkins 默認發送的郵箱地址：

●進入 Manage Jenkins（系統管理）→ System

●System Admin e-mail address 中填寫與第一步相同的 Username（由于 163 安全設置，SMTP 發送時的郵箱地址必須一致）

Pipeline 中添加郵件通知步驟

配置完成后，我們回到之前創建的 Pipeline，在 allure step 后添加以下步驟：

emailext( subject: "[${env.JOB_NAME}] Build #${env.BUILD_NUMBER} - ${currentBuild.currentResult}", to: "${params.EMAIL_RECIPIENTS}", mimeType: 'text/html', body: """ """)

Build Status: ${currentBuild.currentResult}

Job: ${env.JOB_NAME}

Build Number: ${env.BUILD_NUMBER}

Build URL: ${env.BUILD_URL}

Allure Report: View Report

Build 完成后，Jenkins 就會自動將這封包含了測試結果的郵件，發送到我們在觸發時填寫的收件人郵箱里：

??想要提升自己的薪資，想要在行業走得更長久更好，不妨提升自己的技能，

??如果你當前的工作已經達到天花板，選擇換個行業，也許會事半功倍。

??如果你渴望高薪崗位或者想要轉行，可以戳??????

公主號【Atstudy技術社區】，內含項目實戰等各種資料包