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/

    下载链接：

    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 实例

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

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

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

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

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

  3. 升级

    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）导入镜像文件

    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）版本升级

    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进行排查。

posted @ 2022-12-12 15:15  Traktorea  阅读(775)  评论(0)  编辑  收藏  举报