miqsel

Miq Selenium Server

Simple command line application to spin selenium docker container and provide vnc access.

Prerequisite:

1. Docker:

   For setting docker environment follow below steps:

   • Fedora

     • Set Repository:

     sudo dnf -y install dnf-plugins-core
     sudo dnf config-manager --add-repo https://download.docker.com/linux/fedora/docker-ce.repo
     

     • Install below packages:

     sudo dnf -y install docker-ce
     sudo systemctl start docker
     sudo systemctl enable docker
     

     • Run docker with non-root User:

     sudo groupadd docker
     sudo usermod -aG docker <non-root-user>
     

   • Ubuntu and others

2. TigerVNC Viewer:

   • Fedora:

     sudo dnf install tigervnc
     

   • TigerVNC link for other Distro's

Installation:

pip install miqsel --user

or

 pip install git+https://github.com/digitronik/miqsel#egg=miqsel --user

Usage:

❯❯❯ miqsel --help

Usage: miqsel [OPTIONS] COMMAND [ARGS]...

  Miq Selenium Server

Options:
  --version  Show the version and exit.
  --help     Show this message and exit.

Commands:
  appliance  Appliance
  browser    Set Browser
  config     Configure Miq Selenium Server
  executor   Selenium executor URL
  start      Start Selenium Server
  status     Status of Selenium Server
  stop       Stop Selenium Server
  viewer     VNC viewer
  vnc        VNC URL

• Configuration: If the project directory not set then miqsel need to run from integration_tests project directory. It will help to manage env.local.yaml.

  ❯❯❯ miqsel config
  Miq project working dir: /home/.../integration_tests
  

• Status: Check status of selenium container (running/ stopped).

  ❯❯❯ miqsel status
  stopped
  

• Start/Stop: The start will set command executor in env.local.yaml and provide vnc access.

  ❯❯❯ miqsel start
  Selenium Server started
  
  TigerVNC Viewer 64-bit v1.9.0
  
  ❯❯❯ miqsel stop
  
  Sun Apr 28 12:29:02 2019
   CConn:       End of stream
  Selenium Server stopped
  

• Appliance: Check current appliance or set new.

  ❯❯❯ miqsel appliance
  
  ❯❯❯ miqsel appliance -s 192.168.1.1
  Appliance set to 192.168.1.1
  ❯❯❯ miqsel appliance
  192.168.1.1
  

• Browser: Check current browser or set other.

  ❯❯❯ miqsel browser
  chrome
  ❯❯❯ miqsel browser --firefox
  Browser set to firefox
  ❯❯❯ miqsel browser
  firefox
  

• Viewer: Take vnc access of selenium server. At the start of selenium server, vnc viewer will be invoked automatically. If the status is running and the viewer is close then viewer command will help to re-open vnc session.

  ❯❯❯ miqsel status
  running
  ❯❯❯ miqsel viewer
  TigerVNC Viewer 64-bit v1.9.0
  

• Executor: Get command executor url

  ❯❯❯ miqsel executor
  http://172.17.0.2:4444/wd/hub
  

• VNC: Get vnc session url

  ❯❯❯ miqsel vnc
  172.17.0.2:5999