jameseckersall/jenkins

docker-jenkins 镜像文档

镜像概述

docker-jenkins是一个基于OpenShift Jenkins 2构建的Docker镜像，继承了Jenkins 2的核心功能并针对容器化环境进行了优化。该镜像旨在提供开箱即用的持续集成/持续部署（CI/CD）能力，支持开发团队自动化构建、测试和部署应用程序，特别适用于OpenShift集群或其他容器编排平台。

核心功能与特性

核心功能

• Jenkins 2基础功能：支持Pipeline流水线、自由风格项目、定时构建等核心CI/CD能力
• OpenShift集成：优化了与OpenShift集群的交互，支持在容器环境中执行构建和部署
• 插件生态：兼容Jenkins丰富的插件体系，可扩展支持代码管理（Git、SVN）、构建工具（Maven、Gradle）、测试框架（JUnit、Selenium）等

特性优势

• 容器化部署：轻量级容器化设计，易于在Docker或Kubernetes/OpenShift环境中部署和扩展
• 环境一致性：统一的运行环境，避免"在我机器上能运行"的问题
• 持久化支持：支持数据卷挂载，确保Jenkins配置、构建历史等数据持久化存储

使用场景

• 开发团队CI/CD流水线：自动化代码拉取、构建、测试、打包和部署全流程
• OpenShift集群集成：在OpenShift环境中部署CI/CD工具，与平台原生资源（如BuildConfig、DeploymentConfig）联动
• 多项目管理：集中管理多个项目的构建任务，支持权限控制和资源隔离
• 敏捷开发支持：快速响应代码变更，缩短从开发到部署的周期

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name jenkins \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins-data:/var/lib/jenkins \
  docker-jenkins

参数说明：

• -p 8080:8080：映射Jenkins Web界面端口
• -p 50000:50000：映射Jenkins代理节点通信端口
• -v jenkins-data:/var/lib/jenkins：挂载数据卷以持久化Jenkins数据

Docker Compose配置

yaml
version: '3'
services:
  jenkins:
    image: docker-jenkins
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - jenkins-data:/var/lib/jenkins
    environment:
      - JENKINS_OPTS=--prefix=/jenkins  # 配置URL前缀（可选）
      - JAVA_OPTS=-Xmx1024m  # 配置JVM参数（可选）
volumes:
  jenkins-data:

环境变量配置

首次访问与配置

1. 启动容器后，通过http://<主机IP>:8080访问Jenkins Web界面
2. 首次登录需输入初始管理员密码，可通过以下命令获取：

   bash
   docker logs jenkins | grep "initial admin password"
   

3. 完成插件安装（推荐安装"Pipeline"、"Git"、"Maven Integration"等基础插件）
4. 创建Pipeline或自由风格项目，配置源码管理、构建步骤和部署流程

注意事项

• 生产环境建议使用持久化卷（如Docker named volume或Kubernetes PersistentVolume）存储Jenkins数据，避免容器重启导致数据丢失
• 根据实际需求调整JVM内存参数（JAVA_OPTS），避免内存不足或资源浪费
• 定期备份Jenkins数据卷，防止配置丢失
• 对于OpenShift环境，建议使用oc new-app命令部署，自动集成平台资源限制和权限管理