Nexus从2.x升级到3.x的升级过程

一 升级背景

Nexus2.x版本无法支持前端仓库（原因：Nexus2.x版本的npm仓库不支持范围），导致前端无法使用内网的私有仓库，构建比较慢，特别是在jenkins上构建时，每次都需要去公网下载依赖包，导致一次构建时长在6分钟左右。

而Nexus3.x已经对npm仓库的范围做了支持。

原2.x版本是 2.11.2-03

原2.x版本home目录：/usr/local/nexus/nexus-2.11.2-03

原2.x版本工作目录：/usr/local/nexus/sonatype-work/nexus

二 升级前调研、备份

查看官方升级文档如下：

https://help.sonatype.com/repomanager3/installation/upgrading-from-nexus-repository-manager-2/upgrade-compatibility---repository-manager-2-to-3?_ga=2.48139495.1356744400.1610690445-973686423.1608687677

从官方文档得知，升级并不能简单的直接把现有的2.x直接升级到3.x，必须先把直线的2.x升级到2.x的最新版本，再升级到3.x。

升级前备份并停止服务

主要是备份 /usr/local/nexus/sonatype-work

/usr/local/nexus/nexus-2.11.2-03/bin/nexus stop
tar -czvf nexus2.tar.gz /usr/local/nexus/sonatype-work/neuxs
# 把旧版本 /usr/local/nexus/nexus-2.11.2-03 目录 移入到 新建的 backup目录
mkdir /usr/local/nexus/backup/
mv /usr/local/nexus/nexus-2.11.2-03 /usr/local/nexus/backup/

三 操作升级

1 升级到2.x最新版本

直接下载2.x最新版本，启动

# 下载下来的nexus的文件名： nexus-2.14.19-01-bundle.tar.gz
wget https://download.sonatype.com/nexus/oss/nexus-latest-bundle.tar.gz
# 解压 解压后目录为： nexus-2.14.19-01-bundle
tar -zxvf nexus-2.14.19-01-bundle.tar.gz
# 把解压后的目录下的 nexus-2.14.19-01 目录mv到 /usr/local/nexus/ 下
mv nexus-2.14.19-01-bundle/nexus-2.14.19-01 ./
# 到 /usr/local/nexus/nexus-2.14.19-01 目录下启动
/usr/local/nexus/nexus-2.14.19-01/bin/nexus start

到此为止升级到2.x最新版本已经完成

2 升级到3.x版本

3.x改动很大，是无法直接共用原有的工作目录的，所以就会涉及到2.x数据迁移到3.x数据的过程。

该过程中，2.x和3.x都是需要同时启动的。

3 安装3.x版本

到官网下载最新的包 https://help.sonatype.com/repomanager3/download/

安装目录也是在 /usr/local/nexus 下

cd /usr/local/nexus
# 下载最新的包
wget https://download.sonatype.com/nexus/3/latest-unix.tar.gz
tar -zxvf nexus-3.29.0-00-unix.tar.gz
# 把目录下的 nexus-3.29.0-01 移动到 /usr/local/neuxs/ 目录下
mv /usr/local/neuxs/nexus-3.29.0-02-unix/nexus-3.29.2-02 /usr/local/neuxs/
# 直接启动
/usr/local/nexus/nexus-3.29.0-02/bin/nexus start
 
# 会发现启动失败 因为同一台机端口8081已经被占用了，需要修改端口，修改方式 到 /usr/local/nexus/sonatype-work/nexus3/etc 修改 nexus.properties中的端口 并增加根uri（兼容2.x）
vim /usr/local/nexus/sonatype-work/nexus3/etc/nexus.properties
application-port=8082
nexus-context-path=/nexus/
 
# 改完端口再次重启 会发现启动成功了

4 原有仓库从neuxs2.x迁移到3.x

需要在2.x上配置升级代理”Upgrade Agent“

在nexus3.x上执行Upgrade

先增加Upgrade Capacity

再执行升级

后续Next步骤根据需要自行选择即可不再截图展示。

5 升级完成后修改端口关闭nexus2.x

/usr/local/nexus/nexus-2.14.19-01/bin/nexus stop
 
vim /usr/local/nexus/sonatype-work/nexus3/etc/nexus.properties
application-port=8081
 
/usr/local/neuxs/nexus-3.29.0-02/bin/nexus restart

到此整个升级已经完成，并且完美兼容了以前指定的仓库路径。