问题说明
本文用于排查“ZSphere 创建 VLAN 类型为无的分布式端口组失败”类问题。
现象
- 创建 VLAN 类型为无的分布式端口组失败，页面报 API ERROR。
- 集群主机底层存在残留 novlan 网桥或 bond 配置问题。
适用环境
- 产品：ZVF
- 版本：4.x
- 组件：ZSphere
- 涉及对象：分布式端口组
- 场景：网络与交换机类问题，需结合当前版本、部署形态、存储类型和操作时间线确认。
可能原因
- bond 配置不一致或不符合端口组要求。
- 底层残留 novlan bridge 与新端口组创建冲突。
- 部分主机网络配置与集群网络模型不一致。
排查步骤
按顺序执行以下检查，并记录受影响对象、发生时间、完整报错和当前状态。
- 检查集群内所有主机 bond、bridge、VLAN 子接口是否一致。
- 确认是否存在历史残留 novlan 网桥，记录名称和关联端口。
- 查看管理服务日志中 API ERROR 的具体失败原因。
- 清理底层网络残留需先确认无业务流量和无端口组引用，再按变更执行。
处理方法
- 核对集群内主机的 bond 和网桥配置，定位与端口组创建冲突的残留 novlan 网桥。
- 在确认该网桥不承载业务流量、未被端口组引用并已完成配置备份后，清理残留配置，再重新创建端口组。
验证方法
- 无 VLAN 类型的分布式端口组可以成功创建。
- 创建后，确认集群内主机网络连通性及现有端口组业务不受影响。