Docker 部署 Jenkins 实战指南（含数据持久化方案）

📝 前置条件

1. 已安装 Docker 环境（推荐 CentOS 安装参考：Docker 官方安装文档）
2. 确保 8080 端口未被占用（本文示例使用 8080 映射端口）

🔧 安装步骤

1️⃣ 首次启动容器（数据初始化）

docker run --restart=always -d \
  --name llm_jenkins \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /etc/localtime:/etc/localtime \
  -p 8080:8080 \
  kubesphere/ks-jenkins:v3.3.0-2.319.1

💡 关键点解析

• --restart=always：容器异常退出时自动重启
• -v /var/run/docker.sock：实现 Jenkins 调用宿主机 Docker 的核心配置
• -v /etc/localtime：同步宿主机时区，避免时间显示问题

2️⃣ 数据持久化配置

# 复制容器数据到宿主机
docker cp llm_jenkins:/var/jenkins_home /var/

# 修正目录权限（重要！）
chmod -R 777 /var/jenkins_home

⚠️ 权限警告
若不修改权限，后续启动可能报错：
mkdir /var/jenkins_home: permission denied

3️⃣ 重建持久化容器

# 停止并删除旧容器
docker stop llm_jenkins && docker rm -f llm_jenkins

# 重新启动（新增数据卷映射）
docker run --restart=always -d \
  --name llm_jenkins \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/jenkins_home:/var/jenkins_home \
  -v /etc/localtime:/etc/localtime \
  -p 8080:8080 \
  -p 50000:50000 \
  kubesphere/ks-jenkins:v3.3.0-2.319.1

🌐 访问 Jenkins

浏览器输入 http://<服务器IP>:8080，首次访问需完成初始化：

🔑 获取管理员密码

docker exec -it llm_jenkins cat /var/jenkins_home/secrets/initialAdminPassword

🚀 插件安装指引

1. 选择「安装推荐插件」（自动安装常用插件）
2. 插件安装失败时：
   🔧 解决方案：进入「系统管理」→「插件管理」手动安装以下核心插件：
   • Pipeline
   • GitHub Integration
   • Docker Pipeline

👨💼 创建管理员账户

• 用户名/密码建议统一使用 admin（后续可修改）
• Jenkins URL 保持默认（后续可在系统配置中修改）

✅ 完成部署

当出现「Jenkins 已就绪」提示时，表示安装成功！建议立即执行：

1. 进入「系统管理」→「系统配置」修改 Jenkins URL
2. 进入「系统管理」→「全局工具配置」配置 JDK/Maven 等工具路径