準備工作
本教學由安裝Robot Framework套件開始
請預先裝好Jenkins環境 > 安裝Jenkins
安裝Robot Framework套件
- 至Jenkins工作站 > Manage Jenkins > Manage Plugins
- 點選 Available > 搜尋 Robot Framework
- 安裝完成後, 回到 Manage Jenkins > Configure System
找到Robot Framework選項,
勾選 ☑Display “Robot Results” column in the job list view
這個選項可以讓我們在工作主頁面看到Robot Framework的建置結果
在Jenkins建立Robot Frameowrk任務
建立新任務
打開Jenkins主頁面, 點選 New Item > New Project
輸入工作名稱
test_robot
設定任務內容
每個任務要做的事情和步驟都不同,
主要的流程及步驟是都在個別的任務頁面裡去做設定
而現在的主要目標 就是把先前寫好的Robot Framework測項整合進Jenkins
也能設定在固定的時間或有更新時自動觸發建置
- 設定任務工作區域, 用來存放每次執行的結果
- 進入 test_robot 設定頁面, 找到 Build 區塊
點選 Add build step > 選擇 Execute Windows natch command
(此步驟主要依據運行測試的作業系統來做選擇,
如果運行測試的機器是linux系統, 那個就選擇Execute shell)
- 每一行視為一個獨立的步驟, 我們將內容拆解為三步驟
- 從腳本複製到 Jenkins 的工作區域
- 切換資料夾到 Jenkins 的工作區域 (這時測試腳本已經在裡面了)
- 使用 robot command 運行測試
(–name參數用來指定測試報告名稱, –outputdir 則用來指定報告書出路徑)
跑完測試腳本後, 還要讓 Jenkins 替我們發布 Robot Framework 的測試報告
在發布測試報告之前, 必須先封存測試後的資料
Jenkins才知道要去哪邊存取這些執行結果
-
找到 Post-build Actions區塊
點選 Add post-build action > 選擇 Archive the artifacts
在 File to archive 中輸入 :report\*.html, report\*.xml
- 接下來在 Post-build Actions區塊
點選 Add post-build action > 選擇 Publish Robot Framework test results
- 在 Directory of Robot output 中輸入 :
要publish的資料就在這個路徑report\下方的 Thresholds for build results 則是一種判定測試總結果為PASS為FAIL的機制
如果設定 80, 那個通過的測試比例若高於或等於 80%, 整體測試結果就是PASS
反之即為Fail
查看建置結果
- 都設定好之後, 回到任務頁面運行
- 查看consoole log
- 回到任務主頁面, Robot Framework的整體報表出現了
畫面右方的趨勢圖可以看到最近幾次建置的結果
而中央的表格則是告知這次建置有幾個PASS幾個FAIL
- 點擊 Open report.html 查看測試結果
- 點擊 Open log.html 查看測試結果
其他
無法顯示Robot Framework報告
如果點擊Robot Framework的報告出現以下畫面時
必須對Jenkins做額外設定, 打開Jenkins主頁面, 點選 Manage Jenkins > 找到Script Console
輸入如下內容, 按下 Run
System.setProperty("hudson.model.DirectoryBrowserSupport.CSP", "")
無法顯示Capture Screen Shot的圖片
如果無法顯示建置結果中的圖片, 表示可能忘記將圖片檔案加入封存
請回到任務設定頁面, 加入 png的設定
