当selenium遇上docker (二）

这一篇是上一篇 当selenium遇上docker 的续集，重点介绍 selenium-docker 的使用和调试、设置桌面和安装中文字体。

查看控制台

standalone 的容器正常运行后，用浏览器打开 http://容器地址:4444 ，可以看到如下的界面：

点击红色箭头指向的链接，可以进入 session 管理界面：

这个界面下可以手动添加浏览器实例（session），不过我们主要用来监控自动运行的浏览器。

测试脚本开始运行后，session 管理界面会显示当前 chrome 的个数和对应的 capabilities，如图中红色箭头所指。下图中，一共有4个 chrome 线程同时运行。

内存问题

像上图一样在容器里开启多个浏览器 session 时，容易产生内存不足，使新开的浏览器崩溃，只能开启一个 session。有两种解决办法：

将宿主机的共享内存映射到容器内

$ docker run *-v /dev/shm:/dev/shm* [其他参数...] selenium/standalone-chrome

或者 指定 shm-size 为2GB

$ docker run --shm-size=2g [其他参数...] selenium/standalone-chrome

远程桌面调试

Windows 环境下可以使用 VNC viewer 连接 selenium debug 容器，而 Mac 则自带了远程桌面工具。

使用方法是：

• 在 Finder 的图标上点右键，右键菜单选择 Connect to Server…

• 填入 vnc://容器地址+端口，比如映射在本地5901端口，那么填入

• 默认密码是 secret

有读者可能会问，这个 secret 密码从哪里来的?

在 基础镜像 selenium/base 的Dockerfile ，其中有设置用户和添加密码的步骤：

#========================================
# Add normal user with passwordless sudo
#========================================
RUN useradd seluser \        # 添加默认用户 seluser
         --shell /bin/bash  \
         --create-home \
  && usermod -a -G sudo seluser \
  && echo 'ALL ALL = (ALL) NOPASSWD: ALL' >> /etc/sudoers \
  && echo 'seluser:secret' | chpasswd           # 为 seluser 设置密码
#===================================================
# Run the following commands as non-privileged user
#===================================================
USER seluser            # 切换到 seluser 用户

从上面的 Dockerfile 能看出，在所有的selenium镜像里，都使用了seluser这个默认用户，所以如果你要以这些镜像为基础制作自定义镜像，要记得seluser的身份

连上远程桌面后，将看到ubuntu的黑白logo

用你的测试代码打开远程页面后，将可以监控到虚拟浏览器的页面，方便调试。

设置虚拟桌面xvfb

web UI 自动化里，浏览器视口（View Port）是很重要的参数，它能影响到元素的定位、页面的滚动等许多行为，也直接影响了测试用例的成败。

虚拟桌面的大小，将间接的影响和限制浏览器视口的大小，在VNC浏览器里可以直观的看到虚拟桌面的分辨率。那么在selenium-debug镜像里，如何设置虚拟桌面xvfb的分辨率？

我们看 基础镜像 selenium/NodeBase 的Dockerfile ，里面这么设置环境变量：

ENV SCREEN_WIDTH 1360
ENV SCREEN_HEIGHT 1020
ENV SCREEN_DEPTH 24

所以我们只要启动自己的selenium容器时，设置好环境变量，就可以指定虚拟桌面的分辨率。

如何安装中文字体

在3.11版之前，chrome的镜像里是不包含中文字体的，浏览中文页面时，汉字将显示为一个一个的方框。为了解决这个问题，需要自己根据官方的镜像，定义自己的Dockerfile，下面举个栗子：

FROM selenium/standalone-chrome-debug
LABEL maintainer="LFhacks.com"
RUN sudo apt-get update -y && sudo apt-get -y install ttf-wqy-microhei

上面这个Dockerfile在官方镜像的基础上，安装了文泉驿细黑字体，使用这个镜像，可以正常显示中文。
从3.11版开始，chrome镜像里预装了中文字体，详见 基础镜像 selenium/NodeBase 的Dockerfile 有安装字体库的部分：

#================
# Font libraries
#================
# libfontconfig            ~1 MB
# libfreetype6             ~1 MB
# xfonts-cyrillic          ~2 MB
# xfonts-scalable          ~2 MB
# fonts-liberation         ~3 MB
# fonts-ipafont-gothic     ~13 MB
# fonts-wqy-zenhei         ~17 MB
# fonts-tlwg-loma-otf      ~300 KB
# ttf-ubuntu-font-family   ~5 MB
#   Ubuntu Font Family, sans-serif typeface hinted for clarity
# Removed packages:
# xfonts-100dpi            ~6 MB
# xfonts-75dpi             ~6 MB
# Regarding fonts-liberation see:
#  https://github.com/SeleniumHQ/docker-selenium/issues/383#issuecomment-278367069
# Layer size: small: 36.28 MB (with --no-install-recommends)
# Layer size: small: 36.28 MB
RUN apt -qqy update \
  && apt -qqy --no-install-recommends install \
    libfontconfig \
    libfreetype6 \
    xfonts-cyrillic \
    xfonts-scalable \
    fonts-liberation \
    fonts-ipafont-gothic \
    fonts-wqy-zenhei \
    fonts-tlwg-loma-otf \
    ttf-ubuntu-font-family \
  && rm -rf /var/lib/apt/lists/* \
  && apt -qyy clean