Jenkins Docker镜像文档

1. 镜像概述和主要用途

Jenkins是一款开源的自动化服务器，核心功能为持续集成(CI)和持续部署(CD)，帮助团队自动化软件开发生命周期中的构建、测试、打包及部署流程。Jenkins Docker镜像将Jenkins服务封装为容器，提供快速部署、环境隔离、跨平台一致性等优势，用户无需手动配置依赖即可快速搭建功能完整的Jenkins实例，适用于需要简化CI/CD基础设施部署的团队。

2. 核心功能和特性

CI/CD流水线自动化：支持通过Web界面或Jenkinsfile（声明式/脚本式）定义复杂的构建、测试、部署流水线，实现全流程自动化。
丰富的插件生态：提供数千款***及社区插件，覆盖版本控制（Git、SVN）、构建工具（Maven、Gradle）、云服务（AWS、Docker）、通知工具（Slack、Email）等场景。
分布式构建能力：支持将任务分配到多台代理节点（Agent）执行，提高构建效率，适用于大型项目或资源密集型任务。
版本控制集成：无缝对接Git、Mercurial、Subversion等主流版本控制系统，可自动检测代码提交并触发流水线。
扩展性与定制化：通过环境变量、配置文件或插件自定义Jenkins实例，支持用户认证（LDAP、OAuth）、权限管理（RBAC）等安全特性。

3. 使用场景和适用范围

软件开发团队：自动化代码构建、单元测试、集成测试，减少人工操作并及时发现问题。
DevOps流程：实现从代码提交到生产部署的全流程自动化，缩短交付周期，提升发布可靠性。
自动化测试：定期运行测试套件，支持多环境（开发、测试、生产）测试验证，确保代码质量。
周期性任务执行：自动化数据库备份、日志清理、报表生成等定期任务，降低人工维护成本。

4. 使用方法和配置说明

4.1 基本部署（docker run）

通过以下命令快速启动Jenkins容器，默认映射Web端口（8080）和代理通信端口（50000）：

bash
docker run -d \
  --name jenkins \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_home:/var/jenkins_home \
  jenkins/jenkins:lts

参数说明：

-d：后台运行容器
--name jenkins：指定容器名称
-p 8080:8080：映射Web访问端口
-p 50000:50000：映射代理节点通信端口
-v jenkins_home:/var/jenkins_home：使用命名卷持久化数据
jenkins/jenkins:lts：使用长期支持（LTS）版本镜像

4.2 docker-compose部署

创建docker-compose.yml配置文件，支持自定义数据路径、环境变量等：

yaml
version: '3.8'
services:
  jenkins:
    image: jenkins/jenkins:lts
    container_name: jenkins
    restart: always
    ports:
      - "8080:8080"   # Web界面端口
      - "50000:50000" # 代理通信端口
    volumes:
      - ./jenkins_data:/var/jenkins_home  # 宿主机目录挂载（替换为实际路径）
      - /var/run/docker.sock:/var/run/docker.sock  # 允许容器内使用Docker命令（可选）
    environment:
      - JAVA_OPTS=-Xmx2g -Duser.timezone=Asia/Shanghai  # 配置JVM内存及时区
      - JENKINS_OPTS=--prefix=/jenkins  # 设置URL前缀（如通过反向代理访问，可选）
    user: "1000:1000"  # 匹配宿主机用户ID，避免权限问题（可选）

启动服务：

bash
docker-compose up -d

4.3 初始化配置

获取初始管理员密码：

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

或从挂载的数据卷中读取：cat ./jenkins_data/secrets/initialAdminPassword

访问Web界面；在浏览器中输入http://<主机IP>:8080，输入初始密码登录。
安装插件：选择"安装推荐插件"或手动选择所需插件（如Git、Maven、Docker），完成后创建管理员用户。

4.4 数据持久化

Jenkins数据（配置、插件、作业等）存储在/var/jenkins_home目录，必须通过-v参数挂载数据卷（命名卷或宿主机目录）以确保数据持久化，避免容器删除后数据丢失。

4.5 环境变量配置

常用环境变量说明：

环境变量	描述	默认值
`JENKINS_HOME`	Jenkins数据存储目录	`/var/jenkins_home`
`JAVA_OPTS`	JVM参数，如内存配置`-Xmx2g`、时区`-Duser.timezone=Asia/Shanghai`	无
`JENKINS_OPTS`	Jenkins启动参数，如URL前缀`--prefix=/jenkins`、端口`--httpPort=8081`	无（默认8080端口）
`JENKINS_SLAVE_AGENT_PORT`	代理节点通信端口	`50000`

5. 注意事项

权限问题：挂载宿主机目录时，需确保目录权限与容器内用户ID（默认1000）匹配，可通过chown 1000:1000 /path/to/jenkins_data调整。
资源配置：根据项目规模通过JAVA_OPTS调整JVM内存（如-Xmx2g），避免内存不足导致服务异常。
升级建议：升级前备份数据卷，拉取新版本镜像后重启容器，Jenkins会自动处理数据迁移。
安全加固：生产环境中建议启用HTTPS（通过反向代理配置SSL）、限制访问IP、定期更新插件及Jenkins版本以修复安全漏洞。