【待评审】新增资源协作接口属性VethSupported与ActiveInterfaceName

背景

单板管理网口组网场景中,部分单板需要拉起 veth 虚拟网口以承接内部网络/近端维护网络流量。当前系统存在差距:

  1. 缺少「单板是否需要拉起 veth 网口」的对外能力标识,veth 是否拉起的判断散落在各组件硬编码,无法按单板能力统一调度;

  2. 缺少「网口组当前生效网口名」的对外属性,上层运维无法稳定查询生效网口名。

故需在资源协作接口中新增两个只读属性,分别承载上述能力标识与生效网口名。

关联ISSUE

整体方案

bmc.kepler.Managers.MgmtPortCapability(管理网口能力描述对象)上新增 VethSupported,作为单板维度的 veth 能力标识,供网络管理组件读取后决定是否拉起 veth;在 bmc.kepler.Managers.EthernetInterfaces.EthGroup(网口组对象,path /bmc/kepler/Managers/:Id/EthernetInterfaces/EthGroup/:EthGroupName)上新增 ActiveInterfaceName,暴露当前生效网口名。两属性均只读、无默认值,由实现组件按单板实际能力与运行态赋值。

评审点

  1. 新增资源协作接口属性 bmc.kepler.Managers.MgmtPortCapability.VethSupported,用于标识单板是否需要拉起 veth 网口。

  2. 新增资源协作接口属性 bmc.kepler.Managers.EthernetInterfaces.EthGroup.ActiveInterfaceName,用于暴露网口组当前生效网口名。

详细描述

本次属「场景6:新增/变更资源协作接口(property)」,不涉及 method/signal/错误消息变更,按两个评审点分别描述如下。

评审点1:MgmtPortCapability 新增 VethSupported

| 接口 | 对象 path | 属性 | baseType | readOnly | options.emitsChangedSignal | description |

|------|----------|------|----------|----------|---------------------------|-------------|

| bmc.kepler.Managers.MgmtPortCapability | MgmtPortCapability 对象 | VethSupported | Boolean | true | “false” | 单板是否需要拉起veth网口 |

  • 与同接口既有 DedicatedSupported/AggregationSupported/DedicatedVlanSupported 同属单板能力型只读属性,emitsChangedSignal="false" 与之一致。

  • 属性为静态能力描述,运行期不变,不上抛变化信号。

评审点2:EthGroup 新增 ActiveInterfaceName

| 接口 | 对象 path | 属性 | baseType | readOnly | options.emitsChangedSignal | description |

|------|----------|------|----------|----------|---------------------------|-------------|

| bmc.kepler.Managers.EthernetInterfaces.EthGroup | /bmc/kepler/Managers/:Id/EthernetInterfaces/EthGroup/:EthGroupName | ActiveInterfaceName | String | true | “true” | 生效的网口名 |

  • 属性为运行期可变(故障切换时生效网口变更),故 emitsChangedSignal="true",由实现方在切换时上抛 PropertiesChanged 信号。

两属性均 readOnly、无默认值,由实现组件按单板实际能力与运行态赋值。

是否准备好AI预审

评审结论

同意评审点1:bmc.kepler.Managers.MgmtPortCapability 接口新增只读属性 VethSupported(baseType Boolean,readOnly,emitsChangedSignal=“false”,描述"单板是否需要拉起veth网口"),用于标识单板是否需要拉起 veth 网口。

同意评审点2:bmc.kepler.Managers.EthernetInterfaces.EthGroup 接口新增只读属性 ActiveInterfaceName(baseType String,readOnly,emitsChangedSignal=“true”,描述"生效的网口名"),用于暴露网口组当前生效网口名;实现方需在故障切换时上抛变化信号。

两属性均无默认值,由实现组件按单板实际能力与运行态赋值。

遗留问题

预审答案内容由AI生成,仅供参考:

帖子评审结论:【待评审】新增资源协作接口属性VethSupported与ActiveInterfaceName

帖子相关性:相关(MDB 相关: 标题含强特征: 资源协作)

  • 总评审点数:2
  • MDB 资源协作接口评审点:2
  • 其他评审点:0

总体结果:通过(2/2 个评审点通过)

评审点 1:新增资源协作接口属性 bmc.kepler.Managers.MgmtPortCapability.VethSupported,用于标识单板是否需要拉起 veth 网口。【MDB】

结果:通过

  • 规则合规性检查:通过(28 项检查全部通过)
    • 警告项(建议性)
      规则ID:MDB-REVIEW-003
      级别:建议性
      问题描述:缺少显式的消费方或使用场景说明,以及文档同步计划。
      处理建议:severity=‘should’ 建议性规则,建议修改以提升规范符合性

评审点 2:新增资源协作接口属性 bmc.kepler.Managers.EthernetInterfaces.EthGroup.ActiveInterfaceName,用于暴露网口组当前生效网口名。【MDB】

结果:通过

  • 规则合规性检查:通过(28 项检查全部通过)