研发平台私有化部署前的环境准备清单

私有化部署前的环境准备，核心是把“能不能装、装完能不能用、出问题能不能查”三件事在开工前逐项确认。这份清单按范围与责任确认、基础设施与网络、依赖组件与账号、安全与合规、回退与验收准备五个阶段组织，每项写明通过标准、证据和负责人，任一阻断项未通过就不进入安装环节。

要点总览（TL;DR）

• 清单按范围与责任确认、基础设施与网络、依赖组件与账号、安全与回退、联合验收五个阶段组织，方案评审后、安装前、上线前三个时点分别使用。
• 每项检查写明通过标准、证据类型和唯一主责人，结论只取通过、不通过、不适用三态，不适用项需说明理由并由部署负责人确认。
• 服务器规格不达标、关键端口不通、数据库账号不可用、证书缺失、无回退方案属于阻断项，任一未通过不启动安装。
• 联合验收给出通过、有条件通过、不通过三种结论，条件项登记责任人和完成时限，上线前复核。
• 把检查项建成工作项并挂接证据附件，联合验收时按工作项状态汇总结论，未关闭的阻断项直接对应不通过。

谁在什么时点使用这份清单

这份清单面向部署负责人、运维、安全、网络、平台管理员和业务方代表，在三个时点分别使用：方案评审后做范围确认，安装前做环境就绪检查，上线前做验收与回退确认。每个检查项给出“通过、不通过、不适用”三种结论，阻断项不通过则暂停推进，直到补齐证据或调整方案。

清单本身需要维护责任人，通常由部署负责人担任，版本记录写明修订日期、修订内容和确认人。每次部署前基于上一版清单复制一份新版本，避免沿用过期结论。

角色	检查时点	负责章节	判定权限
部署负责人	方案评审后、安装前、上线前	全部章节，汇总结论	判定阻断项，签署验收结论
运维	安装前	服务器、存储、网络、时间同步	判定基础设施项通过与否
网络	安装前	端口、负载均衡、域名解析、跨网段策略	判定网络连通性项
安全	安装前、上线前	安全基线、证书、访问控制	判定安全项，可否决上线
平台管理员	安装前、上线前	依赖组件、账号、安装介质	判定组件与账号可用性
业务方代表	上线前	验收与回退确认	确认业务可用性结论

第一阶段：部署范围与责任确认

动服务器之前先把部署边界、版本和责任定下来，避免环境准备做偏。这一阶段的产出是范围与责任确认表，包含检查项、通过标准、证据和负责人。

部署形态需要明确是单机、集群、容器化还是混合部署，并据此确定最低节点数量。不同形态对节点数、存储和网络的要求不同，形态未定就采购或分配资源，容易返工。平台版本与各组件版本要形成对应清单，写明版本号及相互兼容关系，避免安装时才发现版本不匹配。

部署范围边界要写清本期上线哪些模块、哪些延后，业务配置类工作另行安排，不混入环境准备。角色与责任人至少覆盖部署负责人、运维、DBA、网络、安全、业务验收人，每项只有一个主责人。交付物包括部署方案、网络拓扑图、环境信息表和变更单，作为后续阶段的输入。

• 部署形态与最低节点数量：写明形态及节点数，附方案截图或评审记录。
• 版本清单：平台版本、组件版本及对应关系，附版本确认邮件或文档。
• 范围边界：本期上线模块清单与延后项，附评审结论。
• 责任人清单：角色、姓名、联系方式，附确认记录。
• 交付物齐备：部署方案、拓扑图、环境信息表、变更单。

第二阶段：服务器、存储与网络环境检查

这一阶段逐项核对硬件、操作系统、存储容量和网络连通性，确保安装介质能落地、服务能互通。服务器规格按部署形态分别列出CPU核数、内存、系统盘与数据盘容量，通过标准是实际配置不低于方案要求，证据为配置截图或命令输出。

