Skip to content
This repo provides a sample set of automated tests for http://commentssprintone.azurewebsites.net application.
Java Dockerfile Shell
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs/pages Move pages pictures to docs folder Oct 30, 2017
src
.gitattributes
.gitignore
.rultor.yml
.travis.yml Disable cache while building the Docker image Jun 2, 2018
Dockerfile
LICENSE
README.md
docker-compose.yaml
jcat.sh
pom.xml

README.md

Comments automated tests

This repo provides a sample set of automated tests for http://commentssprintone.azurewebsites.net application.

Used tools

Running the tests

There are two supported browsers:

The tests are going to connect to a remote driver. It can be either a WebDriver run as a standalone process or Selenium Grid.

Also, please pay attention to configuration options and reporting.

Docker

Using docker's image

First of all, you need to run desired WebDriver (chromedriver or geckodriver) as a standalone application (instructions for ChromeDriver). If you have a working Selenium Grid, you can use it instead.

Then, run the following command with the correct value for SELENIUM_URL and BROWSER (see configuration options for the details):

docker run -it \
       --net=host \
       --env SELENIUM_URL=http://docker.for.mac.localhost:4444 \
       --env BROWSER=firefox \
       --volume $(pwd)/allure-results:/jcat/allure-results \
       extsoft/jcat:latest

❗️As the browser driver is run on the localhost, we have to give proper URL for SELENIUM_URL option. Docker provides several networking features for each OS which allow binding of host machine's hostname into a container. As the result, if you bind a container to host's network with --net=host and want access host's resources, correct hostname is

  • docker.for.win.localhost for Windows
  • docker.for.mac.localhost for OSX
  • localhost for Linux

❗️If Selenium Grid is run on your local environment using docker, you have to add --net=<Selenium Grid network> to the command above.

Using docker-compose

To be able to use this type of run, you need to have Docker engine release 1.13.0+. A simple way to check: docker-compose -v

First of all, you need to download a YAML file:

curl -o docker-compose.yaml https://raw.githubusercontent.com/extsoft/jcat/master/docker-compose.yaml

Then, run tests:

docker-compose up --abort-on-container-exit --timeout 120

❗️ This command runs the Selenium Grid with firefox and chrome browsers and executes the tests in parallel. If you need one of browsers, add jcat-on-firefox or jcat-on-chrome to the end of the command.

After the tests execution, the Allure results directories are created: allure-results-chrome and allure-results-firefox.

If you need Selenium Grid for development purposes, run docker-compose up -d firefox60 chrome66. As the Grid's port is mapped to a host machine, you view Grid's console on http://localhost:4444/grid/console.

Use docker-compose down to destroy the environment.

From source code

  1. Clone the repo
  2. Package tests with mvn clean package (a JAR file is located under target directory and is named like comments-at-x.x.x-jar-with-dependencies.jar , where x.x.x is a version property from pom.xml).
  3. Run tests with java -jar comments-at-x.x.x-jar-with-dependencies.jar

For instance,

java -Dbrowser=firefox -Dselenium-url=http://127.0.0.1:4444 \
     -jar comments-at-0.1.0-jar-with-dependencies.jar

runs tests on Firefox browser using geckodriver started on 4444 port.

Configuration options

Environment variable (Docker) System property (Java) Options Default value (Docker / Java) Description
BROWSER browser eitherchrome or firefox chrome / chrome A browser for testing
SELENIUM_URL selenium-url Any remote URL http://selenium-hub:4444/wd/hub / http://localhost:9515 An URL to remove driver or Selenium Grid

Reporting

The Allure files are stored to allure-results directory within the directory where you run the tests. Just run allure serve to see the Allure HTML report.

Application pages

Main screen

Actions panel on main screen

Comment screen

You can’t perform that action at this time.