文档中心

升级一体机软件

最近更新时间：2023.07.26 11:44:25

首次发布时间：2023.02.09 10:25:42

边缘智能会对一体机的软件按需升级。当有新版本的软件可以使用时，您将会在项目一体机列表中收到升级推送。本文介绍了如何升级一体机的软件。

升级说明

当一体机有可用的新版本软件时，您可以将一体机的软件升级至最新版本。

注意

软件升级后不支持回滚。请谨慎操作。
升级过程会导致一体机离线 1~2 分钟。

前提条件

您已经为项目绑定了一体机。相关操作，请参见绑定一体机。
一体机必须处于在线状态，并且能够访问外部网络。

操作步骤

登录边缘智能控制台。
在左侧导航栏顶部的 我的项目 区域，选择您的项目。
在左侧导航栏，单击 一体机。
在项目一体机列表，单击版本列的升级图标。
说明
只有当一体机有可用的新软件版本时，才会显示升级图标。
在 升级新版本 对话框，确认最新版本的 更新日志 后，执行升级操作。
仅支持升级到最新版本。升级方式有以下两种：自动升级、手动升级。

自动升级

您只需根据界面提示操作即可。

单击 升级该版本。
在弹出的对话框中，单击升级。

您提交升级任务后，一体机的状态将变为 升级中。当升级完成后，一体机的状态会变为在线。

手动升级

部分老版本软件不支持自动升级。这种情况下，您会在控制台收到需要手动升级的提示。
手动升级需要您远程登录一体机，使用终端界面进行操作。关于远程登录一体机的步骤，请参见访问一体机。
进入终端页面后，执行以下步骤：

安装 Helm。
参考 Helm 官方文档，在一体机上安装 Helm。
如果一体机上已经安装了 Helm，您可以跳过该步骤。
下载 chart。
您需要将以下命令中的<Version>替换为最新的软件版本号。
最新的软件版本号可以在控制台上获取。版本号格式为vX.X.X（如v0.5.2）。
```
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
helm pull oci://vei-public-cn-beijing.cr.volces.com/ota/vei-aiot-edge --version <Version>
```
解压缩下载的文件。
```
tar xvf vei-aiot-edge-<Version>.tgz
```
修改配置文件（values.yaml）。
```
vi vei-aiot-edge/values.yaml
```
需要修改的代码片段如下：
```
global:
  registry:
    host: r-veen.volces.com/vei
    imagePullSecrets:
    - name: volces
  node:
    name: <NodeName>
    sn: <SN>
  version: v0.5.2
```
您需要修改其中的以下值：
- <SN>：替换为一体机的序列号。您可以在控制台获取<SN>的值；或者运行以下命令获取<SN>的值：
```
helm get values vei-aiot-edge | grep sn
```
- <NodeName>：替换为一体机的型号名称。您可以运行以下命令获取<NodeName>的值：
```
k3s kubectl get node
```
修改完成后，保存配置文件并退出。
卸载旧版本的软件。
```
helm uninstall vei-aiot-edge
```

安装新版本软件。

cd vei-aiot-edge
helm install vei-aiot-edge -f values.yaml . -n default

升级说明

前提条件

操作步骤

自动升级

手动升级