armno/node-chromium

node-chromium

镜像概述和主要用途

node-chromium是一个基于node和node-alpine构建的Docker镜像，预安装了chromium浏览器。主要用于Angular项目的本地开发和GitLab CI持续集成流程。此外，镜像还包含python，以支持从源代码重建node-sass依赖的二进制文件。

核心功能和特性

• 基于官方node和node-alpine镜像构建，确保Node环境稳定性
• 预安装chromium/Google Chrome浏览器，支持前端测试和自动化
• 包含python，解决node-sass等依赖的二进制重建需求
• 支持Angular本地开发服务器（ng serve）和Karma单元测试（ng test），兼容常规和无头Chrome模式
• 非alpine版本支持CodeceptJS E2E测试与Puppeteer驱动

标签说明

node-alpine（轻量级Alpine版本）

• latest、11.6.0-alpine (https://github.com/armno/docker-node-chromium/blob/master/Dockerfile)%EF%BC%9AAlpine%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%EF%BC%8C%E5%AE%89%E8%A3%85Chromium 68
• 10.15.0-alpine (https://github.com/armno/docker-node-chromium/blob/node-10-alpine/Dockerfile)%EF%BC%9ANode 10版本的Alpine镜像

node（标准Node版本）

• 11.6.0 (https://github.com/armno/docker-node-chromium/blob/node/Dockerfile)%EF%BC%9A%E6%A0%87%E5%87%86Node%E9%95%9C%E5%83%8F%EF%BC%8C%E5%AE%89%E8%A3%85Google Chrome 71
• 10.16.0 (https://github.com/armno/docker-node-chromium/blob/node-10/Dockerfile)%EF%BC%9ANode 10.x版本，配置与11.6.0相同

提示：使用CodecepJS搭配Puppeteer驱动时建议选择11.6.0标签；其他场景推荐Alpine版本。Alpine镜像可正常运行本地开发服务器和Karma单元测试（常规和无头Chrome模式）。标准Node镜像主要解决Alpine镜像中Chromium 68与Puppeteer不兼容导致的E2E测试启动失败问题。

使用场景和适用范围

• Angular项目本地开发环境搭建
• GitLab CI/CD流程中的前端自动化测试（单元测试、E2E测试）
• 需要Node环境和Chrome/Chromium浏览器的前端构建任务
• 依赖node-sass等需从源码编译二进制的项目

使用方法和配置说明

本地开发

Dockerfile配置

dockerfile
FROM armno/node-chromium:11.6.0

# 设置工作目录
RUN mkdir -p /app
WORKDIR /app

# 将node_modules添加到PATH
ENV PATH /app/node_modules/.bin:$PATH

# 安装并缓存依赖
COPY package*.json /app/
RUN npm install

# 复制应用代码
COPY . /app

docker-compose.yml配置

yml
version: '3'

services:
  app:
    container_name: app
    build:
      context: .
    volumes:
      - '.:/app'           # 挂载当前目录到容器内/app
      - '/app/node_modules' # 避免覆盖容器内node_modules
    command: npm start      # 启动开发服务器
    ports:
      - '4200:4200'         # 映射Angular默认开发端口

CI配置（GitLab CI）

在项目根目录创建.gitlab-ci.yml：

yml
image: armno/node-chromium:11.6.0

unit_test:
  stage: test
  before_script:
    - npm install  # 安装项目依赖
  script: npm run test:ci  # 执行CI环境的单元测试命令

许可证

Public Domain