# OPS 验收部署说明

## 1. 目标

本文定义 OPS 在 Linux/麒麟验收环境中的部署、迁移、回滚和烟测步骤。受项目规则约束，本文不提供 Linux 命令示例，只提供执行顺序、配置项和验收检查点。

## 2. 部署前确认

| 项目 | 必填内容 |
| --- | --- |
| 操作系统 | 发行版、版本、CPU 架构、补丁状态 |
| 网络区域 | Web 访问区、后端 API 区、数据库区、采集区 |
| 域名或访问地址 | 前端访问地址、API 地址、回调地址 |
| PostgreSQL | 版本、地址、端口、库名、账号来源 |
| 时序数据库 | 产品、版本、部署形态、保留策略 |
| 通知渠道 | 站内消息、短信、邮件测试账号和发送限制 |
| 采集入口 | SNMP、Trap、Syslog、URL/API 探测网络策略 |
| 备份目录 | 数据库备份、时序库备份、配置备份、日志归档 |

真实密码、Token、短信密钥和邮件密码只能写入现场配置，不进入仓库。

## 3. 部署顺序

| 顺序 | 步骤 | 通过标准 |
| --- | --- | --- |
| 1 | 准备运行用户、目录、端口和防火墙策略 | 服务账号权限最小化，端口策略已审批。 |
| 2 | 部署 PostgreSQL 并初始化数据库 | 可连接，字符集和时区正确。 |
| 3 | 部署选定时序数据库 | 可写入样本，可按时间范围查询。 |
| 4 | 放置后端配置文件 | 配置中无明文提交凭据，凭据来自现场安全渠道。 |
| 5 | 执行数据库迁移 | 表结构与当前版本匹配，迁移日志保留。 |
| 6 | 启动后端服务 | 健康检查成功，日志可查看。 |
| 7 | 部署前端静态包 | 页面可访问，API 地址指向验收后端。 |
| 8 | 配置采集和通知通道 | 采集任务、短信、邮件测试通过。 |
| 9 | 执行烟测 | 登录、资源、告警、通知、工单、报表主路径通过。 |

## 4. 迁移要求

| 迁移对象 | 要求 |
| --- | --- |
| PostgreSQL 表结构 | 每个迁移文件必须可追踪版本、执行时间和执行结果。 |
| 初始化字典 | 告警级别、资源类型、通知渠道、权限码必须可重复执行。 |
| 时序库 schema | 指标命名、标签、保留策略必须与 `docs/首期数据模型与状态机.md` 一致。 |
| 样例数据 | 验收样例必须可清理，不与生产数据混淆。 |

迁移失败时不得继续执行后续部署步骤。

## 5. 回滚要求

| 对象 | 回滚策略 |
| --- | --- |
| 后端服务 | 保留上一版本二进制或镜像，配置兼容性检查通过后回退。 |
| 前端静态包 | 保留上一版本静态文件，切回后清理浏览器缓存影响。 |
| PostgreSQL | 迁移前备份，迁移失败按备份恢复或执行成对回滚脚本。 |
| 时序数据库 | 变更保留策略、降采样规则前备份元数据和关键样本。 |
| 配置文件 | 每次变更前保留上一份配置，敏感字段仍按现场安全要求保存。 |

## 6. 烟测清单

| 编号 | 检查项 | 通过标准 |
| --- | --- | --- |
| S-001 | 登录和权限 | 管理员可登录，普通用户不能访问无权限菜单。 |
| S-002 | 首页总览 | 显示资源健康、告警趋势、待处理告警，数据来自后端。 |
| S-003 | 资源列表 | 可查看主机、H3C/华三网络设备、数据库、URL/API 样例资源。 |
| S-004 | 采集状态 | 最近采集时间、失败原因、数据过期状态可见。 |
| S-005 | 原始事件 | Trap/Syslog 样例可入库，未解析事件可见。 |
| S-006 | 告警中心 | 可触发、确认、忽略、恢复和派单。 |
| S-007 | 通知记录 | 站内消息、短信、邮件记录可查，失败原因可见。 |
| S-008 | 工单管理 | 可创建、接单、转交、挂起、重启、关闭。 |
| S-009 | 报表大屏 | 基础报表可生成，大屏组件局部失败可降级。 |
| S-010 | 审计日志 | 权限变更、告警处理、工单流转可按 `traceId` 查询。 |

## 7. 验收输出

- 部署环境确认表。
- 配置项脱敏清单。
- 数据库迁移记录。
- 后端和前端版本号。
- 烟测截图、接口响应和日志。
- 回滚演练记录或回滚步骤确认单。

