在用Python做自動化測試時，我們寫好代碼，然后需要執行才能得到測試報告，這時我們可以通過 Jenkins 來進一步完成自動化工作。借助Jenkins，我們可以結合 Git/SVN 自動拉取代碼，通過設置定時構建實現自動觸發腳本執行，得到測試報告，最后還可以配置發送郵件等。今天我們就來分享下，如何結合 Git自動拉取代碼，通過構建來自動執行python腳本輸出測試報告。
Jenkins是開源的，使用JAVA編寫的持續集成工具。需要安裝JDK，如果已經安裝了JDK可以跳過該步驟。
1. 安裝JDK
官網下載 JDK
將下載好的壓縮包放在linux上
然后解壓Java到相應目錄：
輸入命令：tar -zxvf jdk-11.0.8_linux-x64_bin.tar.gz /home/java
如果提示沒有tar命令，輸入yum install -y tar，先安裝tar
編輯環境變量，在/etc/profile文件中添加環境變量：
輸入命令：vim /etc/profile
在文件最后添加內容如下，然后保存：
JAVA_HOME=/home/java/jdk-11.0.8
JRE_HOME=$JAVA_HOME/jre
PATH=$PATH:$JAVA_HOME/bin
CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
export JAVA_HOME
export JRE_HOME
export PATH
export CLASSPATH
輸入命令source /etc/profile，刷新環境變量配置文件使其立刻生效
到此，JDK已經安裝完成。輸入java -version查看是否安裝成功，出現如下圖即安裝成功。
PS：建議建一個Java的超鏈接。建立之后默認情況下從/usr/bin/java路徑使用Java，yum安裝的時候，這個鏈接會自動創建。
輸入命令ln -s /home/java/jdk-11.0.8/bin/java /usr/bin/java
2. 安裝Jenkins
官網：https://www.jenkins.io/download/
選擇對應的操作系統或者使用yum方式安裝，這里我使用的是yum，因為比較方便：
yum的repos中默認是沒有Jenkins的，所以我們需要先將Jenkins存儲庫添加到yum repos中。
點擊官網中【centos/Fedora/Red Hat】系統，然后將命令復制粘貼到Linux系統中。
之后就可以看到系統開始自動下載安裝。若出現提示是否下載輸入：y并按回車。耐心等待安裝完成。
啟動Jenkins，命令：service jenkins start，出現ok表示Jenkins啟動成功。
在瀏覽器輸入ip:8080進入Jenkins登錄頁面，輸入密碼。至此，Jenkins安裝完成。
3. Job配置
新建一個自由風格的項目
進入工程配置頁面，在源碼管理下，選擇Git：
如果源碼管理中沒有Git，說明你沒有安裝Git插件。點擊【Manage Jenkins】，選擇【Manage Plugins】，選擇【可選插件】，在【搜索框】中輸入git plugin，下載該插件。
安裝成功如圖所示，然后重啟【Jenkins】：
構建執行shell，根據自己的腳本輸入pytest命令。也就是說Jenkins將Git倉庫代碼下載之后，我們要怎么通過命令去執行腳本，這個根據自己執行腳本的情況填寫即可，這里和我們手工執行腳本的操作是一致的，然后點擊保存。
點擊【Build Now[立即構建]】，可以看到正在執行的構建Job
4. 測試報告
當用例執行完成之后，我們想看用例執行的情況，而pytest不僅支持pytest-html插件，還可以使用allure生成更加美觀的測試報告。Allure框架是一個靈活的輕量級多語言測試報告工具，它不僅以web的方式展示了簡介的測試結果，而且允許參與開發過程的每個人從日常執行的測試中最大限度的提取有用信息。所以我們這里選擇的是Allure框架。
從dev/qa的角度來看，Allure報告簡化了常見缺陷的統計：失敗的測試可以分為bug和被中斷的測試，還可以配置日志、步驟、fixture、附件、計時、執行歷史以及與TMS和BUG管理系統集成，所以，通過以上配置，所有負責的開發人員和測試人員可以盡可能的掌握測試信息。
從管理者的角度來看，Allure提供了一個清晰的“大圖”，其中包括已覆蓋的特性、缺陷聚集的位置、執行時間軸的外觀以及許多其他方便的事情。allure的模塊化和可擴展性保證了您總是能夠對某些東西進行微調，使Allure更適合您，那么今天我們就來說說如何使報告更加詳細的顯示我們需要的信息，以及allure與jenkins的集成。
4.1 下載Allure插件與配置Allure
點擊【Manage Jenkins】，選擇【Manage Plugins】，選擇【可選插件】，在【搜索框】中輸入Allure，下載該插件。下載成功之后重啟Jenkins。
進入全局工具配置【Global Tool Configuration】，下拉最后一項，會看到【Allure Commandline】項，按下圖配置之后保存即可：
進入配置，點擊【構建后操作(Post-build Actions)】，選擇Allure Report
Results：輸入Path路徑，這里的path路徑表示在項目根目錄下生成此文件夾，文件夾用來保存生成html報告之前所依賴的json，xml，txt等類型文件。
Report path：輸入保存html報告路徑。
點擊【Build Now[立即構建]】，執行結束之后可以看到生成的Allure報告
4.2 Allure報告展示
5. 發送郵件
Jenkins默認提供了一個郵件通知E-mail Notification，但功能有很多的局限性，不夠靈活。比如：無法定義郵件的格式、郵件通知無法提供詳細的郵件內容。在這里我們使用Email Extension Plugin插件。該插件能夠允許你自定義郵件發送的具體內容、郵件格式等。
5.1 下載Email插件與配置Email
點擊【Manage Jenkins】，選擇【Manage Plugins】，選擇【可選插件】，在【搜索框】中輸入Email Extension Plugin，下載該插件。下載成功之后重啟Jenkins。
進入系統設置【System Configuration】,找到【Jenkins Location】，設置Jenkins URL與發件人的郵件地址
找到“Extended E-mail Notification”，設置以下內容：
詳細參數介紹：
- Override Global Settings：如果不選，該插件將使用默認的E-mail Notification通知選項。反之，可以通過指定不同于的設置來進行覆蓋。
- Default Content Type：指定構建后發送郵件內容的類型，有Text和HTML兩種。
- Use List-ID Email Header：為所有的郵件設置一個List-ID的郵件信頭。
- Add 'Precedence：bulk' Email Header：設置優先級。
- Default Recipients：自定義默認電子郵件收件人列表。
- Reply To List：回復列表。
- Emergency reroute：如果這個字段不為空，所有的電子郵件將被單獨發送到該地址（或地址列表）。
- Excluded Committers：防止郵件被郵件系統認為是垃圾郵件，郵件列表應該沒有擴展的賬戶名(如:@domain.com)，并且使用逗號分隔。
- Default Subject：自定義郵件通知的默認主題名稱。該選項能在郵件的主題字段中替換一些參數，這樣就可以在構建中包含指定的輸出信息。
- Maximum Attachment Size：郵件最大附件大小。
- Default Content：自定義郵件通知的默認內容主體。該選項能在郵件的內容中替換一些參數，這樣就可以在構建中包含指定的輸出信息。
- Default Pre-send Script：默認發送前執行的腳本。
- Enable Debug Mode：啟用插件的調試模式。
- nable Security：啟用時，會禁用發送腳本的能力，直接進入Jenkins實例。如果用戶試圖訪問Jenkins管理對象實例，將拋出一個安全異常。
- Content Token Reference：郵件中可以使用的變量，所有的變量都是可選的。
進入配置，點擊【構建后操作(Post-build Actions)】，找到【Extended E-mail Notification】，設置以下內容：
觸發器參數說明
- Failure：即時發送構建失敗的郵件。如果”Still Failing”觸發器已配置，而上一次構建的狀態是”Failure”，那么”Still Failing”觸發器將發送一封郵件來替代(它)。
- Unstable：即時發送構建不穩固的郵件。如果”Still Unstable”觸發器已配置，而上一次構建的狀態是”Unstable”，那么”Still Unstable”觸發器將發送一封郵件來替代(它)。
- Still Failing：如果兩次或兩次以上連續構建的狀態為”Failure”，發送該郵件。
- Success：如果構建的狀態為”Successful”發送郵件。如果”Fixed”已配置，而上次構建的狀態為“Failure”或“Unstable”，那么”Fixed”觸發器將發送一封郵件來替代(它)。
- Fixed：當構建狀態從“Failure”或“Unstable”變為”Successful”時發送郵件。
- Still Unstable：如果兩次或兩次以上連續構建的狀態為” Unstable “，發送該郵件。
- Before Build：當構建開始時發送郵件。
點擊【Build Now[立即構建]】，執行結束之后。如果執行成功，將不會發送郵件給收件人；如果執行失敗，將會發送一封郵件給收件人，郵件內容根據自己情況自定義。
5.2 郵件展示
6. 總結
本文主要描述了通過Git自動拉取代碼，然后Jenkins構建自動執行python腳本輸出測試報告，如果執行失敗，通過郵件自動將測試報告發送給收件人。 后期還有許多優化的地方，希望和大家一起來探討。
PS：
我們是行者AI，我們在“AI＋游戲”中不斷前行。
快來【公眾號 | xingzhe_ai】，和我們討論更多技術問題吧！
