背景
目標:使用docker做UI自動化測試並在Jenkins運行
調試環境:MocOS
運行環境:Linux ubuntu + docker
涉及工具:docker,selenium,unittest, jenkins
基本思路
找一個適合做自動化的docker鏡像,使用selenium-grid 遠程執行selenium。鏡像採用 elgalu/selenium,已經集成了UI,chrome/firefox 等瀏覽器,包括webdriver驅動,十分方便。
鏡像倉庫地址:
https://github.com/elgalu/docker-selenium
接下來開工:
1. 在elgalu/selenium基礎上簡單編譯
爲了方便,腳本代碼運行也設置在鏡像裏面。因此定製了我們自己的鏡像文件:
FROM elgalu/selenium
RUN sudo apt-get update -y \
&& sudo pip install selenium \
&& mkdir /home/seluser/automation/myScript
ADD . /home/seluser/automation/myScript
WORKDIR /home/seluser/automation/myScript #定義工作目錄
2. 用Python+selenium編寫測試用例
if REMOTE: # 定義一個開關變量方便本地和遠程調試切換
selenium_grid_url = "http://guest.docker:24444/wd/hub"
capabilities = webdriver.DesiredCapabilities.CHROME.copy()
d = webdriver.Remote(command_executor=selenium_grid_url, desired_capabilities=capabilities) #通過selenium啓動docker裏面chrome
else:
d = webdriver.Chrome() #通過selenium啓動本地chrome
##具體的UI測試代碼
此處是啓動selenium或者或者selenium -grid 部分主要代碼,不能直接運行。如果需要調用遠程的selenium_grid需要URL加端口號的形勢http://guest.docker:24444/wd/hub,guest.docker是docker內網分配的IP,因爲在docker裏面的host文件沒有發現容器名和IP的映射,因此從docker裏面hosts文件選用guest.docker這個名字,等發現更好解決方案後再更新。
3. 執行和調試
本地調試不再多說,主要說一下怎麼在docker調試和運行。先啓動容器:
執行命令 :
docker* run --rm -p 5904:25900 -p 4444:24444 -v "$(pwd)":/home/seluser/automation/myScript --name automation-container automation-test:latest
啓動成功之後可以通過vnc工具查看容器的UI界面
簡單說明一下參數,5904是VNC需要用到的端口,可以通過本地VNC(127.0.0.1:5904)工具查看case運行效果。4444是selenium grid的映射端口。-v是把本地磁盤掛載到容器,方便代碼調試, 因爲採用$(pwd),表示當前路徑,所以執行docker啓動命令時候應該在自動化腳本所在位置。
現在本地調試case,注意這個時候selenium_grid_url值應該是http://localhost:4444/wd/hub
最後在容器裏面執行case,可以通過docker exec名執行, 比如docker exec -it container_name python /home/seluser/automation/myScript/example.py 確認沒有沒有問題後可以上Jenkins測試
需要注意的是如果case運行失敗selenium grid是不會自動退出的,此處藉助Python unit test的teardown方法結束selenium進程,比如:
def tearDown(self):
print("start to teardown")
time.sleep(10)
self.d.close()
self.d.quit()
運行腳本,可以再VNC看到運行效果:
4. 在Jenkins 運行
跟本地容器執行步驟一直,同樣的可以通過VNC監測執行過程。此處啓動容器和關閉容器單獨做成了兩個job,方便處理環境問題。
Jenkins上面執行docker exec -it時候碰到一個"The input device is not a TTY"錯誤。減少一個T參數可以解決。
jenkins 並行運行多個容器
因爲我們是通過容器化的方式啓動的UI測試環境,同一個宿主機是可以啓動多個容器的。假設我們的UI測試用例比較多的時候,我們可以同時運行多個容器來減少UI case的運行時間,配置方式比jenkins的分佈式運行又更方便,怎麼實現呢?啓動多個容器我們只需要改變容器名字和映射的端口號即可,比如把前面啓動容器命令簡單更新一下
docker run --rm -p 5906:25900 -p 4466:24444 -v "$(pwd)":/home/seluser/automation/myScript --name automation-container-robot -d automation-test-robot
此處我們只更新了端口(5906,4466)和容器名字,就能啓動多個UI環境並行運行case,是不是很爽哦?
執行完之後需要強制關閉容器,防止異常退出情況。啓動容器和關閉容器單獨做成了兩個job,方便處理環境問題。
到此處基本大功告成。
結語
最後跟大家推薦一個測試學習羣:747981058,裏面大牛已經爲我們整理好了許多的學習資料,有自動化,接口,性能等等的學習資料!
人生是一個逆水行舟的過程,不進則退,咱們一起加油吧!