colthreepv/node-chrome

docker-node-chrome 镜像文档

镜像概述

docker-node-chrome是一个集成Node.js和Chrome浏览器的Docker镜像，基于官方https://hub.docker.com/r/library/node/%E6%9E%84%E5%BB%BA%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E4%B8%93%E4%B8%BA%E5%89%8D%E7%AB%AF%E8%87%AA%E5%8A%A8%E5%8C%96%E6%B5%8B%E8%AF%95%E8%AE%BE%E8%AE%A1%EF%BC%8C%E7%89%B9%E5%88%AB%E9%80%82%E5%90%88%E5%9C%A8Gitlab%E7%AD%89CI/CD%E7%8E%AF%E5%A2%83%E4%B8%AD%E8%BF%90%E8%A1%8CKarma%E6%88%96Protractor%E6%B5%8B%E8%AF%95%E6%A1%86%E6%9E%B6%EF%BC%8C%E4%B8%94%E4%BC%9A%E5%9C%A8Node.js%E5%AE%98%E6%96%B9%E6%A0%87%E7%AD%BE%E6%9B%B4%E6%96%B0%E6%97%B6%E8%87%AA%E5%8A%A8%E5%90%8C%E6%AD%A5%E6%9B%B4%E6%96%B0%E3%80%82

核心功能与特性

• 自动更新机制：当官方Node.js镜像标签更新时，本镜像会自动重建，确保环境始终保持最新
• 多版本支持：提供多个Node.js版本标签，满足不同项目的运行环境需求
• 完整测试环境：内置Chrome浏览器，无需额外配置即可运行浏览器端测试
• CI环境优化：适配Gitlab等CI/CD平台，可直接集成到自动化测试流程中

适用场景

• 使用Karma进行前端单元测试
• 通过Protractor进行端到端(E2E)测试
• CI/CD流水线中的前端自动化测试环节
• 需要同时运行Node.js和Chrome浏览器的测试任务

标签信息

可用标签基于官方Node.js镜像标签，包括：

• 6
• 8
• 9
• 10
• 12
• 13
• latest（仅用于向后兼容，不建议使用）

建议：为确保环境稳定性，应使用具体版本标签（如12）而非latest。

使用方法

Docker Run 示例

在CI环境中运行前端测试：

bash
docker run -v $(pwd):/app -w /app colthreepv/node-chrome:12 npm test

参数说明：

• -v $(pwd):/app：将当前目录挂载到容器内的/app目录
• -w /app：设置工作目录为/app
• colthreepv/node-chrome:12：使用Node.js 12版本的镜像
• npm test：运行测试命令（根据项目实际测试命令调整）

Gitlab CI配置示例

在.gitlab-ci.yml中集成：

yaml
frontend-test:
  image: colthreepv/node-chrome:12
  script:
    - npm install
    - npm test
  stage: test

注意事项

• 确保测试脚本中Chrome浏览器配置正确（通常Protractor和Karma会自动检测环境）
• 如需自定义Chrome启动参数，可通过环境变量或配置文件进行设置
• 不同Node.js版本标签对应不同的Node.js和npm版本，需根据项目依赖选择合适标签