nhsbsa/google-chrome-ci

镜像概述

本Docker镜像专为需要Chrome浏览器和Chrome Driver环境的持续集成(CI)构建流程设计，提供预配置的浏览器运行环境，支持自动化测试、前端构建及UI测试等场景，确保CI/CD管道中浏览器相关任务的稳定执行。

核心功能与特性

• 版本兼容：预装Chrome浏览器及对应版本的Chrome Driver，确保浏览器与驱动程序版本匹配，避免兼容性问题
• 无头模式支持：默认配置无头(Headless)运行模式，适配无图形界面的CI环境
• 轻量级设计：基于精简基础镜像构建，减少镜像体积，提升CI流程启动速度
• 灵活配置：支持通过环境变量自定义Chrome启动参数，满足不同测试需求
• CI平台兼容：适配主流CI/CD系统（Jenkins、GitLab CI、GitHub Actions、Bitbucket Pipelines等）

使用场景与适用范围

• 前端自动化测试：支持Selenium WebDriver、Cypress、Playwright等自动化测试框架运行浏览器测试用例
• 前端构建流程：满足需要浏览器环境的构建任务（如生成页面截图、PDF导出、前端资源预渲染）
• UI兼容性测试：在CI流程中验证Web应用在Chrome浏览器环境下的界面渲染和交互功能
• 浏览器驱动依赖任务：执行需要Chrome Driver支持的Web自动化脚本或工具

使用方法与配置说明

基础使用（docker run）

启动容器并运行测试脚本示例：

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  [镜像名称] \
  sh -c "npm install && npm run test:e2e"

参数说明：

• -v $(pwd):/workspace：挂载当前目录到容器内工作区
• -w /workspace：设置工作目录
• [镜像名称]：替换为实际使用的Docker镜像名称

Docker Compose配置

配合测试环境的docker-compose.yml示例：

yaml
version: '3.8'
services:
  ci-test:
    image: [镜像名称]
    volumes:
      - ./:/app
    working_dir: /app
    environment:
      - CHROME_OPTS=--headless=new --no-sandbox --disable-dev-shm-usage
      - NODE_ENV=test
    command: ["npm", "run", "test:chrome"]

环境变量配置

CI/CD平台集成示例

GitLab CI配置（.gitlab-ci.yml）

yaml
stages:
  - test

chrome-e2e-test:
  stage: test
  image: [镜像名称]
  script:
    - npm ci
    - npm run build
    - npm run test:e2e:chrome
  variables:
    CHROME_OPTS: "--headless=new --window-size=1920,1080 --disable-extensions"
  tags:
    - docker

GitHub Actions配置（.github/workflows/chrome-test.yml）

yaml
name: Chrome E2E Tests
on: [pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    container:
      image: [镜像名称]
    steps:
      - uses: actions/checkout@v4
      - name: Install dependencies
        run: npm ci
      - name: Run E2E tests
        run: npm run test:e2e
        env:
          CHROME_OPTS: "--headless=new --no-sandbox --disable-dev-shm-usage"

注意事项

• 资源配置：建议CI环境为容器分配至少1GB内存，避免Chrome运行时内存不足
• 安全配置：--no-sandbox参数用于CI环境兼容性，生产环境使用时需评估安全需求
• 版本更新：定期更新镜像以获取Chrome浏览器的安全补丁和功能更新
• 网络配置：如需访问内部网络资源，需在CI环境中配置容器网络代理或DNS设置