记一次harbor的升级之旅-吕啸腾的博客

Support deploy Harbor with Helm Chart, enables the user to have high availability of Harbor services, refer to the Installation and Configuration Guide.
Support on-demand Garbage Collection, enables the admin to configure run docker registry garbage collection manually or automatically with a cron schedule.
Support Image Retag, enables the user to tag image to different repositories and projects, this is particularly useful in cases when images need to be retagged programmatically in a CI pipeline.
Support Image Build History, makes it easy to see the contents of a container image, refer to the User Guide.
Support Logger customization, enables the user to customize STDOUT / STDERR / FILE / DB logger of running jobs.
Improve user experience of Helm Chart Repository:
- Chart searching included in the global search results
- Show chart versions total number in the chart list
- Mark labels to helm charts
- The latest version can be downloaded as default one on the chart list view
- The chart can be deleted by deleting all the versions under it

Harbor 的升级有几方面需要注意：

在升级之前需要先进行相关数据的备份工作
本博客内容只适用于从v1.6.0迁移到当前版本，如果要从早期版本升级，请参阅发行版分支中的迁移指南以升级到v1.6.0，并按照本文档升级到更高版本
从v1.6.0起，Harbor会在启动时自动尝试迁移数据库模式，因此如果从v1.6.0或更高版本升级，则无需调用迁移器工具来迁移数据
从v1.6.0起，Harbor将数据库从MariaDB迁移到PostgreSQL，并将Harbor，Notary和Clair DB合并为一个
有关数据库架构的更改，请参阅更改日志

升级 Harbor

一些目录说明：

备份文件目录： /srv
旧版本备份目录：/srv/harbor_older
旧版本数据备份目录：/srv/database
新版本软件下载目录：/opt/soft

首先，关闭现在运行的 Harbor 服务：

➜ cd /srv/harbor
➜ docker-compose down
Stopping harbor-jobservice  ... done
Stopping nginx              ... done
Stopping harbor-ui          ... done
Stopping redis              ... done
Stopping harbor-db          ... done
Stopping harbor-adminserver ... done
Stopping registry           ... done
Stopping harbor-log         ... done
Removing harbor-jobservice  ... done
Removing nginx              ... done
Removing harbor-ui          ... done
Removing redis              ... done
Removing harbor-db          ... done
Removing harbor-adminserver ... done
Removing registry           ... done
Removing harbor-log         ... done
Removing network harbor_harbor

升级之前需要先进行原版本的备份，避免升级失败可以自由回滚到旧版本：

➜ mv harbor /srv/harbor_older

备份Harbor数据，Harbor 的数据目录默认为 /data/database：

➜ cp -a /data/database /srv/database

从 Harbor版本下载页下载最新版 Harbor 文件，这里我们直接下载离线安装包进行升级：

➜ cd /opt/soft
➜ wget https://storage.googleapis.com/harbor-releases/release-1.7.0/harbor-offline-installer-v1.7.1.tgz

在升级 Harbor 之前，先要进行迁移。迁移工具作为 docker 镜像提供，因此我们应该从 docker hub 中提取图像。在以下命令中将 [tag] 替换为需要升级的 Harbor 发行版本（例如v1.5.0）,这里我们用 v1.7.1版本的镜像：

➜ docker pull goharbor/harbor-migrator:[tag]
➜ docker pull goharbor/harbor-migrator:v1.7.1

更新配置文件harbor.cfg

➜ docker run -it --rm -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg goharbor/harbor-migrator:v1.7.1 --cfg up

这里的 ${harbor_cfg}指的是我们之前安装的 harbor 的配置文件全路径，例如之前 harbor 版本的安装路径为 /srv/harbor，那么这里的 ${harbor_cfg}指的就是 /srv/harbor/harbor.cfg

以下是我的具体执行步骤，请参考：

# 备份harbor
➜ mv /srv/harbor /srv/harbor_older
➜ cd /srv/harbor_older

# 备份harbor配置文件
➜ cp harbor.cfg harbor.cfg.bak

➜ docker run -it --rm -v /srv/harbor_older/harbor.cfg:/harbor-migration/harbor-cfg/harbor.cfg goharbor/harbor-migrator:v1.7.1 --cfg up
Please backup before upgrade,
Enter y to continue updating or n to abort: y
The path of the migrated harbor.cfg is not set, the input file will be overwritten.
input version: 1.6.0, migrator chain: ['1.7.0']
migrating to version 1.7.0
Written new values to /harbor-migration/harbor-cfg/harbor.cfg

执行完上述步骤后会生成一个新的 harbor.cfg文件，我们需要将此文件复制到新的 harbor 版本目录下：

➜ tar xf /opt/soft/harbor-offline-installer-v1.7.1.tgz -C /srv/
➜ cp -f /srv/harbor_older/harbor.cfg /srv/harbor/

配置文件更新完成后，就可以升级了，需要注意的是默认新版 harbor 不会启用 chart repository service，如果需要管理 helm，我们需要在安装时添加额外的参数，例如：

## 默认安装
➜ cd /srv/harbor
➜ ./install.sh

## 启动 chart repository service 服务
➜ cd /srv/harbor
➜ ./install.sh --with-chartmuseum

等待安装完成即可，安装完成后会有如下类似提示：

...
✔ ----Harbor has been installed and started successfully.----
...

回滚到旧版本

如果升级失败，我们可以按照如下过程回滚到旧版本：

➜  cd /srv/harbor
➜  docker-compose down
➜  cd ..
➜  rm -rf harbor
➜  mv harbor_older harbor
➜  cp -a /srv/database /data/
➜  cd /srv/harbor
➜  ./install.sh

记一次harbor的升级之旅

TOC

升级 Harbor

回滚到旧版本

FEATURED TAGS