操作系统与内核版本要匹配平台要求，时区、字符集、主机名和hosts解析统一设置。存储方面确认数据盘挂载点、剩余空间、IO能力和备份盘或快照能力，剩余空间按方案预留比例核对。网络部分明确内外网划分、端口开放清单、负载均衡与域名解析、跨网段访问策略，每个端口标注用途、源地址和目的地址。

时间同步容易被忽略，需确认NTP源可用，各节点时间偏差在允许范围内，证据为时间同步状态输出。

检查项	通过标准	证据	负责人
服务器规格	CPU、内存、磁盘不低于方案要求	配置截图或命令输出	运维
操作系统与内核	版本在兼容清单内，时区字符集统一	系统信息输出	运维
存储容量与IO	数据盘剩余空间达标，IO满足要求	磁盘使用与性能测试记录	运维
端口连通性	端口清单内各端口可连通	连通性测试结果	网络
负载均衡与域名	解析正确，转发策略生效	解析记录与配置导出	网络
时间同步	各节点偏差在允许范围内	时间同步状态输出	运维

第三阶段：依赖组件、账号与证书准备

平台运行依赖的中间件、外部服务、账号权限和证书要在安装前备齐，减少安装中断。依赖组件包括数据库、缓存、消息队列、对象存储等，需明确是复用现有实例还是新建，复用时要确认版本兼容和资源余量，新建时要确认部署位置和责任人。

账号与权限方面，操作系统账号、数据库账号、服务账号逐一登记，按最小权限配置，证据为权限配置导出。证书与域名要确认HTTPS证书、有效期、签发链完整，域名备案或内网域名规划到位，证书到期日写入表格便于后续跟踪。

外部集成依赖如统一认证、邮件、短信、代码仓库等，需准备对接参数并验证连通性。安装介质与许可证文件要确认获取渠道、校验和存放位置，校验不通过的不进入安装。

• 依赖组件清单：组件名、版本、地址、复用或新建、责任人。
• 账号清单：账号类型、归属、权限范围、配置证据。
• 证书清单：域名、签发机构、有效期、签发链完整性。
• 集成参数：对接系统、参数、连通性测试结果。
• 安装介质：文件名、校验和、存放位置、许可证文件。

第四阶段：安全、备份与回退准备

部署前把安全基线、数据备份和回退路径定好，保证出问题时能退回可用状态。安全基线包括防火墙策略、访问控制、漏洞扫描与基线加固要求，通过标准是扫描无高危项或高危项已有处置记录，证据为扫描报告和加固记录。

数据备份要明确备份对象、备份频率、存放位置和恢复演练安排，恢复演练至少验证一次可恢复性。回退方案写明回退触发条件、回退步骤、所需介质和时间窗口，触发条件要具体，例如安装失败且无法在约定时间内修复。变更与审批包括变更单、审批人、部署窗口和通知范围。日志与监控确认日志留存位置、监控接入方式和告警接收人。

检查项	通过标准	证据	负责人
安全基线	无高危漏洞或已处置	扫描报告、加固记录	安全
数据备份	备份完成且恢复演练通过	备份记录、演练记录	运维
回退方案	触发条件、步骤、介质、窗口齐备	回退方案文档	部署负责人
变更审批	变更单已审批，窗口已通知	变更单编号	部署负责人
日志与监控	日志留存位置确定，告警接收人明确	配置导出	运维

第五阶段：安装前联合验收与阻断项判定

把前四阶段的检查结果汇总成一次联合确认，明确哪些项阻断安装、哪些项可带条件通过。参与方逐项签字或系统记录，部署负责人汇总结论。

阻断项清单至少包括：服务器不满足最低规格、关键端口不通、数据库账号不可用、证书缺失、无回退方案。这些项任一不通过，安装不启动。可带条件通过项如非关键监控未接入、部分集成延后，需登记责任人和完成时限，并在上线前复核。

验收结论分通过、有条件通过、不通过三种，对应动作分别是启动安装、按条件项限期补齐后启动、整改后重新验收。安装启动的前置条件是全部阻断项通过且条件项已登记，启动确认人由部署负责人签署。

通过标准、证据与负责人如何落到一张表

