内网jenkins跨版本升级

概要:

原来使用的jenkins版本为1.6，现在需要升级为最新版2.3.6

由于在内网，不能使用jenkins自带的在线升级工具

升级思路：

由于版本跨度太大，直接copy jenkins目录，启动最新版本jenkins war包的方式已经不兼容：jenkins任务显示不全

思索再三，只能 1.重新搭一套最新的jenkins版本，同时为最新版jenkins下载适配原来jenkins所使用的插件 2.进行jenkins的数据迁移

1.离线下载所有用到的最新版jenkins插件

通过参考官网文档：https://www.jenkins.io/doc/book/installing/offline/

得知插件离线下载工具：plugin-installation-manager-tool

离线下载插件使用说明参考：https://github.com/jenkinsci/plugin-installation-manager-tool

在外网搭建插件下载工具环境（jdk，最新jenkins war包，插件下载工具）

编辑插件下载工具文档:把原来jenkins plugins目录下所有的文件名导出，整理

注：有些插件名字可能有出入导致下载失败

确定插件名称可以在官网插件页面搜索相关插件：https://plugins.jenkins.io/

可以下载下来并解压，查看实际插件名称

ant
antisamy-markup-formatter
batch-task
credentials
cvs
external-monitor-job
javadoc
junit
ldap
mailer
matrix-auth
matrix-project
maven-plugin
pam-auth
powershell
publish-over-ftp
publish-over-ssh
rebuild
role-strategy
script-security
ssh-credentials
ssh-slaves
subversion
translation
view-job-filters
windows-slaves

插件下载清单文档编辑完，开始执行命令下载

/your/path/to/java -jar jenkins-plugin-manager-*.jar --war /your/path/to/jenkins.war --plugin-file /your/path/to/plugins.txt

到这步最新版jenkins插件下载完成

2.备份老jenkins迁移文件

到老jenkins的数据目录 JENKINS_HOME 下依次备份：

jobs                  (任务)

users               （用户）

config.xml        （视图，子节的等）

nodes               （运行节点）

jenkins.plugins.publish_over_ssh.BapSshPublisherPlugin.xml          （ssh发布插件配置文件）

jenkins.plugins.publish_over_ftp.BapFtpPublisherPlugin.xml              （ftp发布插件配置文件）

jenkins.model.JenkinsLocationConfiguration.xml                                  （IP配置文件，此文件在jenkins初始化时会指定当前ip为jenkins ip）

3.初始化新版jenkins

按照官方文档操作：https://www.jenkins.io/doc/book/installing/offline/

把最新版jenkins war包拷贝至内网机器指定目录下

执行启动命令nohup /your/path/to/java   -DJENKINS_HOME=/your/path/to/jenkins_data -jar /your/path/to/jenkins.war --httpPort=10086 > out.log 2>&1 &

此命令可以保存为 jenkinsStart.sh脚本

注：-DJENKINS_HOME参数必须在 -jar 前面才有效

按照上面文档说明初始化jenkins

4.拷贝数据至新JENKINS_HOME 目录

拷贝初始化完毕的JENKINS_HOME  jenkins_data目录 为 jenkins_data_new

在 jenkins_data_new目录里，用上面备份完的jenkins文件替换掉相关文件夹，并把所下载的所有插件放入plugins文件夹

修改启动命令为nohup /your/path/to/java   -DJENKINS_HOME=/your/path/to/jenkins_data_new -jar /your/path/to/jenkins.war --httpPort=10086 > out.log 2>&1 &

使用原来jenkins的管理账号登陆jenkins，查看任务是否正常

5.检查jenkins，并完善相关配置

经过检查：

1.发现 ssh主机密码不能识别，需要逐个修改

2.已经配置的jenkins_slave节点需要重新配置连接

以上处理完毕，jenkins测试一切正常，升级完成