[NX-OS] Add buffer-boost annotation

Author: nikatza

config/samples/cisco/nx/v1alpha1_vpcdomain.yaml

@@ -43,6 +43,7 @@ metadata:
     networking.metal.ironcore.dev/device-name: leaf1
   annotations:
     nx.cisco.networking.metal.ironcore.dev/spanning-tree-port-type: "network"
+    nx.cisco.networking.metal.ironcore.dev/buffer-boost: "disable"
   name: eth1-31
 spec:
   deviceRef:
@@ -64,6 +65,7 @@ metadata:
     networking.metal.ironcore.dev/device-name: leaf1
   annotations:
     nx.cisco.networking.metal.ironcore.dev/spanning-tree-port-type: "network"
+    nx.cisco.networking.metal.ironcore.dev/buffer-boost: "disable"
   name: eth1-32
 spec:
   deviceRef:
@@ -85,7 +87,7 @@ metadata:
     networking.metal.ironcore.dev/device-name: leaf1
   annotations:
     nx.cisco.networking.metal.ironcore.dev/spanning-tree-port-type: "network"
-    nx.cisco.networking.metal.ironcore.dev/channel-group-force: ""
+    nx.cisco.networking.metal.ironcore.dev/buffer-boost: "disable"
   name: po1
 spec:
   deviceRef:

internal/provider/cisco/nxos/intf.go

@@ -74,6 +74,9 @@ type PhysIf struct {
 	TrunkVlans    string         `json:"trunkVlans"`
 	UserCfgdFlags UserFlags      `json:"userCfgdFlags"`
 	RtvrfMbrItems *VrfMember     `json:"rtvrfMbr-items,omitempty"`
+	PhysExtdItems struct {
+		BufferBoost string `json:"bufferBoost,omitempty"`
+	} `json:"physExtd-items,omitzero"`
 }
 
 func (*PhysIf) IsListItem() {}
@@ -160,6 +163,9 @@ type PortChannel struct {
 	RsmbrIfsItems struct {
 		RsMbrIfsList gnmiext.List[string, *PortChannelMember] `json:"RsMbrIfs-list,omitzero"`
 	} `json:"rsmbrIfs-items,omitzero"`
+	AggrExtdItems struct {
+		BufferBoost string `json:"bufferBoost,omitempty"`
+	} `json:"aggrExtd-items,omitzero"`
 }
 
 type PortChannelMember struct {

internal/provider/cisco/nxos/provider.go

@@ -30,6 +30,9 @@ import (
 
 const (
 	SpanningTreePortTypeAnnotation = "nx.cisco.networking.metal.ironcore.dev/spanning-tree-port-type"
+	// BufferBoostAnnotation is the annotation key used to enable or disable buffer boost on interfaces.
+	// Accepted values are 'enable' and 'disable', any other value will result in the device returning an error.
+	BufferBoostAnnotation = "nx.cisco.networking.metal.ironcore.dev/buffer-boost"
 )
 
 var (
@@ -673,6 +676,17 @@ func (p *Provider) EnsureInterface(ctx context.Context, req *provider.EnsureInte
 			}
 		}
 
+		// TODO: remove annotation with provider-specific implementation
+		ann, ok := req.Interface.GetAnnotations()[BufferBoostAnnotation]
+		if ok {
+			switch strings.ToLower(ann) {
+			case "enable", "disable":
+				p.PhysExtdItems.BufferBoost = strings.ToLower(ann)
+			default:
+				return fmt.Errorf("invalid value for annotation %q: %q. Must be %q or %q", BufferBoostAnnotation, ann, "enable", "disable")
+			}
+		}
+
 		if err := p.Validate(); err != nil {
 			return err
 		}
@@ -775,6 +789,17 @@ func (p *Provider) EnsureInterface(ctx context.Context, req *provider.EnsureInte
 			}
 		}
 
+		// TODO: remove annotation with provider-specific implementation
+		ann, ok := req.Interface.GetAnnotations()[BufferBoostAnnotation]
+		if ok {
+			switch strings.ToLower(ann) {
+			case "enable", "disable":
+				pc.AggrExtdItems.BufferBoost = strings.ToLower(ann)
+			default:
+				return fmt.Errorf("invalid value for annotation %q: %q. Must be %q or %q", BufferBoostAnnotation, ann, "enable", "disable")
+			}
+		}
+
 		conf = append(conf, pc)
 
 		if req.MultiChassisID != nil {