研发平台部署准备的目标，是让平台在正式上线前具备“装得上、连得通、用得住”的条件。准备阶段要依次定清部署形态与责任边界、核算资源、打通网络、准备账号与安全基线、梳理数据与集成接口，再通过试部署和回退演练验证，最后用一份可逐项签字的就绪检查表决定是否切换上线。准备阶段的交付物是资源清单、网络与访问方案、账号权限矩阵、接口清单、试部署记录和上线检查表，平台功能本身不在这一阶段交付。准备过程中的任务分派、检查项跟踪和上线评审，可以在ONES中承载。
要点总览（TL;DR）
- 部署准备按“定形态与边界—核算资源—打通网络—准备账号与安全—梳理数据与接口—试部署与回退演练—就绪检查与切换判断”推进，每步都要有输入、动作、输出和完成标志。
- 资源核算以日活用户、并发峰值、附件与代码仓库体量为输入，形成含规格、数量、用途、责任人和到位时间的资源清单，并与平台方复核。
- 网络准备先画内外网访问路径，再定域名与证书续期安排，最后按端口与出站白名单逐段验证连通性并留记录。
- 试部署要在与生产尽量一致的测试环境完成一次完整部署和回退演练，回退触发条件事先约定，记录作为上线评审证据。
- 上线判断依据按资源、网络、账号、数据、集成、演练六组编排的就绪检查表，区分阻断项与可带条件上线项，由IT、安全和业务三方签字。
部署准备先定哪几件事：形态、边界与责任分工
部署准备的第一步是确定部署形态，并划清准备范围。形态选择直接影响资源规模、网络方案和后续运维方式，建议在项目启动会上形成书面结论，由IT负责人和业务负责人共同确认。
三种部署形态的判断依据
| 形态 | 适用条件 | 需要提前确认的事项 |
|---|---|---|
| 私有化部署 | 数据需要完整隔离并留在企业机房，或有明确的合规与内控要求 | 机房资源、运维值班能力、备份介质 |
| 专有云部署 | 使用专属云资源，网络与数据与其他租户隔离，同时希望减少自建机房投入 | 云资源规格、专线或VPN连通、云上安全组策略 |
| 混合部署 | 核心数据留在本地，部分服务或集成组件放在云端 | 跨环境网络时延、数据流向、两侧运维责任划分 |
判断时按数据合规要求、网络隔离程度、自身运维能力三项排序，先满足硬性约束，再比较投入。ONES支持私有部署和公有云部署两种方式，私有化部署采用K3s容器化部署，并支持对接LDAP等企业内部系统；是否启用高可用集群部署，需结合业务连续性要求确定。
部署准备与业务配置的边界
部署准备覆盖环境、网络、账号、数据迁移和接口联调，完成标志是平台可登录、核心链路可走通。工作项类型配置、流程定制、角色权限细化属于业务配置治理，应在上线后由业务管理员按治理计划推进。把两者混在一个阶段，容易导致部署被业务讨论拖住，也会让配置变更缺少记录。
四类角色与交付物
| 角色 | 主要职责 | 交付物 |
|---|---|---|
| 平台方（厂商或实施团队） | 提供部署方案、版本基线、安装与联调支持 | 部署方案、版本兼容说明、试部署支持记录 |
| IT基础设施 | 服务器、存储、网络、域名证书的到位与配置 | 资源清单、网络与访问方案、连通性验证记录 |
| 安全 | 安全基线审核、账号源对接审核、上线前安全评审 | 安全基线检查项、评审意见 |
| 业务接口人 | 确认数据范围、集成需求与验收口径 | 数据范围说明、集成接口清单、验收确认 |
时间盒与里程碑
建议按“资源与网络准备—账号与安全准备—数据与接口准备—试部署与回退演练—上线评审”设置五个里程碑，每个里程碑设定固定时间盒，到期未完成的事项进入风险清单并在周例会上处理。里程碑的完成标志是交付物签字，而非口头确认。
环境与资源基线怎么核算
资源核算的输入是用户规模、并发峰值、附件与代码仓库体量，输出是一份含规格、数量、用途、责任人和到位时间的资源清单。核算宜先粗后细：先按用户数估应用节点，再按数据体量估存储，最后按集成数量补中间件。
核算口径
- 用户数：区分注册用户与日活用户，按日活峰值估算应用节点数量。
- 并发峰值：结合上线初期的集中登录、批量导入等场景，预留余量。
- 附件与代码仓库体量：按现有数据量加上未来一年的增长预估存储容量。
- 数据库与缓存：按业务数据量和查询压力确定规格，读写分离需求提前说明。
组件清单
典型组件包括应用节点、数据库、缓存、对象存储、制品库，以及反向代理或负载均衡。高可用形态还需考虑多节点部署与故障转移。具体规格与节点数量应以厂商提供的部署方案为准，来源资料未给出统一容量基线，核算结果需与平台方复核。
版本基线确认
操作系统、数据库、JDK或运行时版本，应在采购前向平台方索取兼容清单并逐项比对现有环境。版本不一致的，要么调整环境，要么确认厂商支持范围，避免安装阶段返工。
资源清单字段
| 字段 | 填写要求 |
|---|---|
| 组件名称 | 应用节点、数据库、缓存、对象存储、制品库等 |
| 规格 | CPU、内存、磁盘类型与容量 |
| 数量 | 按部署形态与高可用要求确定 |
| 用途 | 说明承载的服务或数据 |
| 责任人 | 资源到位的具体负责人 |
| 到位时间 | 与里程碑对齐 |
网络、域名与证书怎么提前打通
网络准备的目标是让用户、平台节点和外部系统之间的访问路径在部署前就确定并验证通过。做法是先画访问路径，再定域名与证书，最后按端口和白名单逐项验证。
访问路径规划
先区分内网访问与外部访问：内网用户经反向代理或负载均衡访问应用节点，外部集成系统通过指定出口访问接口。代理层需要明确会话保持、超时设置和上传大小限制，这些参数在试部署时验证。
域名与证书
域名规划应包含平台主域名、可能的子域名以及接口域名，提前完成解析配置。HTTPS证书需在部署前申请并完成部署验证，同时登记到期时间与续期责任人，避免上线后因证书过期导致访问中断。ONES在数据传输上使用HTTPS协议、TLS 1.2标准，证书配置需与这一要求匹配。
端口与出站白名单
按组件梳理需要开放的入站端口，按集成系统梳理需要放行的出站地址。清单至少记录源地址、目标地址、端口、协议、用途和申请人。来源资料未提供具体端口与白名单明细，需向平台方索取后填入。
连通性验证
验证按“用户到代理—代理到应用—应用到数据库与缓存—应用到外部系统”的顺序逐段执行，每段记录测试时间、测试方法、结果和验证人。验证记录作为上线检查表的证据留存。
账号、权限与安全基线如何准备
账号准备的前置条件是确认企业账号源可用。若使用LDAP、AD或OAuth对接，需提前确认目录服务地址、同步范围、属性映射和测试账号。ONES私有化部署支持对接LDAP等企业内部系统，具体配置方式与前置条件以实施约定为准。
账号分配原则
- 管理员账号：按最小必要原则分配，区分平台管理员与安全审计角色，避免共用。
- 服务账号：用于集成与定时任务，单独命名、单独保管凭据，不用于人工登录。
- 初始角色：上线前只预设必要的管理员与普通用户角色，细化权限留到业务配置阶段。
安全基线项
| 基线项 | 准备内容 |
|---|---|
| 密码策略 | 确认密码复杂度、有效期与锁定策略，与账号源策略保持一致 |
| 审计日志 | 确认日志留存范围、留存周期与导出方式 |
| 备份策略 | 明确备份对象、频率、保留份数与恢复验证方式 |
| 访问控制 | 确认管理入口的访问来源限制与网络隔离措施 |
ONES在数据安全方面采取传输加密、分布式存储、数据备份等措施，备份策略需按客户场景具体适配。安全评审通常需要提交部署拓扑、账号权限矩阵、安全基线检查项和备份方案，材料齐备后再安排评审，可减少反复。
数据与集成接口清单怎么梳理
数据与接口准备决定上线后平台能否接入现有研发流程。梳理顺序是先定数据范围，再列集成系统，最后按依赖关系排联调顺序。
数据范围与清洗
明确需要迁移或初始化的数据对象，例如组织架构、用户、历史工作项、附件和代码仓库。对每条数据说明来源、体量、清洗规则和责任人。历史数据中存在重复、缺失或格式不一致的，在迁移前完成清洗，并保留清洗前后的对照记录。
集成接口清单
| 字段 | 填写要求 |
|---|---|
| 系统名称 | 代码仓库、CI/CD、IM、单点登录、制品库等 |
| 协议 | 接口协议与版本 |
| 认证方式 | Token、OAuth、证书等 |
| 负责人 | 双方各一名接口人 |
| 联调时间 | 与里程碑对齐 |
联调顺序
建议先打通身份认证与代码仓库，这两项是用户登录和研发活动的基础；再对接CI/CD与制品库，验证构建与发布链路；最后接入IM通知，避免前期被消息噪音干扰。每完成一项联调，记录接口返回结果与异常处理方式。
试部署与回退演练怎么做
试部署是在测试环境完成一次接近生产的完整部署，回退演练是在同一环境验证失败后能否恢复。两者共同构成上线前的最后一道验证。
环境一致性要求
测试环境的操作系统、数据库版本、网络结构和组件规格应尽量与生产一致。差异项需登记并评估影响，例如测试环境单节点而生产多节点时，需单独验证负载均衡与故障转移。
执行顺序与验证点
- 基础环境就绪：操作系统、依赖组件、目录权限，验证点为组件可启动。
- 平台安装：按部署方案执行安装，验证点为服务状态正常、管理入口可访问。
- 账号与登录：接入账号源，验证点为测试账号可登录且角色正确。
- 核心链路：创建工作项、上传附件、触发一次集成，验证点为数据写入与回传正确。
- 备份与回退：执行一次备份，模拟故障后按回退方案恢复，验证点为数据完整、服务恢复时间符合约定。
回退判定标准
回退触发条件需事先约定，例如核心服务不可用超过约定时长、数据校验不一致、关键集成无法连通。演练时按这些条件实际触发一次回退，记录从发现到恢复的全过程时间。
记录留存
试部署记录应包含每步的执行时间、执行人、验证结果、异常与处置，以及备份文件位置和回退演练结论。这些记录是上线评审的直接证据。
上线就绪检查表与切换判断
就绪检查表把前六步的结果汇总为可逐项签字的清单，作用是让上线决策有据可依。检查表按资源、网络、账号、数据、集成、演练六组编排，每项写明通过标准、证据和签字人。
| 分组 | 典型检查项 | 通过标准 |
|---|---|---|
| 资源 | 服务器、存储、数据库、中间件到位 | 规格与清单一致，责任人确认 |
| 网络 | 域名解析、证书、端口与白名单 | 连通性验证记录齐全 |
| 账号 | 账号源对接、管理员与服务账号 | 测试账号登录与权限验证通过 |
| 数据 | 迁移范围与清洗结果 | 数据校验一致，业务接口人确认 |
| 集成 | 各系统接口联调 | 联调记录完整，异常有处置结论 |
| 演练 | 试部署与回退演练 | 回退在约定时间内完成 |
检查项分为阻断项与可带条件上线项。阻断项未通过不得上线，例如核心服务不可用、数据校验不一致；可带条件上线项需写明补救责任人和完成期限，例如非核心集成延后联调。上线窗口应避开业务高峰，值守安排覆盖上线当晚与次日工作时间，回退触发条件与演练时保持一致。切换决策由IT负责人、安全负责人和业务接口人共同签字确认，决策记录与检查表一并归档。
准备过程中的检查项分派、证据上传和签字确认，可以在ONES中建立对应工作项与文档，让每个里程碑的完成状态可查。
一个中型研发团队的准备示例
以下为演示情景，用于说明各步骤的输入与输出，不代表真实项目数据。
情景设定
某研发团队约300人，日活约200人，选择私有化部署，需对接企业LDAP、代码仓库、CI/CD和IM四类系统。项目周期设为六周，按五个里程碑推进。
资源与网络准备
按日活峰值估算应用节点数量，按现有附件与代码仓库体量加一年增长预估存储容量，形成资源清单并标注到位时间。网络侧确定平台主域名与接口域名，完成证书申请，按组件整理入站端口，按四类集成系统整理出站白名单，逐段完成连通性验证并留存记录。
试部署中发现的问题
试部署时发现两处问题：一是证书链不完整导致部分客户端访问告警，重新配置证书链后复测通过；二是IM通知接口的认证方式与预期不一致，调整为约定的认证方式后联调成功。两项问题均记录处置过程与复测结果。
检查表签字与上线判断
上线评审时，资源、网络、账号、数据、演练五组全部通过；集成组中IM通知的异常消息重试机制尚未验证，列为可带条件上线项，约定上线后一周内完成并指定责任人。检查表经三方签字后进入上线窗口，值守安排覆盖上线当晚与次日工作时间。
常见问题
部署准备阶段和业务配置阶段怎么划清界限，避免互相拖累？
部署准备的完成标志是平台可登录、核心链路可走通，覆盖环境、网络、账号、数据迁移和接口联调。工作项类型配置、流程定制、角色权限细化属于业务配置治理，放在上线后由业务管理员按治理计划推进。
实际操作中，可以在项目启动会上把两类工作分别列成清单，部署清单由IT负责人签字，配置清单由业务负责人签字。遇到业务方在部署阶段提出配置需求，先登记到配置清单，不占用部署里程碑的时间盒。
资源核算没有厂商统一容量基线时，怎么给出可执行的数字？
先按日活峰值估应用节点数量，再按现有附件与代码仓库体量加一年增长预估存储容量，最后按集成系统数量补中间件。核算结果形成资源清单后，与平台方逐项复核，把厂商确认的规格作为采购依据。
清单中标注到位时间并与里程碑对齐，规格暂未确认的项写明待复核状态和责任人，避免用估算值直接下单。
测试环境和生产环境规格不一致时，试部署结论还能用吗？
可以用，但需要把差异项登记并评估影响。例如测试环境单节点、生产多节点时，负载均衡与故障转移要在生产环境单独验证；数据库版本不一致时，需确认厂商兼容范围。
试部署记录中应写明环境差异、对应验证项和补验安排，上线检查表把未覆盖的验证项列为待办，明确责任人和完成时间。
哪些检查项可以作为可带条件上线项，判断依据是什么？
判断依据是该项失效是否影响核心链路和数据正确性。核心服务不可用、数据校验不一致属于阻断项，未通过不得上线；非核心集成延后联调、异常消息重试机制待验证这类不影响主流程的项，可以作为可带条件上线项。
可带条件上线项要写明补救责任人、完成期限和验证方式，并在上线后按约定时间复核关闭，不能长期挂账。
账号源对接在部署准备中需要提前做到什么程度？
至少完成三件事：确认目录服务地址与同步范围可用，确认属性映射关系，准备测试账号完成一次登录验证。ONES私有化部署支持对接LDAP等企业内部系统，具体配置方式与前置条件以实施约定为准。
管理员账号、服务账号与初始角色在对接前就要分配好，服务账号单独命名、单独保管凭据，不用于人工登录。权限细化留到业务配置阶段处理。
