khoyi/jenkins

Jenkins 定制镜像文档

镜像概述

本镜像为基于官方Jenkins镜像的定制版本，专为个人实验室（Homelab）环境设计。保留Jenkins核心CI/CD功能的同时，针对个人开发场景进行配置优化，提供更贴合个人使用需求的持续集成/持续部署平台。

核心功能与特性

• 基于官方Jenkins稳定版构建，确保核心功能可靠性
• 集成个人实验室常用插件（如Git、Maven、Docker等工具链支持）
• 优化默认配置，减少个人环境下的初始配置工作量
• 支持数据持久化，保障配置信息和构建历史不丢失
• 兼容标准Jenkins生态，可无缝扩展功能

使用场景与适用范围

• 个人实验室环境下的CI/CD流程管理
• 小型项目或个人项目的自动化构建、测试与部署
• 学习和实验Jenkins功能的个人开发环境
• 家庭服务器或本地开发环境的自动化流程搭建

使用方法与配置说明

基本运行命令

bash
docker run -d \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  --name homelab-jenkins \
  your-image-tag

参数说明：

• -p 8080:8080: 映射Jenkins Web管理界面端口
• -p 50000:50000: 映射Jenkins代理节点通信端口
• -v jenkins_home:/var/jenkins_home: 使用Docker数据卷持久化Jenkins数据
• --name homelab-jenkins: 指定容器名称

docker-compose配置示例

yaml
version: '3'
services:
  jenkins:
    image: your-image-tag
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - jenkins_home:/var/jenkins_home
      - /var/run/docker.sock:/var/run/docker.sock  # 可选，如需在Jenkins中使用Docker
    restart: always
    environment:
      - JENKINS_OPTS=--prefix=/jenkins  # 可选，配置访问路径前缀
      - JAVA_OPTS=-Xmx1024m  # 可选，调整JVM内存配置

volumes:
  jenkins_home:

环境变量配置

数据持久化

推荐使用Docker数据卷（如示例中的jenkins_home卷）或本地目录挂载/var/jenkins_home目录，确保容器重启或重建后配置、插件和构建历史数据不丢失。

首次访问配置

1. 启动容器后，通过docker logs homelab-jenkins查看初始管理员密码
2. 访问http://localhost:8080，输入初始密码完成安装向导
3. 根据个人需求选择安装推荐插件或自定义插件

注意事项

• 确保宿主机端口8080和50000未被占用
• 首次启动可能需要几分钟时间初始化插件
• 如需使用Docker相关功能，建议挂载宿主机的/var/run/docker.sock并确保权限配置正确