buzzwoo/node-chromium

buzzwoo/node-chromium 镜像文档

镜像概述

buzzwoo/node-chromium是一个基于node和node-alpine构建的Docker镜像，预安装了chromium浏览器。该镜像主要为Angular项目设计，适用于本地开发环境和GitLab CI持续集成流程。同时内置python，以支持从源代码重建node-sass依赖的二进制文件。

核心功能与特性

• 基础环境：基于官方node和node-alpine镜像，提供稳定的Node.js运行环境
• 浏览器支持：预装chromium，满足前端测试和构建对浏览器环境的需求
• 依赖构建支持：包含python，支持从源代码编译node-sass等依赖的二进制文件
• 多场景适配：同时支持本地开发环境搭建和CI/CD流程集成

使用场景

• Angular项目的本地开发环境快速部署
• GitLab CI/CD流水线中的前端自动化测试与构建
• 需要chromium运行环境的前端项目构建流程

使用方法

本地开发环境配置

Dockerfile 配置

dockerfile
FROM docker.xuanyuan.run/buzzwoo/node-chromium:10.16.3

# 设置工作目录
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.4'

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

GitLab CI 集成

在项目根目录创建.gitlab-ci.yml文件，配置CI流程：

yml
image: docker.xuanyuan.run/buzzwoo/node-chromium:10.16.3

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

版本信息

当前文档基于镜像版本：buzzwoo/node-chromium:10.16.3