升级 Harbor

升级 Harbor 是一个相对简单的过程,但复杂度可能会因以下因素而增加:

  • 您使用的安装方式。
  • 您当前 Harbor 版本的发布时间。
  • 是否升级到主版本。
  • 如果可能,建议先在测试环境中进行升级测试,测试环境应尽可能模拟生产环境。

您可以查阅官方升级文档了解更多信息。

升级路径

下表包含完整的升级路径。升级时,您需要按顺序升级 Operator 和 Harbor 实例的版本。

序号Alauda Build of Harbor Operator 版本要求
12.12.z
22.14.zPostgreSQL 15 或 16(需要升级)
INFO

上述版本号中的 .z 表示该次要版本的最新补丁版本。 执行升级时,您应始终使用最新的补丁版本,以确保获得最新的安全更新和错误修复。 各版本的最新补丁版本可在发行说明中查看。

WARNING

如果您的 Harbor 版本低于 2.12.0,请参考Harbor 数据迁移完成升级。

升级步骤

WARNING

为安全升级 Harbor 版本,请注意以下事项:

  1. PostgreSQL 版本检查确保您的 PostgreSQL 版本符合目标 Harbor 版本的要求
  2. 在升级 Harbor 实例前,请先完成实例数据备份。
  3. 升级过程耗时取决于 Harbor 数据大小及当前版本与目标版本之间的版本差距(升级次数)。
  4. 升级过程中实例将不可用。

升级时,您需要按照升级路径依次升级 Operator 版本和实例版本。升级 Operator 不会自动升级实例版本,且升级后的 Operator 不会管理旧的 Harbor 实例,因此您需要及时手动触发实例升级。

升级实例

通过 UI 升级实例

进入 Administrator -> Marketplace -> Operator Hub 页面,切换到目标集群,进入 Alauda Build of Harbor Operator 详情页,点击要升级的实例名称进入实例详情页,点击实例详情页上的升级按钮。

通过 YAML 升级实例

进入 Administrator -> Clusters -> Resources 页面,切换到目标集群,搜索 Harbor 资源类型,编辑要升级的实例资源,修改 spec.version 字段为目标实例版本,保存即可。