Alauda Hyperflux
  • 简体中文

    • 升级

    本文档将提供升级 Alauda Hyperflux 到新版本的操作说明。

    目录

    升级准备

    升级前，请务必备份现有的知识库和配置数据，以防升级过程中发生数据丢失。

    注意： 从 v1.2.0 升级到 v1.2.1 可能导致知识库被重新初始化。请确保在升级前备份数据库转储文件。

    备份步骤：

    # 获取 PostgreSQL pod 名称（如果使用内置 PG 数据库）
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

    升级步骤

    升级 Alauda Hyperflux 的流程与在 ACP 中安装集群插件相同：

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

    升级后操作

    如有需要，恢复知识库：

    # 获取 PostgreSQL pod 名称（如果使用内置 PG 数据库）
kubectl -n cpaas-system get pod | grep postgre-vec
# 将备份的转储文件复制到 PostgreSQL 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
# 如有需要，配置 Alauda Hyperflux 使用恢复后的数据库
kubectl -n cpaas-system edit configmap smart-doc-config
# 修改字段 `PG_CONN_DB`、`PG_COLLECTION_NAME` 以匹配恢复的数据库并保存。

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