1. 验收交付总览

OpenShift企业平台的验收交付,不是一次简单的“装完即交”动作,而是从平台建设完成到正式移交生产运营之间的一段受控过程。它的核心任务是:用可复现的证据证明平台在功能、性能、安全、高可用和可运维性上达到了合同或设计约定,并把平台连同配置、文档、权限、监控和运维责任一并移交给接收方。换句话说,验收交付回答三个问题:建成的平台是否符合约定?证据是否充分可信?移交后谁按什么方式继续运营?

从定义上看,验收交付包含“验收”和“交付”两条主线。验收侧重验证与判定,输出测试记录、缺陷清单、验收结论;交付侧重移交与承接,输出架构文档、配置基线、账号权限、运维手册和培训记录。两者不能割裂:没有验收结论的交付缺乏依据,没有交付动作的验收无法真正投入生产。

验收交付的目标与判定标准

目标可以归纳为四点。第一,符合性:集群规模、节点规格、网络方案、存储方案、认证方式与设计文档一致。第二,可用性:控制平面、路由、镜像仓库、日志与监控等关键组件在单点故障下仍能提供服务。第三,可运维性:监控告警、日志采集、备份恢复、证书轮换、扩容流程可执行。第四,可承接性:接收方团队能独立完成日常巡检、常见故障处理和变更操作。

判定标准应尽量量化。例如:控制平面节点 etcd 成员健康且延迟在约定阈值内;集群 Operator 全部 Available;关键业务命名空间的应用在节点重启后能自动恢复;平台 API 在压测下的 P95 响应时间不超过约定值。以下是一个示例性的验收判定表,参数为教学假设值,实际项目应按合同和设计调整。

验收域检查对象示例判定标准证据形式
集群健康ClusterOperator / etcd全部 Available,etcd 成员 3/3 健康oc 命令输出截图
高可用控制平面、Ingress关闭 1 个 master 后 API 仍可用故障注入记录
安全RBAC、SCC、证书越权访问被拒绝,证书有效期 > 90 天审计日志、证书清单
可观测Prometheus、日志告警可送达,日志可检索近 7 天告警截图、查询结果
备份恢复etcd 备份可从备份恢复至测试集群恢复演练报告

验收范围与边界

范围界定不清是验收争议的主要来源。建议在项目早期就明确“范围内”和“范围外”。范围内通常包括:OpenShift 集群本身、集群内平台组件(Ingress、监控、日志、镜像仓库、认证集成)、与外部系统的对接(LDAP/OIDC、存储、负载均衡、DNS)、以及约定的应用试点验证。范围外通常包括:业务应用的代码质量、应用自身的性能瓶颈、客户机房电力与网络硬件、未纳入本次集成的第三方系统。

边界还要说明责任分界。例如,负载均衡器由网络团队提供,OpenShift 团队负责提供 VIP 和健康检查路径;存储由存储团队提供,OpenShift 团队负责验证 StorageClass 动态供给和 PVC 绑定。把这些写进验收范围说明,可以避免“平台没问题但依赖没到位”的扯皮。

干系人角色与职责

验收交付涉及多方协作,典型角色包括:项目发起人/客户负责人,负责确认验收结论和资源协调;平台架构师,负责技术方案与偏差裁定;实施工程师,负责部署、配置和缺陷修复;测试/验收工程师,负责设计用例、执行验证并记录证据;运维接收团队,负责参与演练、确认可运维性并签署移交;安全与合规人员,负责审核权限、证书和审计要求;应用团队代表,负责试点应用的部署与验证。每个角色都应在验收计划中明确“谁提供什么、谁确认什么”。

交付物清单

交付物是验收交付的实物成果,建议按“架构与设计、部署与配置、验证与证据、运维与移交”四类组织。以下清单可直接作为项目交付物模板使用,字段可根据项目裁剪。

  • 架构与设计类:总体架构图、网络拓扑与 IP 规划、存储方案、认证集成方案、高可用设计说明。
  • 部署与配置类:安装配置清单、集群配置基线(MachineConfig、ClusterOperator 状态)、命名空间与 RBAC 清单、证书清单、镜像仓库配置。
  • 验证与证据类:验收测试用例、执行记录、缺陷清单与关闭状态、性能与高可用测试报告、备份恢复演练报告。
  • 运维与移交类:日常巡检手册、告警处理手册、扩容与升级流程、应急联系人清单、培训记录、账号权限移交确认单。
交付物不是“越多越好”,而是“接收方能否据此独立运维”。一份能让人按步骤完成 etcd 备份恢复的文档,比十份泛泛而谈的说明更有价值。

验收交付的整体关系

下图把本节的核心对象放在同一张关系图中:左侧是输入(设计、环境、依赖),中间是验收交付过程(验证、判定、移交),右侧是输出(结论、交付物、生产运营)。图中同时标出关键干系人和判定分支,帮助理解“谁在什么阶段对什么负责”。

OpenShift 企业平台验收交付总览 输入 / 依据 设计文档与合同 架构 / 网络 / 存储 已建成集群环境 Master / Worker / Infra 外部依赖 DNS / LB / 存储 / 认证 验收计划与用例 范围 / 标准 / 排期 培训与演练准备 运维 / 应急 / 备份 验收交付过程 ① 符合性验证 集群规模 / 配置基线 / 组件状态 / 认证集成 ② 高可用与性能验证 故障注入 / API 压测 / 应用恢复 / 路由切换 ③ 安全与可运维性验证 RBAC / 证书 / 告警 / 日志 / 备份恢复演练 ④ 缺陷判定与整改 分级 / 复测 / 关闭 / 偏差记录 ⑤ 移交与签署 文档 / 权限 / 培训 / 验收结论 输出 / 结果 验收结论 通过 / 有条件通过 交付物包 文档 / 配置 / 证据 权限与账号移交 管理员 / 审计 / 只读 运维承接确认 巡检 / 告警 / 变更 生产运营启动 SLA / 变更 / 扩容 干系人: 项目发起人 · 平台架构师 · 实施工程师 · 测试/验收工程师 · 运维接收团队 · 安全合规 · 应用团队代表 不通过则返回整改

理解这张图的关键在于:验收交付不是单点动作,而是一条从“依据”到“结论”的受控链路。输入决定验收标准,过程产生证据,输出形成可承接的生产状态。任何一环缺失,都会让验收结论失去说服力,或者让移交后的运维陷入被动。

常见误区:把“集群能登录、Pod 能跑起来”当作验收通过。真正的验收必须覆盖高可用、安全、可观测、备份恢复和运维承接,否则问题会在生产运行阶段集中暴露。

最后需要强调,验收交付的成败往往不取决于技术本身,而取决于前期是否把范围、标准、角色和交付物定义清楚。建议在项目启动阶段就形成一份《验收交付计划》,明确验收域、判定标准、证据形式、责任人和时间点,并在实施过程中持续更新。这样到了验收阶段,团队只需要按计划执行和记录,而不是临时争论“这算不算通过”。