跳转至

管理端版本升级指南

本指南适用于已安装云空间管理端环境的日常版本升级与补丁更新。

一、 升级准备

  1. 获取组件包： 获取最新版本的 astute-k3s-deploy*.bin、astute-xspace-image*.bin 以及 astute-xspace-deploy*.bin 升级包。

  2. 上传文件：astute-k3s-deploy*.bin 包上传至所有节点，astute-xspace-image*.bin 和 astute-xspace-deploy*.bin 包仅需要上传至主节点。

二、 升级执行流程

升级过程极大简化了交互步骤，通常只需确认默认配置即可。

若某个组件包的版本号与当前环境一致，则可以跳过该组件的执行步骤。

2.1 容器集群升级 (所有节点)

操作顺序：先升级所有 从节点，最后升级 主节点。

  • 从节点升级：在每台从节点执行以下命令，过程中一路按 回车 (Enter) 确认默认项即可。
[root@host152 ~]$ bash ./astute-k3s-deploy-*.bin
  • 主节点升级：在主节点执行以下命令，同样一路按 回车 (Enter) 确认默认项即可。
[root@host151 ~]$ bash ./astute-k3s-deploy-*.bin

2.2 准备镜像与部署组件 (仅主节点)

在主节点完成集群升级并确认集群状态正常后，依次执行以下包：

  • 镜像更新：
[xspace@host151 ~]$ sudo bash ./astute-xspace-image-*.bin
  • 组件部署：
[xspace@host151 ~]$ sudo bash ./astute-xspace-deploy-*.bin

三、 重要特性：安装可重入性

在升级过程中，如果因为网络闪断、ssh连接断开、管理节点虚拟机关机重启等原因导致安装中断：

  • 无需惊慌：系统支持可重入执行。
  • 处理方法：只需 重新执行 该阶段的 .bin 文件即可。脚本会自动识别已完成的进度，从中断处继续安装，不会损坏现有数据。

四、 升级后配置恢复 (关键)

由于升级过程中部分系统组件会重新加载默认配置，以下自定义设置可能会被重置，请在部署完成后务必检查并手动恢复：

  • Nginx 配置 (ConfigMap)：

    • 检查 nginx-conf 是否丢失了之前配置的公网端口的允许列表和自定义内网端口。
    • 如有丢失，请参考部署手册中的 网络配置 章节重新配置。

  • Nacos 中间件配置：

    • 如果您之前在 Nacos 控制台中修改过特定微服务的配置文件，请检查这些配置是否被还原为默认值。
    • 短信认证服务相关的内置保存在 Nacos 中，如果已开启短信认证，升级后需要重新配置开启。

五、 结果验证

升级完成后，参考 完成验证 进行升级后系统的运行状态检查。

执行验证命令：

[xspace@host151 ~]$ sudo /opt/installation/scripts/env_check.sh 0

判定标准：观察脚本输出结果。

  • 成功：所有检查项均为 绿色 字体，无任何 红色 错误提示。
  • 异常：若出现红色字体，请根据提示的组件名称检查 Pod 日志。