---
name: edge-deployment-writer
description: edge_collector 部署手册与上线方案编写规范。用于整理边缘侧、云平台、82/97/94/87 主机、runtime 同步、systemd 服务、回滚和验证步骤时，生成可执行部署文档。
---

# edge_collector 部署文档

## 固定项目约定

- 云平台部署优先使用 `deploy_cloud.sh`。
- 边缘打包使用 `package.sh`。
- 边缘同步使用 `scripts/migrate_edge.sh`。
- 用户明确要求执行 `install_all.sh` 时才执行；不要每次同步都运行。
- 同主机编译部署也要使用 `scripts/migrate_edge.sh`。

## 部署文档结构

```text
目标与范围
目标主机与账号
前置条件
构建步骤
同步/部署步骤
服务重启步骤
验证步骤
回滚方案
风险与注意事项
```

## 必须写清

- 源主机、目标主机、目标目录。
- 是否会覆盖运行配置。
- 是否需要重启 `edge`、`cloud-server` 或独立 agent。
- 是否需要执行 `install_all.sh`。
- 验证命令和预期输出。

## 常用验证

边缘：

```bash
systemctl is-active edge
curl -s http://127.0.0.1/api/status
```

云端：

```bash
systemctl is-active cloud-server
curl -s http://127.0.0.1:<port>/api/health
```

脚本：

```bash
bash -n scripts/<name>.sh
```

## 回滚说明

文档必须说明：

- 上一个 runtime/edge 或发布包位置。
- 如何恢复二进制和 web 资源。
- 哪些配置不能回滚覆盖。
- 回滚后如何重启服务和验证。