
最近在處理系統交接並且升級相關的系統發現了Selenium Grid出了第四版現正Beta時讓我躍躍欲試，
以前Selenium Grid 3.x版本的時候UI說真的不怎麼樣，做了Selenium Grid 4的時候樣式跟整個畫面的設計全改了。
整個畫面看起來舒服了不少，但相關的東西也改了不少讓我一開始做測試的時候跌了不少次

![selenium 4](selenium-grid-4/selenium-4.png)

## Selenium 架構變更

在[Selenium Component](https://www.selenium.dev/documentation/en/grid/grid_4/components_of_a_grid/)文件中就給了一張架構圖，
跟過去只有HUB跟Node的架構有所差距，在整個部署與調整上擁有了更多彈性。你可以將HUB分散在多台的Server做部署，
或是你可以使用經典模式的HUB將這些分散的服務集中在HUB中。

新增的component有以下幾個，或者是你可以使用Hub來取代這些新的component
- Router
- Distributor
- Session Map
- New Session Queuer
- Event Bus

## Selenium Node Session的改變

在以前Selenium 3.x的時候，我們可以去使用MAX_SESSIONS指定該instance的Session數量，所以在自動化測試的機器叢集中我都直接給10個讓每一個node都具有10個session，
但這一次改版後即便你加了`SE_NODE_MAX_SESSIONS`的數量，但你的CPU數量不足時也無法產生更多的Session，新版本Node的Session數量取決於你設定的最大Session與CPU最小的那一個
在官方的github中[這一段說明](https://github.com/SeleniumHQ/docker-selenium#increasing-session-concurrency-per-container)沒仔細看還真的很容易就給他忽略過去

## Dynamic Grid的使用

在新版本的Selenium Grid支援了Dynamic Grid，可以在每一次測試的時候才產生相對應的目標瀏覽器，而不用預先建置好這些瀏覽器的session

在公司的Selenium的測試從集中，都採用docker的方式啟動這個對我來說可以減少在infrastructure的設定與管理

以下分享我的設定，在config.toml的部分讓docker-node可以使用host的docker花了一下功夫

```coffeescript
# config.toml

[docker]
# Configs have a mapping between the Docker image to use and the capabilities that need to be matched to
# start a container with the given image.
configs = [
    "selenium/standalone-firefox:4.0.0-beta-3-prerelease-20210402", "{\"browserName\": \"firefox\"}",
    "selenium/standalone-chrome:4.0.0-beta-3-prerelease-20210402", "{\"browserName\": \"chrome\"}",
    "selenium/standalone-opera:4.0.0-beta-3-prerelease-20210402", "{\"browserName\": \"operablink\"}",
    "selenium/standalone-edge:4.0.0-beta-3-prerelease-20210402", "{\"browserName\": \"msedge\"}"
    ]

# URL for connecting to the docker daemon
# host.docker.internal works for macOS and Windows.
# Linux could use --net=host in the `docker run` instruction or 172.17.0.1 in the URI below.
# To have Docker listening through tcp on macOS, install socat and run the following command
# socat -4 TCP-LISTEN:2375,fork UNIX-CONNECT:/var/run/docker.sock
url = "unix:///var/run/docker.sock"
# Docker imagee used for video recording
video-image = "selenium/video:ffmpeg-4.3.1-20210402"

# Uncomment the following section if you are running the node on a separate VM
# Fill out the placeholders with appropriate values
#[server]
#host = <ip-from-node-machine>
#port = <port-from-node-machine>

[selenium official github](https://github.com/SeleniumHQ/docker-selenium#dynamic-grid-)
```

```yml
version: "3"
services:
  node-docker:
    image: selenium/node-docker:4.0.0-beta-3-prerelease-20210402
    user: root
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - ./config.toml:/opt/bin/config.toml
    depends_on:
      - hub
    environment:
      - SE_EVENT_BUS_HOST=hub
      - SE_EVENT_BUS_PUBLISH_PORT=4442
      - SE_EVENT_BUS_SUBSCRIBE_PORT=4443
      - SE_NODE_OVERRIDE_MAX_SESSIONS=true
      - SE_NODE_MAX_SESSIONS=10
  hub:
    image: selenium/hub:4.0.0-beta-3-prerelease-20210402
    user: root
    ports:
      - "4442:4442"
      - "4443:4443"
      - "4444:4444"
    logging:
      options:
        max-size: 100m
        max-file: "1"
    restart: always
```

## 參考連結

[Selenium document](https://www.selenium.dev/documentation/en/grid/grid_4/components_of_a_grid/)

[Max sessions](https://github.com/SeleniumHQ/docker-selenium#increasing-session-concurrency-per-container)


最近在處理系統交接並且升級相關的系統發現了Selenium Grid出了第四版現正Beta時讓我躍躍欲試， 以前Selenium Grid 3.x版本的時候UI說真的不怎麼樣，做了Selenium Grid 4的時候樣式跟整個畫面的設計全改了。 整個畫面看起來舒服了不少，但相關的東西也改了不少讓我一開始做測試的時候跌了不少次

Selenium Grid 4 體驗


## 寫在前面

一般我們上線流程都含有QA的測試階段，QA的測試與RD的開發有著很大的區別...

QA測試當然不是只測試RD這次上線的範圍而已，而是把過去上線的功能都要在驗過一遍才能算是`經過QA測試`的版本，但是隨著時間的積累線上的系統越來越多
有時候QA無法透過手動的方式完成所有驗證，這時候都會導入自動畫測試selenium來協助QA做完系統的驗證，在目前我服務的公司把CD與自動化測試的部分做了整合，
當QAT部署完成後就會驅動QA的自動化驗證，但是當自動化驗證的Job越來越多一台機器已經很難在3-5分鐘內完成自動化測試怎麼辦？

在網路上很多採用Selenium Grid的人，大多都是有一個需求是`多瀏覽器測試`，目前我們只針對chrome做測試但他也能在多台機器上為我們完成許多
自動化測試的需求，我們則是因為許多小而美的自動化測試需要被完成

> 在做自動化測試的時候，我的建議是每一次只驗證一項功能是否如我們預期的運作，然後把每個工作都拆分成小的Task來完成
>
> 好處是可以透過Selenium Grid同時執行驗證減少時間成本，另外也可以避免某一個功能驗證失效，而導致後面的功能無法驗證

## 架構說明

Jenkins我是採用Master跟Agent的方式建制的，Selenium 也適用Hub跟Node的方式建置的

![jenkins 與 Selenium Grid架構圖](jenkins-selenium-grid/jenkins-selenium.png)

Jenkins與Selenium均採用docker並結合docker compose起動，這邊是我撰寫的`docker-compose.yml`

> 在Selenium Node的部分是採用linux的版本，主要原因是雲端服務的Windows機器價格比較高，所以在部署服務上以linux為主

```yaml
version: '3.7'
services:
  master:
    image: jenkins/jenkins:2.254
    logging:
      options:
        max-size: 100m
        max-file: "1"
    restart: always
    user: root
    networks:
      - net
    ports:
      - "80:8080"
      - "50000:50000"
    volumes:
      - jenkins:/var/jenkins_home
    environment:
      JAVA_OPTS: -Duser.timezone=Asia/Taipei
      JAVA_TOOL_OPTIONS: -Dfile.encoding=UTF-8

  test:
    image: docker.boyu66.cc/common/selenium:4.2
    user: root
    logging:
      options:
        max-size: 100m
        max-file: "1"
    networks:
      - net
    depends_on:
      - master
    restart: always
    volumes:
      - test:/home/root
    environment:
      JAVA_OPTS: -Duser.timezone=Asia/Taipei
    command: -url http://jenkins.boyu66.cc -workDir /home/root/agent {secretKey} TestAgent

  hub:
    image: selenium/hub:3.141.59-20200409
    user: root
    ports:
      - "4444:4444"
    logging:
      options:
        max-size: 100m
        max-file: "1"
    networks:
      - net
    depends_on:
      - master
    restart: always

  chrome:
    image: selenium/node-chrome:3.141.59-20200409
    user: root
    networks:
      - net
    volumes:
      - /dev/shm:/dev/shm
    depends_on:
      - hub
    environment:
      NODE_MAX_INSTANCES: 10
      NODE_APPLICATION_NAME: chrome
      NODE_MAX_SESSION: 10
      JAVA_OPTS: -Xmx512m


networks:
  net:
    driver: bridge

volumes:
  jenkins:
  test:
```

## 建立Jenkins test agent的docker image

在test agent 的dockerfile我選用了ubuntu作為base image，時區的部分設定到了台北並安裝openjdk等等的套件

```dockerfile
FROM ubuntu:18.04

ARG VERSION=4.2
ENV TZ='Asia/Taipei' \
    HOME=/home/root
RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone

RUN apt-get update
RUN apt-get install -y --no-install-recommends software-properties-common \
      openjdk-8-jre curl git \
      && apt-get clean

RUN curl --create-dirs -fsSLo /usr/share/jenkins/slave.jar https://repo.jenkins-ci.org/public/org/jenkins-ci/main/remoting/${VERSION}/remoting-${VERSION}.jar \
      && chmod 755 /usr/share/jenkins \
      && chmod 644 /usr/share/jenkins/slave.jar

WORKDIR /home/root
USER root

## Jenkins jnlp slave ##
COPY jenkins-slave.sh jenkins-slave.sh


ENTRYPOINT ["bash", "/home/root/jenkins-slave.sh"]
```

最後將Jenkins的Job指定到Test Agent上執行，在Selenium的部分把webdriver的設定改道遠端的位置上就可以享受Selenium Grid了！

## 參考資料

[Selenium Grid 中文文黨](https://wizardforcel.gitbooks.io/selenium-doc/content/official-site/selenium-grid.html)


QA測試當然不是只測試RD這次上線的範圍而已，而是把過去上線的功能都要在驗過一遍才能算是經過QA測試的版本，但是隨著時間的積累線上的系統越來越多 有時候QA無法透過手動的方式完成所有驗證，這時候都會導入自動畫測試selenium來協助QA做完系統的驗證，在目前我服務的公司把CD與自動化測試的部分做了整合， 當QAT部署完成後就會驅動QA的自動化驗證，但是當自動化驗證的Job越來越多一台機器已經很難在3-5分鐘內完成自動化測試怎麼辦？

Selenium Grid 4 體驗

透過Jenkins啟動Selenium Grid執行自動化測試