kearnmachine/jenkins

jenkins-docker 镜像文档

镜像概述

jenkins-docker是基于官方Jenkins镜像定制的扩展版本，通过添加特定依赖和工具，增强了对Maven打包、前端构建及自动化测试的支持，适用于需要集成多类构建工具的CI/CD场景。

核心功能与特性

• 扩展Maven支持：集成lib32z1和lib32ncurses5库，满足launch4j maven插件运行需求，支持Windows可执行文件打包。
• 无头测试能力：内置chromium浏览器，支持karmajs无头测试（运行时需添加--cap-add=SYS_ADMIN权限）。
• 前端工具集成：预装nodejs和yarn包管理器，可直接用于前端项目构建、依赖管理及自动化脚本执行。

使用场景与适用范围

• 需要通过launch4j maven插件生成Windows可执行文件的Java项目构建。
• 包含karmajs自动化测试的前端项目CI/CD流程。
• 需同时处理Java后端与Node.js前端构建的一体化CI环境。

使用方法与配置说明

基本运行命令

bash
docker run -d \
  --name jenkins-custom \
  --cap-add=SYS_ADMIN \  # 必须添加，以支持chromium无头模式
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins-docker

Docker Compose配置示例

yaml
version: '3'
services:
  jenkins:
    image: jenkins-docker
    container_name: jenkins-custom
    restart: always
    cap_add:
      - SYS_ADMIN  # 启用chromium所需权限
    ports:
      - "8080:8080"  # Jenkins Web界面
      - "50000:50000"  # 代理端口
    volumes:
      - jenkins_home:/var/jenkins_home  # 持久化Jenkins数据
volumes:
  jenkins_home:

关键配置说明

• chromium权限：运行容器时必须添加--cap-add=SYS_ADMIN，否则chromium无头模式可能因权限不足无法启动。
• 持久化存储：建议挂载/var/jenkins_home目录以持久化Jenkins配置、插件及构建数据。
• 工具版本：nodejs和yarn版本取决于基础镜像构建时的配置，如需特定版本，可通过容器内nvm或重新构建镜像调整。

注意事项

• 首次启动需通过日志获取初始管理员密码（docker logs jenkins-custom）。
• 若karmajs测试失败，检查是否已正确添加SYS_ADMIN权限，或尝试调整chromium启动参数（如--no-sandbox）。
• 扩展插件时需注意与预装工具版本的兼容性。