blankhang/jenkins

blankhang/jenkins 镜像文档

镜像概述

blankhang/jenkins是一个定制化的Jenkins镜像，基于官方jenkins/jenkins:lts-jdk25构建。该镜像解决了在Ubuntu 22.04 LTS系统上使用原版Jenkins镜像时出现的Docker命令未找到及GLIBC版本不兼容问题，同时集成了Docker CLI、Maven、Node.js、Gradle等常用构建工具，配置中文语言支持和亚洲/上海时区，适用于需要在Jenkins中执行容器化构建和多语言项目开发的场景。

核心功能与特性

基础环境

• 基础镜像：基于jenkins/jenkins:lts-jdk25，提供长期支持的Jenkins版本和JDK25运行环境
• 时区配置：默认设置为Asia/Shanghai，确保构建时间与本地时间一致
• 语言支持：配置zh_CN.UTF-8字符集，支持中文显示

预装工具

• Docker CLI：通过Docker官方源安装最新版Docker客户端，支持在Jenkins任务中执行docker命令
• 构建工具：
  • Maven（通过apt安装）
  • Gradle 9.3.0（手动安装并配置环境变量）
  • Node.js 22（通过NodeSource源安装）及npm、yarn、pnpm包管理器
• 基础工具：sudo、git、wget、unzip、curl等常用系统工具

权限与配置

• 用户权限：默认使用root用户运行，jenkins用户添加到docker组，具备执行Docker命令权限
• sudo配置：允许jenkins用户无密码执行sudo命令
• 缓存目录：预创建Gradle缓存目录并授权，优化构建性能

预安装Jenkins插件

包含以下常用插件，减少初始化配置时间：

• 版本控制：git
• 构建工具：maven-plugin、gradle、nodejs
• 流水线：blueocean、pipeline-stage-view、pipeline-utility-steps、pipeline-maven等
• 中文支持：localization-zh-cn、locale
• Docker集成：docker-plugin、docker-workflow
• 其他：ws-cleanup、ssh-steps、publish-over-ssh

使用场景

• 在Ubuntu 22.04 LTS系统中部署Jenkins，避免原版镜像的GLIBC版本问题
• 需要在Jenkins任务中直接执行Docker命令（如构建镜像、推送镜像）的场景
• 构建Java（Maven/Gradle）、Node.js（npm/yarn/pnpm）多语言项目
• 需要中文界面和上海时区的Jenkins环境

使用方法

通过docker-compose部署（推荐）

1. 创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  jenkins:
    image: docker.xuanyuan.run/blankhang/jenkins
    container_name: jenkins
    restart: always
    privileged: true
    user: root
    healthcheck:
      test: curl -s https://localhost:8080 >/dev/null; if [[ $? == 52 ]]; then echo 0; else echo 1; fi
      interval: 1m
      timeout: 5s
      retries: 3
    ports:
      - '8080:8080'
    volumes:
      # 替换为宿主机实际路径，存储Jenkins数据
      - '/docker/jenkins/jenkins_home:/var/jenkins_home'
      # 同步宿主机时间
      - '/etc/localtime:/etc/localtime:ro'
      # 挂载Docker socket，允许容器内使用宿主机Docker
      - '/var/run/docker.sock:/var/run/docker.sock'
networks:
  default:

2. 启动服务：

shell
docker compose up -d

通过docker run部署

shell
docker run -d \
  --name jenkins \
  --restart always \
  --privileged \
  -u root \
  -p 8080:8080 \
  -v /docker/jenkins/jenkins_home:/var/jenkins_home \
  -v /etc/localtime:/etc/localtime:ro \
  -v /var/run/docker.sock:/var/run/docker.sock \
  docker.xuanyuan.run/blankhang/jenkins

配置说明

卷挂载

环境变量

镜像内置以下环境变量，如需修改可在启动时通过-e参数覆盖：

健康检查

默认配置健康检查：每1分钟通过curl访问https://localhost:8080，返回状态码52时判定为健康（Jenkins启动成功但未完成初始化），超时5秒，重试3次。

初始化访问

1. 启动容器后，通过浏览器访问 http://<服务器IP>:8080
2. 初始管理员密码获取：

   shell
   docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
   

3. 输入密码后，按照引导完成Jenkins初始化配置（已预安装核心插件，可直接使用）