This is a Dockerfile to create a Webdriver image with ChromeDriver and Chromium out-of-box.
The spryker/chromedriver
image is public and available on Docker Hub. You can use this
repository to run and install Chromedriver with appropriate version of Chromium within:
The spryker/chromedriver
is available on Docker Hub. starts a Chromedriver server on port 4444
by default. In its turn, Chromedriver wraps Webdriver to run tests within Chromium
ecosystem.
The very basic docker-compose configuration that is sufficient to use Chromium and Chromedriver within your ecosystem is next:
version: "3.7"
services:
chromedriver:
image: spryker/chromedriver
init: true
environment:
- CHROMIUM_VERSION=726767
volumes:
- ./assets:/home/webdriver/assets:ro
expose:
- "4444"
You can control the revision of Chromium (and Chromedriver as well) with just putting
CHROMIUM_REVISION
environment variable into docker-compose template (as mentioned above).
To install Chromedriver with Chromium onboard, you just need to run
composer require --dev "spryker/docker-chromedriver"
and modify composer.json
file to make all necessary installation actions:
{
"scripts": {
"post-install-cmd": [
"ChromedriverInstaller\\Installer::installChromedriver"
],
"post-update-cmd": [
"ChromedriverInstaller\\Installer::installChromedriver"
]
}
}
This will lead to install of the latest
nightly build of Chromedriver and Chromium.
To freeze version of Chromedriver you can take on any revision number and mention it
within composer.json
configuration (just ensure your revision contains both Chromedriver and Chromium archives):
{
"config": {
"chromium-revision": 814168
}
}
Next time you will run Composer install/update, script will check whether the revision has changed and/or differs from latest/fixed one. If so, it will install the actual version of Chromedriver. Nothing will happen in else case. This is to reduce Composer worktime.
To ignore Chromedriver installation process just set the appropriate variable berfore running Composer:
export COMPOSER_IGNORE_CHROMEDRIVER=1
This will force skipping installation procedure during Composer run.
To use this package within Travis image you just need to use chromium-installer
to prepare Chromium and Chromedriver for run.
First of all, you need to specify cache directory:
cache:
directories:
- $HOME/chromium-ecosystem
Then download and unzip installer:
before_install:
# Chromedriver section
- curl -L "https://github.com/spryker/docker-chromedriver/archive/master.zip" -o $HOME/chromium-ecosystem/chromiumdriver.zip
- unzip -o $HOME/chromium-ecosystem/chromiumdriver.zip -d $HOME/chromium-ecosystem/
# Here you can leave 0 for installing latest nightly build
- export CHROMEDRIVER_REVISION=814168
And finally run installer:
# Exposes ${CHROMEDRIVER_BINARY} and ${CHROMIUM_BINARY}
- . $HOME/chromium-ecosystem/chromiumdriver-master/chromium-installer $CHROMEDRIVER_REVISION $HOME/chromium-ecosystem false
And finally, ensure you have added all dependencies, needed to run Chromium
:
addons:
apt:
update: true
packages:
- unzip
- gnupg
- libnss3-dev
- ca-certificates
- fonts-liberation
- libappindicator3-1
- libasound2
- libatk-bridge2.0-0
- libatk1.0-0
- libc6
- libcairo2
- libcups2
- libdbus-1-3
- libexpat1
- libfontconfig1
- libgbm1
- libgcc1
- libglib2.0-0
- libgtk-3-0
- libnspr4
- libnss3
- libpango-1.0-0
- libpangocairo-1.0-0
- libstdc++6
- libx11-6
- libx11-xcb1
- libxcb1
- libxcomposite1
- libxcursor1
- libxdamage1
- libxext6
- libxfixes3
- libxi6
- libxrandr2
- libxrender1
- libxss1
- libxtst6
- lsb-release
- wget
- xdg-utils
That's it! Now you can just run Chromedriver
and pass right Chromium
executable into Webdriver config:
script:
- bash -c "${CHROMEDRIVER_BINARY} --port=4444 --whitelisted-ips= --url-base=/wd/hub --log-path=/tmp/chromedriver.log --log-level=DEBUG" > /dev/null &
To run Chromedriver with Chromium you need to install this list of dependencies beforehand:
apt-get update \
&& apt-get install gnupg \
libnss3-dev \
ca-certificates \
fonts-liberation \
libappindicator3-1 \
libasound2 \
libatk-bridge2.0-0 \
libatk1.0-0 \
libc6 \
libcairo2 \
libcups2 \
libdbus-1-3 \
libexpat1 \
libfontconfig1 \
libgbm1 \
libgcc1 \
libglib2.0-0 \
libgtk-3-0 \
libnspr4 \
libnss3 \
libpango-1.0-0 \
libpangocairo-1.0-0 \
libstdc++6 \
libx11-6 \
libx11-xcb1 \
libxcb1 \
libxcomposite1 \
libxcursor1 \
libxdamage1 \
libxext6 \
libxfixes3 \
libxi6 \
libxrandr2 \
libxrender1 \
libxss1 \
libxtst6 \
lsb-release \
wget \
xdg-utils
The following software is included in this image:
- ChromeDriver (latest)
- The Chromium Project (latest)
Since this package relies on nightly builds, not all versions of Chromium are available to download. To check the available revisions, please visit Google Chromium Snapshots archive and find appropriate snapshot revision.