trion/ng-cli-e2e

Docker Angular CLI端到端测试镜像

镜像概述和主要用途

该镜像用于在Docker容器内通过Protractor/Webdriver结合Google Chrome/chromium运行Angular端到端测试，特别适用于CI（持续集成）服务器环境，提供隔离、一致的测试环境。

核心功能和特性

• 在容器内执行Angular端到端测试，无需本地安装依赖
• 集成Protractor、Webdriver及Chrome/chromium浏览器
• 支持CI环境，确保测试环境一致性
• 可通过版本锁定机制避免ChromeDriver版本兼容性问题

使用场景和适用范围

• Angular项目的端到端测试自动化
• CI/CD流水线中的测试环节集成
• 需要隔离测试环境的开发或构建流程
• 避免本地环境差异导致的测试结果不一致问题

使用方法和配置说明

基本使用示例

通过以下命令在当前项目中运行端到端测试：

bash
docker run -u $(id -u) --rm -v "$PWD":/app trion/ng-cli-e2e ng e2e

参数说明：

• -u $(id -u)：指定当前用户ID，避免权限问题
• --rm：测试完成后自动删除容器
• -v "$PWD":/app：将当前目录挂载到容器内的/app目录（项目工作目录）
• ng e2e：执行Angular端到端测试命令

锁定ChromeDriver版本

Angular CLI使用webdriver-manager管理WebDriver，其默认每小时检查并更新版本，可能因Chrome浏览器版本不匹配导致构建失败（详见https://github.com/angular/webdriver-manager/blob/HEAD/docs/versions.md%EF%BC%89%E3%80%82%E8%A7%A3%E5%86%B3%E6%96%B9%E6%A1%88%E6%98%AF%E5%9C%A8%E6%B5%8B%E8%AF%95%E5%89%8D%E6%9B%B4%E6%96%B0%E8%87%B3%E5%9B%BA%E5%AE%9A%E7%89%88%E6%9C%AC%EF%BC%8C%E9%81%BF%E5%85%8D%E8%87%AA%E5%8A%A8%E5%8D%87%E7%BA%A7%E3%80%82

示例（使用镜像版本11.0.0锁定ChromeDriver版本）：

bash
docker run -u $(id -u) --rm -v "$PWD":/app trion/ng-cli-e2e:11.0.0 \
    ./node_modules/protractor/bin/webdriver-manager update --versions.chrome 86.0.4240.198 && \
    ng e2e --webdriver-update=false

说明：

• webdriver-manager update --versions.chrome 86.0.4240.198：将ChromeDriver更新至指定版本
• ng e2e --webdriver-update=false：执行测试时禁用自动更新WebDriver