系统要求
在进行 Bob 本地部署之前，请确保你的环境满足支持的平台、架构、计算、存储和网络要求。
本节中的要求可帮助你适当地规划和调整 OpenShift 环境的规模。
支持的版本
下表列出了此版本 Bob 本地版支持的已验证组件版本。请确保你的部署使用 Bob IDE、Bob Shell、Premium Package 和 OpenShift Container Platform（OCP）的受支持版本，以保持兼容性并获得完整的产品支持。
| Bob 本地版版本 | Bob IDE 版本 | Bob Shell 版本 | Premium Package 版本 |
|---|---|---|---|
| 2.0.0 | 2.2.0 | 2.0.5 | IBM Bob Premium Package for Z 3.1.0 |
集群架构
Bob 本地后端需要 amd64 (x86_64) OCP 集群。所有调度 Bob 工作负载的工作节点都必须在 amd64 硬件上运行。
| 架构 | 后端集群支持 |
|---|---|
amd64 (x86_64) | 支持 |
当 Bob 工作负载通过节点选择器或污点被限制在 amd64 节点上时，混合架构集群是被支持的。Bob 不会自动应用这些调度约束。
支持的 OCP 版本
下表列出了支持的 OCP 版本。
| OCP 版本 | 状态 |
|---|---|
| 4.20 | 支持 |
| 4.21 | 支持 |
| 4.22 | 支持 |
部署占用空间与规模
Bob 本地版作为租户工作负载部署在客户管理的 OpenShift Container Platform（OCP）集群上。资源需求因你部署的 Bob 组件而异，并非所有安装的资源需求都相同。
每次部署都包含 Bob Core，提供基础平台服务。可选组件（如 Z Context 工具、Z Proxy 和 Z Understand）需要额外的计算、内存和存储资源，在调整集群规模时必须加以考虑。
插件在安装期间由集群管理员启用。启用插件不仅会增加集群资源需求，还决定了是否可以将相应的高级包授权分配给用户。有关更多信息，请参阅管理授权。
本节中的规格数值代表 Bob 工作负载所需的聚合资源。这些数值用于帮助估算租户占用空间，并不打算用于定义整体集群架构。你必须根据运维要求（包括高可用性、其他租户工作负载、预期增长和平台服务开销）调整底层集群的规模。
这些数值代表所有 Bob 组件在其指定副本数下配置的 Pod 资源请求总和。这是 Kubernetes 调度器在集群节点上预留的 CPU 和内存量。
这些数值仅供容量规划和规模评估使用。它们不代表观察到的运行时资源使用情况，不应被解读为负载下有保证的资源消耗。
集群规模决策（例如控制平面节点、基础设施节点、工作节点数量、高可用性要求和增长规划）仍由你负责。
不包含模型服务（推理）。本节中的资源估算不包括托管和提供 AI 模型所需的 GPU 节点、模型服务基础设施或其他资源。如果你使用 Red Hat OpenShift AI 或单独的模型服务平台运行模型推理，请独立于 Bob 部署来规划和调整这些环境的规模。
支持的堆栈配置
在调整 OpenShift 集群规模时，请参考与你计划部署最接近的配置。
| 堆栈配置 | CPU（原始） | 内存（原始） | 存储（PV） |
|---|---|---|---|
| Bob Core | 10.8 vCPU | 10.8 GiB | ~24 GiB |
| Bob Core + Z Context 工具 | 27.8 vCPU | 45.8 GiB | ~55 GiB |
| Bob Core + Z Understand | 18.8 vCPU | 49.8 GiB | ~24 GiB |
| Bob Core + Z Context 工具 + Z Understand | 35.8 vCPU | 84.8 GiB | ~55 GiB |
Bob Core 代表最低支持的部署配置。资源数值代表 Bob 租户的聚合需求，不包括平台基础设施开销。
Bob 资源占用
以下参考占用适用于未启用任何可选插件的 Bob Core 部署。
在调整工作节点规模时，请使用**+25% 调度余量**行中的数值。这些数值在已配置的 Pod 资源请求之外提供额外容量，以满足 Kubernetes 调度需求和节点级开销。
| 部署配置 | CPU | 内存 | 存储（PV） |
|---|---|---|---|
| 生产（请求资源） | 10.8 vCPU | 10.8 GiB | ~24 GiB |
| 生产（含 25% 调度余量） | ~13.5 vCPU | ~13.5 GiB | ~24 GiB |
存储消耗因工作负载量、保留数据和启用的服务而异。所示数值代表 Bob Core 部署的基准占用空间。
OpenShift 集群拓扑
下表展示了运行 Bob Core 部署的九节点 OpenShift 集群的最低生产可用参考配置。如果你部署了其他 Bob 组件，则必须预置额外的工作节点容量。
最低参考配置
| 节点角色 | 数量 | 每节点 CPU | 每节点内存 | 聚合容量 |
|---|---|---|---|---|
| 控制平面 | 3 | 4 vCPU（最低） | 16 GiB（最低） | 12 vCPU / 48 GiB |
| 基础设施节点 | 3 | ~4 vCPU | ~16 GiB | 12 vCPU / 48 GiB |
| 工作节点 | 3 | 8 vCPU | 16 GiB | 24 vCPU / 48 GiB / 600 GiB 存储 |
| 集群总计 | 9 | - | - | ~48 vCPU / ~144 GiB / 600 GiB 存储 |
在扣除 OpenShift 集群开销和系统预留资源后，三工作节点配置可提供足够的可分配 CPU 和内存容量，以支持 Bob Core 生产部署。
参考资料：OpenShift Control Plane Sizing Guidelines、Control plane node sizing（保持利用率在 60% 或以下以保障 HA 和升级余量）和 Recommended host practices, Scalability and Performance（建议 3 个基础设施节点）。
存储要求
Bob 依赖持久化存储来存放数据库、搜索服务、缓存组件、配置、证书和备份数据。选择适当的存储类对性能和可靠性至关重要。
参考配置为每个工作节点分配 200 GiB 存储，工作节点池共计 600 GiB。这可满足 Bob 持久卷需求（~50 GiB）、OpenShift 内部服务（如镜像仓库、监控和日志）以及未来工作负载增长的容量。
支持的存储类
| 存储类 | 类型 | 支持的访问模式 |
|---|---|---|
| Managed NFS | 网络文件系统（NFS）供应器 | RWO、RWX |
| OpenShift Data Foundation（ODF） | Ceph 后端存储（RBD 和 CephFS） | RWO、RWX |
存储访问模式要求
不同的 Bob 组件需要不同的存储访问模式。
| 组件 | 所需访问模式 | 备注 |
|---|---|---|
| PostgreSQL | RWO（ReadWriteOnce） | 需要块存储。强烈建议使用 SSD 后端存储。 |
| OpenSearch | RWO（ReadWriteOnce） | 建议使用高性能块存储。 |
| Redis | RWO（ReadWriteOnce） | 持久数据需要专用读写访问。 |
| 共享配置和证书 | RWX（ReadWriteMany） | 当多个 Pod 需要同时挂载同一卷时需要。 |
存储性能对 Bob 本地部署的响应速度和稳定性有重大影响。
存储吞吐量或 I/O 性能不足（尤其是 PostgreSQL 工作负载）可能导致响应时间增加、索引操作变慢以及整体系统性能下降。在选择数据库工作负载的存储时：
- 尽量使用 SSD 后端块存储。
- 避免使用高延迟或 IOPS 有限的存储平台。
- 确保有足够容量以应对预期的工作负载增长。
- 在部署生产工作负载之前验证存储性能。
为获得最佳性能，请在环境中最快的可用块存储上部署 PostgreSQL 和 OpenSearch 数据卷。
备份存储
Bob 需要单独的存储目标用于备份和恢复操作。备份存储位置必须提供足够的容量来存储：
- 应用备份
- 数据库备份
- 索引快照
- 组织策略要求的保留副本
备份存储可由支持的外部存储系统提供，例如：
- 网络文件系统（NFS）共享
- 企业备份存储库
- 对象存储服务（如果备份解决方案支持）
网络要求
Bob 组件在 OpenShift 集群内部进行通信，并与模型端点、容器镜像仓库、LDAP 提供商和客户端工作站进行外部通信。在安装之前，请验证所需的网络连通性和 DNS 配置是否可用。
至少需要确保：
- OpenShift 节点之间可以相互通信。
- 你的工作站可以访问 OpenShift API。
- Bob 可以访问配置的 LLM 端点。
- Bob 可以访问 LDAP 或 Active Directory 服务器（如果使用）。
- 客户端工作站可以访问 Bob 入口端点。
- 已为 Bob 应用端点配置 DNS 记录。
- 客户端工作站可以验证 TLS 证书。