Harborのv1.5.1からv1.7.1へのアップグレード

みなさんはプライベートなコンテナレジストリとして何を利用していますか。VMwareによって開発されてCNCFに移管されたHarborはオープンソースでRBAC (Role Based Access Control)も利用できるため便利です。
Harborをv1.5.1からv1.7.1へアップグレードした時の経験に基づき、オンラインパッケージを利用してHarborをアップグレードするコマンドを記載します。
実際にアップグレードを行う前に最新の情報 [英語]に一度は目を通すことをお勧めします。

• 公式サイト(https://goharbor.io/docs/)
• ドキュメント(https://github.com/goharbor/harbor/blob/master/docs/migration_guide.md)

アップグレードパス

v1.5からv1.7へのアップグレードを行う場合、v.1.6を経由してください。ドキュメントでカバーされている内容はv1.6を経由する形です。この記事ではv1.5.1, v1.6.3, v1.7.1の順番でアップデートを実施します。

v1.5.1からv1.6.3へのアップグレード

ドキュメント： https://github.com/goharbor/harbor/blob/v1.6.3/docs/migration_guide.md

アップグレードの準備

アップグレードの前に必ずバックアップを行います。

バックアップ対象

• /data/database
• インストール時に利用したharbor.cfgを含むharborディレクトリ

変更対象

harbor.cfgをアップグレードするため現在のharbor.cfgとしてharborディレクトリからharbor.cfgをコピーします。今回の例では/home/teruyam/harbor.cfgに置きます。

# cp ./harbor/harbor.cfg /home/teruyam/harbor.cfg

アップグレードの実行

環境変数

#  db_pwd=VMware123!
# harbor_db_path=/data/database
# harbor_cfg=/home/teruyam/harbor.cfg
# tag=v1.6.3

Harbor DBをアップグレード

# docker run -it --rm -e DB_USR=root -e DB_PWD=${db_pwd} -v ${harbor_db_path}:/var/lib/mysql -v ${harbor_cfg}:/harbor-migration/harbor-cfg/harbor.cfg goharbor/harbor-migrator:${tag} up

NotaryとClair DBを利用している場合にはアップグレード

# docker run -it --rm -e DB_USR=root -v /data/notary-db/:/var/lib/mysql -v /data/database:/var/lib/postgresql/data goharbor/harbor-migrator:${tag} --db up
# docker run -it --rm -v /data/clair-db/:/clair-db -v /data/database:/var/lib/postgresql/data goharbor/harbor-migrator:${tag} --db up

上記手順を実行後にharbor.cfgがv1.6系に書き換わっていることを確認します。

$ grep _version ${harbor_cfg}
_version = 1.6.0 

v1.6からv1.7.1へのアップグレード

ドキュメント：https://github.com/goharbor/harbor/blob/v1.7.1/docs/migration_guide.md

環境変数

#  db_pwd=VMware123!
# harbor_db_path=/data/database
# harbor_cfg=/home/m/harbor.cfg
# tag=v1.7.1
# grep _version ${harbor_cfg}
_version = 1.7.0

アップグレードした構成ファイルを利用してインストール

Harbor 1.7.1のオンラインインストーラーをダウンロードして展開します。
リリース一覧：https://github.com/goharbor/harbor/releases

harbor.cfgを展開したharbor/harbor.cfgへコピーして上書きします。

最後にharborでインストールを実行して完了です。