lahautesociete/nodejs-ci

Node.js CI 镜像文档

镜像概述和主要用途

Node.js CI镜像是一个专为持续集成(CI)流程设计的Node.js环境镜像，基于https://github.com/bitnami/bitnami-docker-node%E6%9E%84%E5%BB%BA%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E9%9B%86%E6%88%90%E4%BA%86CI%E8%BF%87%E7%A8%8B%E4%B8%AD%E5%B8%B8%E7%94%A8%E7%9A%84%E4%BE%9D%E8%B5%96%E7%AE%A1%E7%90%86%E5%B7%A5%E5%85%B7%E3%80%81%E6%9E%84%E5%BB%BA%E5%B7%A5%E5%85%B7%E5%8F%8A%E5%9F%BA%E7%A1%80%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%97%A8%E5%9C%A8%E7%AE%80%E5%8C%96Node.js%E9%A1%B9%E7%9B%AE%E5%9C%A8CI%E7%8E%AF%E5%A2%83%E4%B8%AD%E7%9A%84%E6%9E%84%E5%BB%BA%E3%80%81%E6%B5%8B%E8%AF%95%E5%92%8C%E9%83%A8%E7%BD%B2%E6%B5%81%E7%A8%8B%EF%BC%8C%E6%8F%90%E4%BE%9B%E5%BC%80%E7%AE%B1%E5%8D%B3%E7%94%A8%E7%9A%84CI%E7%8E%AF%E5%A2%83%E6%94%AF%E6%8C%81%E3%80%82

核心功能和特性

基础环境

• Node.js版本：通过标签8提供Node.js 8.11.3环境
• 基础镜像：基于bitnami/bitnami-docker-node，继承其稳定的Node.js运行环境和安全特性

集成依赖工具

• 包管理工具：npm（含cross-env、cli-login）、Yarn
• 前端构建工具：Bower（前端包管理）、Grunt（任务运行器）、Gulp（流构建系统）
• 基础命令行工具：unzip（解压缩）、wget（文件下载）、git（版本控制）、rsync（文件同步）、sshpass（SSH密码认证）

使用场景和适用范围

适用场景

• Node.js项目的持续集成(CI)构建流程（如代码拉取、依赖安装、代码构建、单元测试）
• Node.js应用的自动化测试环境配置
• 需要在CI环境中执行前端构建工具（Grunt/Gulp）或包管理工具（Yarn/Bower）的场景

适用范围

• 基于Node.js 8.11.3开发的项目
• 使用Git进行版本控制的Node.js项目
• 需要通过SSH、rsync等工具进行CI产物同步或部署的场景

使用方法和配置说明

镜像获取

从Docker仓库拉取镜像（假设仓库地址为<registry>/nodejs-ci:8，实际使用时替换为具体仓库地址）：

bash
docker pull <registry>/nodejs-ci:8

基本运行示例

在本地CI环境中启动容器，执行Node.js项目构建命令：

bash
docker run --rm -v $(pwd):/app -w /app <registry>/nodejs-ci:8 sh -c "npm install && npm run build"

• -v $(pwd):/app：将当前目录挂载到容器内/app目录（项目代码目录）
• -w /app：设置工作目录为/app
• sh -c "npm install && npm run build"：执行依赖安装和构建命令

CI配置示例（以GitLab CI为例）

在.gitlab-ci.yml中配置CI作业：

yaml
stages:
  - build

nodejs-ci-build:
  stage: build
  image: <registry>/nodejs-ci:8
  script:
    - git clone <repository-url> /app  # 拉取项目代码（或使用CI内置代码目录）
    - cd /app
    - yarn install  # 使用Yarn安装依赖
    - gulp build    # 使用Gulp执行构建
    - rsync -avz /app/dist/ user@server:/var/www/app/  # 同步构建产物到目标服务器（需配置sshpass）

环境变量配置

该镜像继承自bitnami/bitnami-docker-node，支持其提供的环境变量配置（如Node.js相关参数），详细可参考https://github.com/bitnami/bitnami-docker-node%E3%80%82

注意事项

• 镜像基于Node.js 8.11.3，仅支持对应版本的Node.js项目，高版本Node.js项目可能存在兼容性问题
• 使用sshpass等工具时，需确保CI环境中已正确配置相关认证信息（如SSH密码、服务器地址）
• 敏感信息（如SSH密码）建议通过CI环境的安全变量传递，避免硬编码在命令中