如何升级Jenkins不丢失原有内容并恢复Pipeline共享库功能？

一、安全升级Jenkins（不丢失原有项目） #

• 提前备份核心数据
  • 备份Jenkins主目录：找到Jenkins安装主目录（Linux默认/var/lib/jenkins，Windows默认C:\Program Files\Jenkins\.jenkins），直接压缩整个目录，包含所有项目配置、插件数据和构建历史
  • 外部数据库备份（若使用）：如果Jenkins配置了MySQL等外部数据库，执行导出命令，比如mysqldump -u 用户名 -p jenkins数据库名 > jenkins_backup.sql
• 执行升级操作
  • 停止Jenkins服务：Linux用sudo systemctl stop jenkins，Windows在服务管理器中找到Jenkins服务停止
  • 替换安装文件：下载Jenkins 2.361.4版本安装包，war包替换/usr/share/jenkins/jenkins.war（Linux），Windows直接运行安装程序选择升级选项
  • 启动Jenkins：Linux执行sudo systemctl start jenkins，Windows启动对应服务
  • 验证升级：打开Jenkins页面，确认所有项目、配置正常加载

二、恢复共享库功能 #

• 处理弃用的Pipeline共享库插件
  • 该插件已整合到Jenkins核心功能中，升级到2.361.4版本后无需单独安装，共享库配置逻辑与之前一致
  • 重新核对共享库配置：进入Jenkins全局配置，找到「Global Pipeline Libraries」，检查库名称、代码仓库地址、默认版本等配置是否正确
  • 测试Pipeline任务：运行一个此前使用共享库的任务，验证是否能正常加载并执行共享库代码
• 处理WMI Windows Agents插件
  • 若无需Windows代理节点，直接卸载该插件即可；若需要管理Windows节点，替换为官方推荐的Windows Agents插件，功能完全覆盖原WMI插件

三、额外注意事项 #

• 升级后进入插件管理页面，检查所有插件的兼容性，将需要更新的插件升级到与Jenkins 2.361.4匹配的版本
• 如果共享库仍无法工作，检查Pipeline脚本中的引用语法，比如@Library('你的库名') _是否书写正确

内容的提问来源于stack exchange，提问作者Haleema Essa