研发平台部署清单要能支撑逐项核验，通常覆盖八类信息：部署范围与拓扑、环境与资源、安装与配置、数据与迁移、集成与接口、安全与权限、验证与验收、回退与运维交接。每条检查项写清通过标准、证据、负责人和检查时点，影响上线的项标为阻断项。本文按部署准备、安装实施、上线验收三个阶段组织清单，业务配置与治理内容另立文档。
要点总览（TL;DR）
- 研发平台部署清单通常覆盖八类信息：部署范围与拓扑、环境与资源、安装与配置、数据与迁移、集成与接口、安全与权限、验证与验收、回退与运维交接。
- 每条检查项写清检查项名称、通过标准、证据材料、负责人、检查时点和阻断标记六个字段，才能事后判断是否真正完成。
- 影响上线的项标为阻断项，例如备份未完成、安全策略未生效、核心流程验证未通过、许可文件缺失、迁移校验存在未说明差异。
- 整体完成条件建议定为三条同时满足：阻断项全部通过、每项通过都有证据材料、各阶段责任人签字。
- 清单只覆盖部署落地，业务配置与治理另立文档；部署完成后连同证据材料交接运维并归档，后续变更在原清单上追加记录。
谁在什么时点使用这份部署清单
这份清单由部署负责人主责维护，运维、安全和业务验收方按各自职责勾选与签字。它从部署准备阶段开始填写，安装实施阶段逐项记录，上线验收阶段完成签字冻结。清单只覆盖部署落地，业务功能的配置与治理归入另一份文档，避免两类信息混在一张表里。
三个阶段的填写重点不同：准备阶段确认条件是否具备，安装阶段记录实际配置值，验收阶段确认结果是否达标。每个阶段结束时由部署负责人检查该阶段条目是否全部有结论，再进入下一阶段。
| 角色 | 部署准备 | 安装实施 | 上线验收 |
|---|---|---|---|
| 部署负责人 | 填写范围、拓扑、资源与窗口，组织评审 | 核对安装参数与配置留档，记录变更 | 汇总验收结果，确认阻断项清零 |
| 运维 | 确认服务器、存储、网络端口与监控接入条件 | 执行安装、配置组件、留存参数快照 | 确认备份、回退预案与交接内容 |
| 安全 | 确认访问入口、防火墙策略与账号规范 | 核查权限划分、证书与密钥保管 | 确认审计日志与初始账号清理结果 |
| 业务验收方 | 确认验收范围与核心流程清单 | 参与联调与关键流程试跑 | 签署功能验证结论 |
部署准备阶段要核对哪些信息
准备阶段的目标是确认安装条件齐备，避免带着缺失信息进入安装。以下检查表可直接作为模板使用，通过标准一栏要写成可判断的结论，证据一栏写明材料名称或存放位置。
| 检查项 | 通过标准 | 证据 | 负责人 | 检查时点 | 阻断 |
|---|---|---|---|---|---|
| 部署范围与拓扑 | 明确单机或集群、节点数量、网络分区，并经评审确认 | 拓扑图与评审记录 | 部署负责人 | 准备阶段启动时 | 是 |
| 服务器规格 | CPU、内存、磁盘满足方案要求，资源已分配到位 | 资源分配单 | 运维 | 安装前一周 | 是 |
| 操作系统与数据库 | 版本在方案支持范围内，补丁状态已记录 | 环境信息表 | 运维 | 安装前一周 | 是 |
| 存储与网络端口 | 存储容量满足规划，所需端口已开通并验证连通 | 端口开通记录、连通性测试结果 | 运维 | 安装前三天 | 是 |
| 平台版本与依赖组件 | 平台版本、依赖组件版本已锁定，与方案一致 | 版本清单 | 部署负责人 | 安装前 | 是 |
| 授权与许可文件 | 许可文件已到位，授权范围与部署规模匹配 | 许可文件与授权记录 | 部署负责人 | 安装前 | 是 |
| 实施人员与分工 | 实施人员名单、联系方式与职责已确认 | 人员分工表 | 部署负责人 | 准备阶段 | 否 |
| 变更窗口与停机安排 | 窗口时间已审批，相关方已知悉停机范围 | 变更单 | 运维 | 安装前 | 是 |
版本与许可的具体口径以项目方案和实际授权文件为准，清单中记录的是本项目锁定的版本号与许可范围，便于安装时对照。资源规格若在实施中调整，需要同步更新拓扑图与资源分配单，保持清单与现场一致。
安装与配置阶段要核对哪些信息
安装阶段的核心是记录实际配置值，而不是只勾选“已完成”。每项配置都要写明取值和留档位置，后续排障和交接都依赖这份记录。
| 检查项 | 通过标准 | 留档位置 | 负责人 | 阻断 |
|---|---|---|---|---|
| 安装路径 | 各节点安装路径一致并记录 | 配置快照文档 | 运维 | 否 |
| 服务端口 | 端口分配表与实际监听一致 | 端口分配表 | 运维 | 是 |
| 域名与证书 | 域名解析生效，证书已部署且有效期已记录 | 证书信息登记表 | 运维 | 是 |
| 管理员账号 | 初始管理员账号已创建，初始密码通过约定渠道交接 | 账号交接记录 | 部署负责人 | 是 |
| 数据库连接 | 连接串、账号权限与连接池参数已记录并测试通过 | 配置快照文档 | 运维 | 是 |
| 缓存与文件存储 | 缓存服务与文件存储路径可用，容量已确认 | 配置快照文档 | 运维 | 是 |
| 日志路径 | 各服务日志路径统一，日志级别符合要求 | 配置快照文档 | 运维 | 否 |
| 配置变更记录 | 安装期间的每次参数调整都有时间、内容与操作人 | 变更记录 | 部署负责人 | 否 |
配置快照建议在安装完成后立即导出一次，作为基线版本保存。后续任何参数调整都在变更记录中追加，并注明对应的检查项编号，使清单与系统状态可以相互追溯。
数据迁移与集成对接要核对哪些信息
迁移与集成是部署中最容易出现“看起来完成、实际未验证”的环节，检查项必须写明校验方法和联调证据。迁移范围要具体到对象和字段，接口要具体到方向和认证方式。
| 检查项 | 通过标准 | 证据 | 负责人 | 阻断 |
|---|---|---|---|---|
| 迁移范围 | 迁移对象、数据量与时间范围已确认并签字 | 迁移范围确认单 | 部署负责人 | 是 |
| 字段映射 | 源字段与目标字段映射表完整，无未处理字段 | 字段映射表 | 实施人员 | 是 |
| 迁移批次 | 批次划分、每批时间与执行结果已记录 | 批次执行记录 | 实施人员 | 否 |
| 数据校验 | 记录数、关键字段抽样比对结果一致，差异已说明 | 校验报告 | 实施人员 | 是 |
| 对接系统清单 | 对接系统、接口用途与责任人已列明 | 接口清单 | 部署负责人 | 是 |
| 认证方式与接口方向 | 认证方式、调用方向、回调地址已配置并测试 | 接口配置记录 | 实施人员 | 是 |
| 联调记录 | 联调时间、参与方、用例与结果均有记录 | 联调报告 | 实施人员 | 是 |
数据校验的抽样比例和比对字段要在迁移前确定，写进校验方案，避免事后凭印象判断。集成接口的回调地址属于易错项，配置后应实际触发一次回调并留存日志。
安全、权限与合规要核对哪些信息
安全相关检查项适合在上线前集中核验，上线后补做往往涉及停机或重新配置。以下条目按网络、账号、审计、证书四类组织。
| 检查项 | 通过标准 | 证据 | 负责人 | 阻断 |
|---|---|---|---|---|
| 访问入口 | 访问入口清单明确，外网暴露范围经审批 | 访问入口清单与审批记录 | 安全 | 是 |
| 防火墙策略 | 策略已生效，仅开放清单内端口 | 策略配置截图或导出 | 安全 | 是 |
| 角色划分 | 角色与职责对应关系已确认，按最小权限配置 | 角色权限矩阵 | 安全 | 是 |
| 初始账号清理 | 默认账号已禁用或改密，测试账号已清理 | 账号核查记录 | 运维 | 是 |
| 操作与登录日志 | 日志已开启，留存周期符合要求 | 日志配置记录 | 运维 | 是 |
| 证书有效期 | 证书有效期已登记，到期提醒已设置 | 证书登记表 | 运维 | 否 |
| 密钥保管 | 密钥保管责任人与存放方式已明确 | 密钥保管登记 | 安全 | 是 |
安全策略的生效状态要用配置导出或截图作为证据，口头确认不足以支撑验收。日志留存周期按企业制度确定，清单中记录的是本项目采用的周期值。
上线验收与回退要核对哪些信息
验收阶段要给出明确的通过口径，让上线决策有据可依。功能验证按核心流程逐条走查，性能验证写明并发数和响应时间的测量方法，回退预案要包含触发条件。
| 检查项 | 通过标准 | 证据 | 负责人 | 阻断 |
|---|---|---|---|---|
| 核心流程走查 | 清单内核心流程全部走通，结果逐条记录 | 走查记录 | 业务验收方 | 是 |
| 性能与容量 | 按约定并发数测试，响应时间在目标范围内 | 测试报告 | 运维 | 是 |
| 备份完成确认 | 上线前完成一次全量备份并验证可恢复 | 备份记录与恢复验证结果 | 运维 | 是 |
| 回退步骤 | 回退步骤已编写并演练，所需时间已评估 | 回退预案 | 部署负责人 | 是 |
| 回退触发条件 | 触发条件量化，决策人已明确 | 回退预案 | 部署负责人 | 是 |
| 验收签字 | 业务方与运维方均完成签字 | 验收记录表 | 业务验收方、运维 | 是 |
回退触发条件建议写成可判断的情形，例如核心流程连续失败次数、关键接口错误率超过阈值，并指定谁有权决定回退。备份只记录“已完成”不够，恢复验证结果才是可核验的证据。
哪些是阻断项，完成条件怎么定
阻断项的判定规则是：该项未通过会直接导致上线后出现数据丢失、安全暴露或核心业务不可用。按此规则，备份未完成、安全策略未生效、核心流程验证未通过、许可文件缺失、迁移校验存在未说明差异，都应标为阻断项。其余影响体验或后续维护的条目列为一般项，可以带条件上线并约定整改期限。
整体完成条件建议定为三条同时满足：阻断项全部通过；每项通过都有对应证据材料；各阶段责任人在清单上签字。一般项未完成的，需在清单中写明整改责任人与完成时间，并由部署负责人确认风险可接受。
清单条目本身也要可核验。一条合格的检查项应包含检查项名称、通过标准、证据材料、负责人、检查时点和阻断标记六个字段，缺任一项都难以事后判断是否真正完成。把“建议加强监控”这类表述改写成“监控项清单已配置并收到测试告警”，才具备勾选条件。
运维交接与清单归档怎么做
部署完成后，清单连同证据材料一并交接给运维团队，形成可追溯的部署记录。交接内容至少包括：管理员账号与密码交接方式、配置快照基线、监控项清单、告警接收人、值班安排和回退预案。
交接以确认单形式完成，由部署负责人与运维负责人双方签字，注明交接日期和清单版本号。归档位置建议与项目文档放在同一处，按项目名称和部署日期命名，便于后续检索。
清单在部署结束后进入维护状态。后续发生配置变更、版本升级或节点扩容时，由运维负责人在原清单上追加变更记录并更新对应条目，保持清单与系统实际状态一致。涉及部署方式的调整，例如从单机改为集群，应重新走一遍准备与验收检查项，而不是只改一行记录。
在部署检查项的执行跟踪上，ONES 支持私有部署和公有云部署，私有化部署采用 K3s 容器化部署，支持对接 LDAP 等企业内部系统，高可用集群部署方式可实现故障转移与数据容灾。部署团队可以把各阶段检查项作为工作项管理，将证据材料与签字记录关联到对应条目和文档状态，使勾选、证据与交接记录集中在一处，便于验收时逐项核对和事后追溯。具体版本、许可与兼容性以实际项目方案为准。
常见问题
部署清单和业务配置清单可以合并成一份吗？
可以放在同一套文档体系里，但建议分成两份维护。部署清单回答的是环境是否就绪、参数是否记录、安全策略是否生效、验收是否通过，检查对象是部署过程和系统状态；业务配置清单回答的是项目模板、字段、工作流、权限角色等业务规则如何设置，检查对象是配置内容本身。
合并后容易出现两类问题：部署验收时被大量业务配置条目拖慢节奏，业务配置调整时又要改动已经签字的部署记录。分开维护、互相引用条目编号，既能保持追溯，也不影响各自的冻结时点。
部署过程中资源规格或拓扑发生调整，清单怎么处理？
调整后要同步更新拓扑图、资源分配单和对应检查项的实际值，并在变更记录中写明调整时间、内容、操作人和影响范围。如果调整涉及部署方式变化，例如从单机改为集群，建议重新走一遍准备阶段和验收阶段的相关检查项，而不是只改一行记录。
已经签字的阶段如果受影响，需要由部署负责人确认是否重新确认。清单的价值在于反映系统实际状态，现场与记录不一致时，以更新后的记录为准并保留变更痕迹。
一般项没完成，能不能先上线？
可以带条件上线，前提是阻断项全部通过，且一般项的未完成情况已在清单中写明整改责任人与完成时间，并由部署负责人确认风险可接受。一般项通常影响使用体验或后续维护效率，例如日志级别未按规范调整、部分监控项尚未接入。
带条件上线后，建议在约定时间内复核整改结果并更新清单状态。若整改迟迟未完成，需要重新评估是否升级为阻断项，避免遗留问题累积到下一次变更。
验收签字应该由谁签，签在什么材料上？
功能验证结论由业务验收方签署，备份、回退预案与交接内容由运维方确认，整体清单由部署负责人汇总确认阻断项清零。签字落在验收记录表和交接确认单上，并注明清单版本号与日期。
签字前要确认每项通过都有对应证据材料，例如走查记录、测试报告、配置导出、备份恢复验证结果。只有勾选没有证据的条目，事后难以判断是否真正完成，也不利于交接后的追溯。
部署完成后清单还需要维护吗？
需要。清单在部署结束后进入维护状态，由运维负责人在原清单上追加变更记录并更新对应条目，覆盖配置调整、版本升级、节点扩容等情形。这样清单始终反映系统实际状态，后续排障和审计可以直接查阅。
归档位置建议与项目文档放在同一处，按项目名称和部署日期命名。交接时至少移交管理员账号与密码交接方式、配置快照基线、监控项清单、告警接收人、值班安排和回退预案。
