spryker/chromedriver

Chromedriver Chromium

这是一个用于创建Webdriver镜像的Dockerfile，内置ChromeDriver和Chromium，开箱即可使用。

镜像概述和主要用途

该镜像提供了预配置的ChromeDriver和Chromium环境，旨在简化Webdriver测试流程。通过此镜像，用户无需手动安装和配置ChromeDriver与Chromium，可直接用于自动化测试场景。

核心功能和特性

• 开箱即用：内置ChromeDriver和Chromium，无需额外安装
• 版本可控：通过环境变量指定Chromium版本号，同步控制ChromeDriver版本
• 多场景支持：兼容Docker、Composer（PHP项目）和Travis CI等多种使用环境
• 自动化管理：Composer集成支持自动安装、版本检查和更新

使用场景和适用范围

• 本地开发环境中的Webdriver自动化测试
• PHP项目通过Composer管理的测试环境配置
• Travis CI等持续集成流程中的自动化测试环节

使用方法和配置说明

通用说明

spryker/chromedriver镜像已在Docker Hub公开，可通过以下方式使用：

• Docker
• Composer (PHP)
• Travis CI

Docker

该镜像默认在4444端口启动Chromedriver服务器，Chromedriver封装Webdriver以在Chromium环境中运行测试。

基础docker-compose配置：

yml
version: "3.7"
services:
  chromedriver:
    image: spryker/chromedriver
    init: true
    environment:
      - CHROMIUM_VERSION=726767  # 指定Chromium版本号
    volumes:
      - ./assets:/home/webdriver/assets:ro  # 挂载资产目录（只读）
    expose:
      - "4444"  # 暴露4444端口

通过CHROMIUM_REVISION环境变量可控制Chromium（及对应ChromeDriver）的版本。

Composer

安装步骤：

1. 执行安装命令：

shell
composer require --dev "spryker/docker-chromedriver"

2. 修改composer.json文件，添加自动安装脚本：

json
{
  "scripts": {
    "post-install-cmd": [
      "ChromedriverInstaller\\Installer::installChromedriver"
    ],
    "post-update-cmd": [
      "ChromedriverInstaller\\Installer::installChromedriver"
    ]
  }
}

默认安装最新的ChromeDriver和Chromium nightly构建版本。

版本固定：

在composer.json中指定具体版本号（需确保该版本同时包含ChromeDriver和Chromium归档文件）：

json
{
  "config": {
    "chromium-revision": 814168  # 替换为目标版本号
  }
}

Composer安装/更新时会检查版本变化，仅在版本不同时执行安装，以减少执行时间。

跳过安装：

设置环境变量可跳过安装过程：

shell
export COMPOSER_IGNORE_CHROMEDRIVER=1

Travis CI

配置步骤：

1. 指定缓存目录：

yml
cache:
  directories:
    - $HOME/chromium-ecosystem

2. 下载并解压安装器：

yml
before_install:
  # Chromedriver部分
  - 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/
  # 设置版本号（0表示安装最新nightly构建）
  - export CHROMEDRIVER_REVISION=814168

3. 运行安装器：

yml
  # 暴露${CHROMEDRIVER_BINARY}和${CHROMIUM_BINARY}环境变量
  - . $HOME/chromium-ecosystem/chromiumdriver-master/chromium-installer $CHROMEDRIVER_REVISION $HOME/chromium-ecosystem false

4. 添加Chromium依赖包：

yml
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

5. 启动Chromedriver：

yml
script:
- bash -c "${CHROMEDRIVER_BINARY} --port=4444 --whitelisted-ips= --url-base=/wd/hub --log-path=/tmp/chromedriver.log --log-level=DEBUG" > /dev/null &

依赖项

运行ChromeDriver和Chromium需预先安装以下依赖：

shell
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

包含软件

该镜像包含以下软件：

• ChromeDriver（最新版本）
• The Chromium Project（最新版本）

注意事项

由于依赖nightly构建版本，并非所有Chromium版本都可下载。如需查看可用版本号，请访问Google Chromium Snapshots归档，查找合适的快照版本号。