Ubuntu Jenkins部署更新流程是怎样的

Ubuntu 上 Jenkins 的部署与更新流程

一 环境准备与安装

• 安装受支持的 Java（推荐 OpenJDK 11 或 OpenJDK 17）：
  • 安装命令：sudo apt update && sudo apt install -y openjdk-11-jdk（或 openjdk-17-jdk）
  • 验证版本：java -version
• 添加 Jenkins 官方 APT 仓库（使用 GPG 密钥环方式，适配新版本 Ubuntu）：
  • 导入密钥：curl -fsSL https://pkg.jenkins.io/debian/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
  • 添加源：echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian binary/ | sudo tee /etc/apt/sources.list.d/jenkins.list > /devref
• 安装并启动 Jenkins：
  • 安装：sudo apt update && sudo apt install -y jenkins
  • 启动与开机自启：sudo systemctl start jenkins && sudo systemctl enable jenkins
  • 检查状态：sudo systemctl status jenkins
• 首次访问与初始化：
  • 访问：http://<服务器IP或域名>:8080
  • 解锁：查看初始管理员密码 sudo cat /var/lib/jenkins/secrets/initialAdminPassword
  • 安装插件与创建管理员用户，完成配置向导。

二 标准更新流程 APT 包管理

• 升级前准备：
  • 备份 JENKINS_HOME（默认 /var/lib/jenkins）：sudo cp -a /var/lib/jenkins /var/lib/jenkins_$(date +%F)
  • 检查当前 Java 版本是否满足新版本要求（Jenkins 2.346.3+ 需要 Java 11+）：java -version
  • 建议在维护窗口操作，并通知相关团队。
• 执行升级：
  • 更新索引：sudo apt update
  • 执行升级：sudo apt install --only-upgrade jenkins（或 sudo apt upgrade jenkins）
• 重启与验证：
  • 重启服务：sudo systemctl restart jenkins
  • 查看日志：sudo journalctl -u jenkins -b 或 tail -f /var/log/jenkins/jenkins.log
  • 登录 Web 界面确认版本与任务状态正常。

三 回滚与常见问题处理

• 回滚方案（APT）：
  • 查看可用版本：apt policy jenkins
  • 降级安装：sudo apt install jenkins=<目标版本>
  • 重启：sudo systemctl restart jenkins
  • 如插件不兼容，优先在 Web 界面回退单个插件，必要时恢复 JENKINS_HOME 备份。
• 常见问题与要点：
  • 升级后启动失败：优先检查 Java 版本兼容性 与日志报错；Jenkins 2.346.3+ 需 Java 11+。
  • 插件中心慢或失败：可临时使用国内镜像的 update-center.json，注意需同步改写插件下载地址，否则仅镜像索引仍会回源导致慢速或 403。示例（清华源）：
    • 配置文件：/var/lib/jenkins/hudson.model.UpdateCenter.xml
    • 内容：

      <?xml version='1.1' encoding='UTF-8'?>
      <sites>
        <site>
          <id>default</id>
          <url>https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json</url>
        </site>
      </sites>
      

  • 端口与代理：默认 8080；如前置 Nginx/Apache 反向代理，升级后核对代理配置与证书是否仍然有效。

四 附录 升级命令清单

• 备份：sudo cp -a /var/lib/jenkins /var/lib/jenkins_$(date +%F)
• 更新索引：sudo apt update
• 执行升级：sudo apt install --only-upgrade jenkins
• 重启服务：sudo systemctl restart jenkins
• 查看日志：sudo journalctl -u jenkins -b
• 版本回退：apt policy jenkins → sudo apt install jenkins=<版本> → sudo systemctl restart jenkins。