frisk/jenkins

Jenkins 预配置镜像（含Node.js及测试构建）

镜像概述

本镜像基于官方Jenkins构建，预先集成Node.js环境及常用测试构建配置，旨在简化CI/CD流程搭建，特别适用于需要Node.js运行时支持的前端项目自动化构建与测试场景。通过预配置减少环境初始化时间，开箱即可投入使用。

核心功能与特性

• 预安装Node.js：内置稳定版Node.js及npm，无需额外配置即可运行Node.js相关构建任务
• 预定义测试构建模板：包含常用测试框架（如Jest、Mocha）的构建步骤配置，支持快速创建测试任务
• 环境一致性：标准化Node.js版本及依赖管理，避免因环境差异导致的构建问题
• 无缝集成Jenkins生态：保留Jenkins原生功能，支持插件扩展及Pipeline配置

使用场景

• 前端项目（React、Vue、Angular等）的自动化构建、测试与部署
• 需要快速搭建CI/CD流程的小型开发团队
• 教学或演示环境中的Jenkins快速部署
• 对Node.js环境有依赖的持续集成场景

使用方法

基本部署（Docker Run）

bash
# 启动容器并映射必要端口，持久化Jenkins数据
docker run -d \
  -p 8080:8080 \  # Jenkins Web界面端口
  -p 50000:50000 \ # 代理节点通信端口
  -v jenkins_home:/var/jenkins_home \  # 持久化Jenkins数据
  --name jenkins-node-test \
  [镜像名称]:[版本标签]

Docker Compose配置

yaml
version: '3'
services:
  jenkins:
    image: [镜像名称]:[版本标签]
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - jenkins_home:/var/jenkins_home
    restart: always

volumes:
  jenkins_home:

初始化与访问

1. 启动容器后，通过docker logs jenkins-node-test获取初始管理员密码
2. 访问http://localhost:8080，输入初始密码完成Jenkins初始化
3. 在"新建任务"中选择"构建一个自由风格的软件项目"，即可使用预定义的测试构建模板

配置说明

环境变量

预定义测试构建模板

镜像包含以下常用测试构建配置，可直接在任务中引用：

• 前端单元测试：集成Jest测试框架，默认执行npm test命令
• 代码质量检查：包含ESLint配置，支持代码风格与错误检查
• 构建产物打包：预配置npm run build命令，生成生产环境产物

数据持久化

通过挂载/var/jenkins_home目录实现数据持久化，包含：

• Jenkins配置
• 插件数据
• 构建历史
• 预定义的测试模板配置

注意事项

• 首次启动需等待插件初始化完成，可能需要5-10分钟
• 如需自定义Node.js版本，可通过挂载/usr/local/node目录覆盖默认版本
• 高并发场景建议增加容器内存限制（如--memory=4g）