Harbor打怪升级

目录

1、目标

2、V1.4升级至V1.6

3、V1.6升级至V1.9

4、V1.9升级至V2.0

5、写在最后

1、目标

Harbor V1.4版本升级至V2.0

 

 

 

注：

Harbor升级须要注意的是，不是一口吃成胖子，须要迭代升级（如图），不能直接从V1.4升级到V2.0，须要先从V1.4--V1.6--V1.9--V2.0；这里涉及到大版本与小版本；

大版本升级：大版本升级涉及到数据库结构之类的改变，须要迭代升级

小版本升级：只需下载对应的版本，把旧版本的配置文件转换成新版本的格式，再启动便可

 

2、V1.4升级至V1.6

一、V1.4到V1.6版本，最大的改变就是数据库从Mariadb到postgrepsql；

二、大版本有数据库结构改变的，须要升级数据库；没有数据库升级的，只需转换配置文件；

三、备份、备份、备份

 

步骤：

 

1）中止容器

docker-compose down -v

 

2）备份

mkdir /backup_bak    # 建立备份目录
cp -r harbor /backup_bak/harbor_v1.4   # 备份配置文件目录
cp -r /data/database /harbor_bak/database1.4  # 备份数据库文件

 

3）另外一种数据库备份

docker run -it --rm -e DB_USR=user -e DB_PWD=password -v /data/database/:/var/lib/mysql -v /harbor_bak/harbor1.4/harbor.cfg:/harbor-migration/harbor-cfg/harbor.cfg -v /harbor_bak/1.4_bak:/harbor-migration/backup goharbor/harbor-db-migrator:1.4 backup

 

DB_USER：数据库登陆名（可从配置文件里获取）

DB_PWD：数据库密码（可从配置文件里获取）

第一个-v：/data/database/:/var/lib/mysql 前面为数据库文件，具体根据本身的配置文件里设置的数据目录下，后面不变；

第二个-v：/harbor_bak/harbor1.4/harbor.cfg:/harbor-migration/harbor-cfg/harbor.cfg 前面为harbor1.4的配置文件，后面不变；

第三个-v：/harbor_bak/1.4_bak:/harbor-migration/backup 前面为备份到的哪一个目录，后面不变；

 

4）升级数据库

docker run -it --rm -e DB_USR=user -e DB_PWD=password -v /data/database/:/var/lib/mysql -v /harbor_bak/harbor1.4/harbor.cfg:/harbor-migration/harbor-cfg/harbor.cfg -v /harbor_bak/1.6_database:/harbor-migration/backup goharbor/harbor-migrator:v1.6.0 up

 

DB_USER：数据库登陆名（可从配置文件里获取）

DB_PWD：数据库密码（可从配置文件里获取）

第一个-v：/data/database/:/var/lib/mysql 前面为1.4版本的数据库文件，后面不变；

第二个-v：/harbor_bak/harbor1.4/harbor.cfg:/harbor-migration/harbor-cfg/harbor.cfg 前面为1.4版本的配置文件，后面不变；

第三个-v：/harbor_bak/1.6_database:/harbor-migration/backup 前面为升级后的数据库文件，后面不变；

 

5）配置文件转换

 docker run -it --rm -v /harbor_bak/harbor_1.4/harbor.cfg:/harbor-migration/harbor-cfg/harbor.cfg -v harbor/harbor.cfg:/harbor-migration/harbor-cfg-out/harbor.cfg goharbor/harbor-migrator:v1.6.0 --cfg up

 

第一个-v：/harbor_bak/harbor_1.4/harbor.cfg:/harbor-migration/harbor-cfg/harbor.cfg 现有1.4版本的配置文件，后面不变；

第二个-v： harbor/harbor.cfg:/harbor-migration/harbor-cfg-out/harbor.cfg 前面为转换后的1.6版本的配置文件，后面不变；

 

注：

将1.4版本的配置文件转换成1.6版本，新的配置文件将会输出至harbor/harbor.cfg，注意检查里面的配置文件，密码是否对应的转换过来了，没有的话，需手动改。

 

3、V1.6升级V1.9

V1.6升级V1.9比较大的变化是配置文件由cfg形式变成yml文件，总体上只需转换配置文件便可；步骤以下

 

