本文共 1651 字，大约阅读时间需要 5 分钟。

Harbor 从 1.9.3 升级到 2.8.0 的完整过程与注意事项

升级 Harbor 从 1.9.3 到 2.8.0 的过程需要仔细规划和执行，以下是详细的操作步骤和常见问题解答

升级前的准备

在开始升级之前，请确保以下条件已满足：

• 操作系统：CentOS 7.x 及以上版本
• Docker 版本：19.03.9 或更高版本（注意：19.x 版本在 Harbor 升级数据库时可能会导致问题）
• Harbor 原版本：1.9.3

升级步骤

1. 备份旧版本 Harbor

Harbor 的数据目录通常位于 /home/harbor_data，容器配置文件位于 /etc/harbor。建议备份以下文件：

• /etc/harbor/harbor.yml（配置文件）
• /home/harbor_data（数据目录）

备份命令

cd /etc/harborcp harbor.yml /home/harbor/harbor_backup.ymlcp -R /home/harbor_data /home/harbor_data_backup

2. 卸载旧版本 Harbor

使用 Docker 卸载旧版本 Harbor：

cd /home/harbordocker-compose down

3. 安装 Harbor 2.0.0

在安装 Harbor 2.0.0 之前，需要先升级到 2.0.0，以确保后续操作顺利进行：

# 下载 Harbor 2.0.0 安装包curl -L -o harbor.rpm https://github.com/GitLab/Harbor/releases/download/v2.0.0/harbor-2.0.0-0.x86_64.rpm# 安装 Harborrpm -ivh harbor.rpm

4. 升级数据库

Harbor 2.0.0 及以上版本使用 PostgreSQL，默认数据库升级方式为在线升级。确保数据库状态正常：

# 进入 PostgreSQL shellsudo -u postgres psql -h localhost -U harbor -d harbor

5. 升级 Harbor 到 2.8.0

使用 Docker 升级 Harbor：

# 进入 Harbor 安装目录cd /home/harbor# 执行升级指令./harbor upgrade

6. 数据库升级

Harbor 2.3.0 及以上版本支持数据库迁移，PostgreSQL 从 9.6 升级至 13.3：

# 进入 PostgreSQL shellsudo -u postgres psql -h localhost -U harbor -d harbor\q--_upgrade

7. 检查配置

在完成数据库升级后，重新检查 /etc/harbor/harbor.yml 配置文件，确保所有参数与当前系统版本匹配。

8. 最终验证

• 启动 Harbor 服务：

cd /home/harbordocker-compose up -d

• 访问 Harbor 网站，确认所有功能正常运行。

常见问题解答

Q：为什么升级 Docker 到 19.x 会导致 Harbor 升级数据库失败？

A：在 Harbor 升级数据库时，19.x 版本的 Docker 可能会导致 containerd 存储层问题，建议先升级到 Docker 20.x 版本或使用 Docker EE。

Q：Harbor 2.3.0 支持从 1.9.x 直接升级吗？

A：不，Harbor 2.3.0 不支持直接从 1.9.x 升级，需先升级到 2.0.0，再升级到 2.3.0。

总结

Harbor 升级过程中，关键是确保数据库迁移和依赖组件版本匹配。按照以上步骤操作，结合备份和验证步骤，可以顺利完成从 1.9.3 到 2.8.0 的升级。如遇到具体问题，请参考 Harbor 官方文档或联系技术支持。