清单表格的字段设计决定每项检查能否判断是否完成。建议字段为：检查项、通过标准、证据类型、负责人、检查时点、结论、备注。通过标准要可观察、可验证，例如“端口可连通”“版本号匹配”“备份可恢复”，避免写成“已准备”“已确认”这类无法核验的表述。

证据类型包括截图、命令输出、配置导出、签字记录和工单编号，每项至少附一种证据。负责人规则是每项只有一个主责人，协办人单列在备注中。不适用项需说明理由并由部署负责人确认，不能直接留空。

检查项	通过标准	证据类型	负责人	检查时点	结论	备注
示例：数据库端口连通	从应用节点可连通数据库端口	连通性测试输出	网络-张三	安装前	通过	协办：DBA-李四
示例：HTTPS证书	证书在有效期内且签发链完整	证书信息截图	安全-王五	安装前	通过	到期日已登记
示例：备份恢复演练	按备份恢复后数据可读	演练记录	运维-赵六	上线前	不适用	本期无存量数据，理由已确认

部署准备中的协作衔接：用工作项跟踪检查进度

清单要变成可跟踪的任务，才能避免遗漏。把每个检查项建成工作项，设置负责人、截止时间和状态，阻断项单独标记并在评审中优先处理。证据附件和检查记录挂在工作项或文档中，便于回溯。联合验收时按工作项状态汇总结论，未关闭的阻断项直接对应“不通过”。

在 ONES 中，可以把检查项建成工作项并关联到部署项目，用状态流转记录从“待检查”到“通过”或“不通过”的过程，证据作为附件留存；部署方案、环境信息表和验收结论单可作为文档与工作项关联，让部署、运维、安全和业务方在同一处看到检查状态与阻断项。这样联合验收时不必再逐人收集表格，按工作项状态即可汇总。

常见问题

部署形态还没最终确定，能先按单机方案做环境准备吗？

不建议按未确认的形态先行采购或分配资源。单机、集群、容器化和混合部署对节点数量、存储容量和网络策略的要求不同，形态变化会导致已准备的资源返工。可行的做法是先把形态作为第一阶段的范围确认项，由部署负责人组织评审并留下结论记录；如果确需提前准备，只做与形态无关的公共项，例如时间同步源、域名规划和账号体系，节点规格和端口清单等形态确定后再核对。

复用现有数据库和缓存实例时，检查重点和新建有什么不同？

复用现有实例时，检查重点从“能否部署”转向“能否共存”：确认实例版本在平台兼容范围内、剩余资源能承载新增负载、账号权限按最小权限单独划分、现有备份策略是否覆盖新数据。新建实例则要额外确认部署位置、责任人、高可用方式和初始化参数。两类情况都要在依赖与账号准备表中登记组件版本、地址、账号归属和责任人，并在安装前完成一次连通性与权限验证。

部分集成对接要延后，会影响安装启动吗？

取决于该集成是否属于阻断项。统一认证、邮件等对接若影响平台登录或核心流程，应列入阻断项，安装前完成参数准备和连通性验证；若属于非关键集成，可作为有条件通过项登记责任人和完成时限，在联合验收结论中注明，并在上线前复核。判断标准是该项缺失时平台能否完成基本可用性验证，而不是集成本身是否重要。

回退方案需要准备到什么程度才算通过？

回退方案要能直接执行，至少包含触发条件、回退步骤、所需介质和时间窗口四项。触发条件写成可判断的情形，例如安装失败且在约定时间内无法修复；回退步骤按顺序列出操作和确认人；介质包括安装包、配置备份和数据备份，并验证可用；时间窗口与变更审批的部署窗口匹配。仅有文档框架、缺少可执行步骤或未验证备份可恢复的，按不通过处理。

检查项分散在多个团队，联合验收时怎么快速汇总？

把每个检查项建成工作项，统一设置负责人、截止时间、状态和证据附件，各团队在自己的范围内更新状态。联合验收前由部署负责人按工作项状态导出汇总，未关闭的阻断项直接对应不通过，条件项单独列出。这样汇总依据是工作项记录而非口头确认，事后也能回溯每项结论的证据和确认时间。