Alauda Hyperflux
  • 简体中文

    • 升级

    本文档提供了升级 Alauda Hyperflux 到新版本的操作指南。

    目录

    标准升级步骤从 v1.2.0 升级到 v1.2.1（特殊情况）第 1 步：备份知识库第 2 步：执行升级第 3 步：恢复知识库

    标准升级步骤

    对于大多数版本升级（v1.2.0 到 v1.2.1 除外），您可以在 ACP 控制台中按照以下步骤操作：

    1. 将新版本的集群插件包上传到 ACP Marketplace。
      上传方式与初次安装相同。上传完成后，等待约 10–15 分钟，平台会自动同步新版本信息。
    2. 确认 Marketplace 中已显示新版本。
      进入 管理员 / Marketplace / 上架软件包。
      切换到 集群插件 标签页，确认 Hyperflux 插件已显示新版本号。
    3. 在集群上执行升级操作。
      进入 管理员 / 集群 / 集群。
      找到已安装 Hyperflux 插件的集群，集群条目会显示升级图标。
      点击进入集群详情，切换到 功能 标签页。
      在 Hyperflux 插件卡片上，点击 升级 按钮并确认操作。
    4. 验证升级结果。
      升级完成后，确认 功能 标签页中的版本号已更新。
      通过插件状态监控或日志确认插件正常运行。

    从 v1.2.0 升级到 v1.2.1（特殊情况）

    重要提示： 从 v1.2.0 升级到 v1.2.1 会导致知识库重新初始化。您必须手动备份并恢复数据库，以防止数据丢失。

    第 1 步：备份知识库

    升级前，执行以下命令：

    # 获取 PostgreSQL Pod 名称（如果使用内置数据库）
kubectl -n cpaas-system get pod | grep postgre-vec

# 导出数据库到文件
kubectl -n cpaas-system exec -it <postgre-vec-xxx> -- pg_dump -U postgres -d <your-database-name> -F c -f /tmp/hyperflux_backup.dump

# 将导出文件复制到本地机器
kubectl -n cpaas-system cp <postgre-vec-xxx>:/tmp/hyperflux_backup.dump ./hyperflux_backup.dump

    第 2 步：执行升级

    按照上述 标准升级步骤，通过 ACP 控制台升级插件版本。

    第 3 步：恢复知识库

    升级完成后，恢复数据：

    # 获取新的 PostgreSQL Pod 名称
kubectl -n cpaas-system get pod | grep postgre-vec

# 将备份文件复制回 Pod
kubectl -n cpaas-system cp ./hyperflux_backup.dump <postgre-vec-xxx>:/tmp/hyperflux_backup.dump

# 从备份文件恢复数据库
kubectl -n cpaas-system exec -it <postgre-vec-xxx> -- pg_restore -U postgres -d <your-database-name> /tmp/hyperflux_backup.dump

# （可选）如果数据库或集合名称有变更，更新配置
kubectl -n cpaas-system edit configmap smart-doc-config
# 根据需要更新 `PG_CONN_DB` 和 `PG_COLLECTION_NAME` 字段。

    等待 Alauda Hyperflux Pod 重启，确认知识库已成功恢复。