背景

目标：使用 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 参数可以解决。问题参考：

https://stackoverflow.com/questions/43099116/error-the-input-device-is-not-a-tty

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，方便处理环境问题。

到此处基本大功告成。此项目还有很多不足地方，欢迎大家讨论。

demo 相关完整例子：
https://github.com/Danielyan86/Python-Study/tree/master/DockerDemo/automation_test/unittest_demo