1）中止容器

docker-compose down -v

 

2）备份

cp -r harbor /backup_bak/harbor_v1.6   # 备份配置文件目录
cp -r /data/database /harbor_bak/database1.6  # 备份数据库文件

 

3）V1.6版本的配置文件转换成V1.9版本的配置文件

docker run -it --rm -v /harbor_bak/harbor_1.6/harbor.cfg:/harbor-migration/harbor-cfg/harbor.cfg -v /harbor.yml:/harbor-migration/harbor-cfg-out/harbor.yml goharbor/harbor-migrator:v1.9.3 --cfg up

 

第一个-v：/harbor_bak/harbor_1.6/harbor.cfg:/harbor-migration/harbor-cfg/harbor.cfg 前面为harbor1.6版本的harbor.cfg配置文件，后面为固定的

第二个-v：/harbor.yml:/harbor-migration/harbor-cfg-out/harbor.yml 前面为将被转换成1.9版本配置文件的目录及文件，根据本身的实际状况指定，后面为固定的

 

4）下载harbor1.9

wget https://github.com/goharbor/harbor/releases/download/v1.9.3/harbor-online-installer-v1.9.3.tgz
tar -xvf harbor-online-installer-v1.9.3.tgz

 

5）拷贝转换好的V1.9版本配置文件放置harbor1.9，并启动

cp /harbor.yml harbor1.9/  #拷贝第三步中由1.6版本转换成1.9版本的配置文件到harbor1.9的安装目录
cd harbor1.9/
./install 

 

4、V1.9升级V2.0

V1.9升级V2.0只需转换配置文件，步骤以下：

 

1）中止容器

docker-compose down -v

 

2）备份

cp -r harbor /backup_bak/harbor_v1.9   # 备份配置文件目录
cp -r /data/database /harbor_bak/database1.9  # 备份数据库文件

 

3）1.9版本的配置文件harbor.yml转换成2.0版本的配置文件harbor.yml

# 拉取goharbor/prepare:v2.0.0镜像
docker pull goharbor/prepare:v2.0.0

# 这里先拷贝一份原来的配置文件到一个目录下，这里个人是/usr/local/leee/harbor.yml
# 不指定输出文件的话，默认到当前目录下，若是输入文件与输出文件在同一个目录，那么新版本的配置文件将会覆盖旧版本的配置文件，必定要作好备份
docker run -it --rm -v /:/hostfs goharbor/prepare:v2.0.0 migrate -i /usr/local/leee/harbor.yml

# 也能够写成

docker run -it --rm -v /:/hostfs goharbor/prepare:v2.0.0 migrate -i /usr/local/leee/harbor.yml -o /usr/local/leee/harbor_v2.yml -t 2.0.0

 

拉取goharbor/prepare:v2.0.0镜像，这个镜像一共有3个做用 prepare、gencert、migrate，其中migrate就是转换配置文件的；

migrate一个三个参数：

      -i ：指定被转换的配置文件，在这里就是1.9版本的harbor.yml

      -o：转换到哪个文件，默认是当前目录下的harbor.yml

      -t：转换到那个版本，这里个人prepare镜像是2.0.0版本，所以默认是将配置文件转换成2.0版本格式

 

 

4）下载2.0版本的Harbor包

 

wget https://github.com/goharbor/harbor/releases/download/v2.0.0/harbor-online-installer-v2.0.0.tgz
tar -xvf harbor-online-installer-v2.0.0.tgz

 

五、拷贝已转换的配置文件到2.0版本的harbor包下，并启动

cp /usr/local/leee/harbor_v2.0.yml .
./install

 

相关文档连接：

https://github.com/goharbor/harbor/blob/release-1.6.0/docs/migration_guide.md

https://github.com/goharbor/harbor/blob/release-1.9.0/docs/migration_guide.md

https://goharbor.io/docs/2.0.0/administration/upgrade/

 

写在最后

在平凡中坚持前行，总有一天会碰见不同的本身。

 

写博客记录、思考、总结，趟过的坑不趟第二遍。

 

全部的文章，皆同步在公众号“运维汪”，可关注；也可加入“不扯淡，专一于技术”的QQ群：753512236；