liwanggui/jenkins

Jenkins镜像（适用于UOS Server V20）

镜像概述

本镜像基于Jenkins 2.426.2-lts稳定版本构建，专为UOS Server V20操作系统设计，提供完整的持续集成/持续部署（CI/CD）能力，支持自动化构建、测试和部署软件项目，满足开发团队在UOS环境下的自动化流程需求。

核心功能与特性

• 稳定版本：基于Jenkins 2.426.2-lts长期支持版本，确保功能稳定可靠
• 系统适配：针对UOS Server V20操作系统优化，兼容性良好
• 数据持久化：支持通过卷挂载实现Jenkins数据持久化，避免容器重启数据丢失
• 时区配置：默认配置Asia/Shanghai时区，符合国内使用习惯
• 资源控制：可配置内存资源限制与保留，避免资源过度占用
• 标准端口映射：提供8080（Web界面）和50000（代理通信）标准端口映射

使用场景

• UOS Server V20环境下的软件项目持续集成/持续部署（CI/CD）
• 开发团队自动化构建、测试、打包和部署流程管理
• 中小型项目的自动化流程搭建，降低人工操作成本
• 需要在国产化操作系统环境中实现DevOps流程的场景

使用方法与配置说明

前提条件

• 已安装Docker Engine和Docker Compose
• UOS Server V20操作系统环境
• 具备基本的Docker命令操作能力

Docker Compose部署（推荐）

创建docker-compose.yml文件，内容如下：

yaml
version: '3'

services:
  jenkins:
    image: liwanggui/jenkins:2.426.2-lts
    container_name: jenkins
    restart: always
    network_mode: bridge
    user: "1000"
    volumes:
      - ./jenkins_data:/var/jenkins_home
    environment:
      TZ: "Asia/Shanghai"
    ports:
      - "8080:8080"
      - "50000:50000"
    deploy:
      resources:
        limits:
          memory: 10240M
        reservations:
          memory: 1024M

执行以下命令启动服务：

bash
docker-compose up -d

手动运行（docker run）

通过docker run命令直接启动容器：

bash
docker run -d \
  --name jenkins \
  --restart always \
  --network bridge \
  -u 1000 \
  -v $(pwd)/jenkins_data:/var/jenkins_home \
  -e TZ="Asia/Shanghai" \
  -p 8080:8080 \
  -p 50000:50000 \
  --memory=10240M \
  --memory-reservation=1024M \
  liwanggui/jenkins:2.426.2-lts

关键配置参数说明

基础配置

• 镜像信息：liwanggui/jenkins:2.426.2-lts（指定镜像名称及版本）
• 容器名称：container_name: jenkins（自定义容器名称，便于管理）
• 重启策略：restart: always（容器退出时自动重启）
• 网络模式：network_mode: bridge（使用Docker默认桥接网络）
• 运行用户：user: "1000"（指定UID为1000的用户运行，避免权限问题）

数据持久化

• 卷挂载：- ./jenkins_data:/var/jenkins_home（将宿主机当前目录下的jenkins_data目录挂载到容器内的Jenkins工作目录，确保配置、插件和构建数据持久化）

环境变量

• 时区设置：TZ: "Asia/Shanghai"（配置容器时区为上海时区，确保时间显示正确）

端口映射

• 8080:8080：Jenkins Web管理界面访问端口
• 50000:50000：Jenkins代理节点与主节点通信端口

资源限制

• 内存限制：limits.memory: 10240M（最大可用内存10GB）
• 内存保留：reservations.memory: 1024M（启动时保留1GB内存，确保基础运行需求）

初始化与访问

1. 容器启动后，通过浏览器访问 http://<宿主机IP>:8080 打开Jenkins Web界面
2. 获取初始管理员密码：

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

3. 输入密码后，按照引导完成插件安装和管理员账户设置
4. 配置完成后即可开始创建CI/CD任务

注意事项

• 宿主机jenkins_data目录需确保有足够权限（可通过chown -R 1000:1000 ./jenkins_data设置权限）
• 根据实际需求调整内存资源限制，避免资源不足或浪费
• 生产环境建议配置HTTPS以增强安全性
• 定期备份jenkins_data目录，防止数据丢失