harbor-v1.10.2升级v2.6版本

1. 准备镜像
   harbor旧版为v1.10.2，升级最新版本需要查看harbor官网所支持的对应升级最低版本，harbor v2.6.0支持升级的最低版本为v.2.4.0因此需要准备v2.4.0、v2.6.0 两个版本镜像文件，更低版本请参考官网升级需求。
   官网文档：

   https://goharbor.io/docs/2.4.0/administration/upgrade/
   https://goharbor.io/docs/2.6.0/administration/upgrade/

   下载链接：
   

   ?

   1 2	https://github.com/goharbor/harbor/releases/download/v2.4.0/harbor-offline-installer-v2.4.0.tgz      # harbor-V2.4.0 https://github.com/goharbor/harbor/releases/download/v2.6.0/harbor-offline-installer-v2.6.0.tgz      # harbor-V2.6.0  (本文最终升级版本)

2. 备份数据
   1）登录到 Harbor 主机，如果它仍在运行，请停止现有的 Harbor 实例

   ?

   1 2	cd /usr/local/src/harbor-v1.10.2                               # 进入harbor目录，这个是我的安装路径，替换成自己的 docker-compose down                                            # 关闭harbor

   2）备份 Harbor 的当前文件，以便在必要时回滚到当前版本
   

   ?

   1	mv harbor /my_backup_dir/harbor-v1.10.2                        # 备份当前版本harbor，以防回退版本

   3）备份数据库，默认情况下在目录中/data/database


   ?

   1	cp -r /data/harbor/database /my_backup_dir/                    # 备份数据库

3. 升级
   

   1）解压安装包

   ?

   1	tar -xf harbor-offline-installer-v2.4.0.tgz                    # 解压 harbor-offline-installer-v2.4.0.tgz tar -xf harbor-offline-installer-v2.6.0.tgz 　　                # 解压 harbor-offline-installer-v2.6.0.tgz

   2）导入镜像文件

   ?

   1	docker load -i harbor.v2.4.0.tar.gz                            # 导入镜像 harbor.v2.4.0.tar.gz docker镜像docker load -i harbor.v2.6.0.tar.gz                            # 导入镜像 harbor.v2.6.0.tar.gz docker镜像3）版本升级

   3）版本升级

   ?

   1 2 3 4 5 6 7 8 9 10 11 12

   cp /usr/local/src/harbor-v1.10.2/harbor.yml /root                                          # 复制旧harbor配置文件到root目录 cp /usr/local/src/harbor-v2.4.0/harbor.yml.tmpl /usr/local/src/harbor-v2.4.0/harbor.yml    # 修改配置文件名称　 docker run -it --rm -v /:/hostfs goharbor/prepare:v2.4.0 migrate -i /root/harbor.yml       # 升级harbor-v2.4.0版本，升级成功会有提示如下  ps: 升级harbor-v2.6.0 重复2,3步骤，注意v2.6.0需要将docker升级至20.10.8或以上版本 migrating to version 2.0.0 migrating to version 2.1.0 migrating to version 2.2.0 migrating to version 2.3.0 migrating to version 2.4.0 Written new values to /data/harbor_install_2.4.0/harbor.yml ./install                                                                                  # 安装 harbor，安装成功提示如下 （✔ ----Harbor has been installed and started successfully.----） docker ps                                                                                  # 查看容器状态

4. 版本回退

   ?

   cd /usr/local/src/harbor-v2.4.0                                                           # 进入当前版本目录

   docker-compose down　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 # 关闭harbor

   rm -rf /usr/local/src/harbor-v2.4.0                                                       # 删除当前版本harbor

   cp /my_backup_dir/harbor-v1.10.2 /usr/local/src/                                          # 恢复旧版本harbor

   cp /my_backup_dir/database /my_backup_dir/harbor/                                         # 恢复数据

   cd /usr/local/src/harbor-v1.10.2 && docker-compose up -d                                  # 重启harbor服务

   docker ps                                                                                 # 查看容器状态 

5. 故障处理
   1）harbor已使用空间与实际不匹配
   处理方法：当出现web显示的已使用空间与实际使用空间不匹配时，可以将版本升级至2.6.0或者以上版本，通过启用nable purge _upload directories（2.6.0默认启动）进入web端选择清理服务（测试多次发现刚升级完成后使用该功能并不能清理blob的空间，因此需要服务放那运行一段时间，默认的定时任务会在早上8:00进行清理，如果失败了，手动执行一下一般即可释放多余的磁盘空间 PS：该问题不会影响harbor的使用）

   2）Harbor 核心服务不可用
   处理方法：一般存在问题点在 harbor-log没有权限，redis一直重启，具体问题可以查看core.log进行排查。