---
name: ota-e2e-release
description: OTA升级端到端测试。用于用户说“ota升级端到端测试 新版本号xxx”“去87测试OTA”“发布并上传后去87升级”等场景，默认走 82 打包发布、云平台上传、87 前端OTA验证的一整套流程。
---

# OTA 升级端到端测试

## 触发词

- `ota升级端到端测试`
- `ota升级端到端测试 新版本号 xxx`
- `发布并上传后去87测试OTA`
- `去87测试OTA`

## 固定约定

- 82 主机：`cat@192.168.40.82`
- 82 代码根目录：`/home/cat/code/edge_collector`
- 云平台账号：`admin`
- 目标版本由用户在“新版本号 xxx”里指定
- 如果本次包含云平台前端或 `cloud_server` 代码改动，先使用 `cloud-deploy-verify` 流程部署云平台并验证关键接口

## 执行流程

0. 可选：部署云平台
   - 仅当本次改动影响云平台前端、云端后端、OTA 包上传/查询接口时执行
   - 在仓库根目录运行 `./deploy_cloud.sh`
   - 确认 `cloud-server` 运行，并验证相关云端接口

1. 82 主机发布新版本
   - `cd /home/cat/code/edge_collector`
   - `git pull`
   - `./package.sh --publish --version <version>`

2. 上传到云平台
   - 使用云平台 `admin` 账号登录
   - 上传 `publish/edge_<version>_arm64.tar.gz`
   - 确认版本号、架构、发布状态与产物一致

3. 87 主机 OTA 验证
   - 打开边缘侧前端
   - 查询云平台可用版本，确认 `<version>` 可见
   - 通过前端接口触发 OTA 升级
   - 检查 `/api/ota/status`，确认当前版本已变成 `<version>`

## 失败时优先排查

- 云端字段或页面不生效：先确认已走 `deploy_cloud.sh`，再查 `cloud-server` 状态和云端接口响应
- 87 上看不到版本：先确认 82 包已上传成功，再查 87 的 OTA 配置
- 87 OTA 起不来：先执行 `sudo bash /home/cat/edge/scripts/ota/install_ota_service.sh`
- 前端升级失败：先看后端 OTA 接口返回，再看服务日志