---
name: cloud-deploy-verify
description: 云平台部署与验证流程。用于用户说“部署云平台”“用 deploy_cloud.sh 部署”“部署到云服务器”“云端部署并验证”“发布云平台前端/后端”等场景，默认使用 deploy_cloud.sh 部署到 ubuntu@119.45.4.75 并验证 cloud-server 与关键接口。
---

# 云平台部署与验证

## 何时使用

- 部署云平台
- 用 `deploy_cloud.sh` 部署
- 部署到云服务器
- 云端部署并验证
- 发布云平台前端或后端

## 固定约定

- 部署脚本：`./deploy_cloud.sh`
- 默认目标：`ubuntu@119.45.4.75`
- 默认云平台地址：`http://119.45.4.75`
- systemd 服务：`cloud-server`
- 默认不要加 `--init`；只有用户明确要求初始化、清库、重置云端状态时才使用 `--init`

## 执行流程

1. 在仓库根目录执行部署：

```bash
./deploy_cloud.sh
```

2. 确认脚本完成并输出：

```text
[OK] cloud-server is running
```

3. 验证远端服务状态：

```bash
ssh ubuntu@119.45.4.75 'sudo systemctl is-active cloud-server'
```

4. 验证云平台登录与关键接口：
   - 登录接口：`POST http://119.45.4.75/api/auth/login`
   - OTA 包列表：`GET http://119.45.4.75/api/admin/edge-upgrades/packages`
   - 如果本次改动涉及 OTA 包字段，确认响应包含预期字段，例如 `release_type`、`description`、`release_notes`

5. 如果本次改动影响边缘侧 OTA 查询，再验证边缘侧代理透传：
   - 先登录边缘侧，例如 87：`POST http://192.168.40.87/api/login`
   - 再调用：`POST http://192.168.40.87/api/ota/cloud/packages`
   - 确认云端字段能透传到边缘侧响应

## 注意

- `deploy_cloud.sh` 会构建云端前端和 `cloud_server`，同步 `runtime/cloud_server/`，迁移/校验 Mosquitto Dynamic Security，并重启 `cloud-server`。
- 不要手写云端 rsync/scp/systemctl 流程，优先使用 `deploy_cloud.sh`。
- 如果部署失败，先看脚本输出；服务启动失败再查：

```bash
ssh ubuntu@119.45.4.75 'sudo journalctl -u cloud-server --since "5 min ago" --no-pager'
```