bergil/docker-behat repository overview

⁠Environment for running Behat tests.

This image is based on Alpine Linux⁠ with PHP7 and could be used to test Docker and non-Docker websites.

This image includes (composer update is possible):

Behat⁠

Mink⁠

Mink extension⁠

Mink goutte driver⁠

Mink selenium2 driver⁠

Drupal extension⁠

Guzzle⁠

PHP Unit⁠

Faker⁠

PHPspec2-expect⁠

Behat cucumber json formatter⁠

Also, it uses official selenium/standalone-chrome⁠ image.

⁠Prerequirements

• Clone a repository.

git clone https://github.com/Bergil32/behat.git

• Put your custom contexts into "features/bootstrap/" folder if needed.

• Configure behat.yml for your custom contexts.

• Put your tests into "features/" folder.

• Configure volumes in docker-compose.behat.yml.

⁠Non-docker websites

• Set base URL in behat.yml for testing site.

E.x.

base_url: 'https://en.wikipedia.org'

• Run test.sh script to run tests.

sh test.sh

• To stop and remove containers use

docker-compose -f docker-compose.behat.yml down 

⁠Docker websites

• Configure base URL in behat.yml for testing site in following way.

base_url: '{https/http}://{web server service name}:{internal port}'

E.x.,

base_url: 'http://nginx:80'

• Additionally for Drupal 8 add the following line into your settings.php.

E.x.,

$settings['trusted_host_patterns'][] = '^nginx$';

It is needed to grant access to you site for GouteDriver/Selenium server through Nginx container.

Change Nginx to your web server service name if needed.

• In order to up testing environment

docker-compose -f docker-compose.yml -f docker-compose.behat.yml up -d

For additional information read about extending services and Compose files⁠.

• In order to run tests, after environment up commands and all site building command on other containers run the following command .

docker-compose -f docker-compose.yml -f docker-compose.behat.yml exec behat /srv/entrypoint.sh "{behat options}"

Notice that you must add at least one option to run tests.

⁠Composer update

⁠In order to update composer before running tests do the following

• Set COMPOSER_UPDATE variable to 1

COMPOSER_UPDATE: 1

• Mount composer.json on your host machine as /srv/composer.json.

- {some path}/composer.json:/srv/composer.json

⁠Using API methods of the Drupal extension for Behat.

• Mount folder with drupal on your host machine as /drupal.

E.x.,

- {some path}/drupal8:/drupal

• If you don't want to use API methods of the Drupal extension for Behat you must comment or delete following lines in behat.yml

api_driver: drupal
drush:
  root: /drupal
drupal:
  drupal_root: /drupal

⁠Artifacts

• Reports and text files with information about screenshots are saved in artifacts/ folder.

• Screenshots will be uploaded to https://wsend.net/⁠.

⁠For more information read entrypoint.sh, docker-compose.behat.yml and test.sh. Nearly each code and config line has comments.

⁠Additional thanks to Serge Skripchuk⁠ for his help.