Docker 中 Jenkins 的配置指南

1. 安装 Docker 版 Jenkins

快速启动 Jenkins 容器

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

带持久化存储的推荐启动方式

docker run -d \
  --name jenkins \
  -p 8080:8080 \
  -p 50000:50000 \
  -v /your/local/path:/var/jenkins_home \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v $(which docker):/usr/bin/docker \
  jenkins/jenkins:lts-jdk11

2. 初始设置

1. 访问 http://localhost:8080
2. 从容器日志中获取初始管理员密码： bash docker logs jenkins
3. 安装推荐插件或自定义选择插件
4. 创建第一个管理员用户

3. 常用配置

配置全局工具

1. 进入 Manage Jenkins > Global Tool Configuration
2. 配置 JDK、Maven、Git 等工具的路径

配置 Docker 集成

1. 安装 "Docker" 和 "Docker Pipeline" 插件
2. 在 Manage Jenkins > Configure System 中配置 Docker Cloud

配置代理（如果需要）

docker run ... -e http_proxy="http://proxy.example.com:8080" -e https_proxy="http://proxy.example.com:8080" ...

4. 安全配置

1. 进入 Manage Jenkins > Configure Global Security
2. 建议启用：
   • 安全矩阵或基于项目的矩阵授权策略
   • CSRF 保护
   • 防止跨站点请求伪造

5. 备份配置

定期备份 Jenkins 数据

docker exec jenkins tar -czvf /tmp/jenkins_backup.tar.gz /var/jenkins_home
docker cp jenkins:/tmp/jenkins_backup.tar.gz .

6. 常用插件推荐

• Blue Ocean: 现代化 UI
• Pipeline: 流水线支持
• Git/GitHub: 版本控制集成
• Docker: Docker 集成
• Credentials: 凭据管理
• SSH Agent: SSH 支持

7. 使用 Docker Compose 部署

创建 docker-compose.yml 文件：

version: '3'
services:
  jenkins:
    image: jenkins/jenkins:lts-jdk11
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - jenkins_data:/var/jenkins_home
      - /var/run/docker.sock:/var/run/docker.sock
    restart: unless-stopped

volumes:
  jenkins_data:

启动：

docker-compose up -d

8. 故障排查

• 查看日志: docker logs jenkins
• 进入容器: docker exec -it jenkins bash
• 端口冲突: 检查 8080 和 50000 端口是否被占用
• 权限问题: 确保挂载的卷有正确的读写权限

希望这个指南能帮助您顺利配置 Docker 中的 Jenkins！如有特定需求或遇到问题，可以提供更多细节以便给出更精确的建议。