(feat): Cisco IOS XR implement bundle interface configuration

Author: sven-rosenzweig

internal/provider/cisco/gnmiext/v2/client.go

@@ -280,7 +280,6 @@ func (c *client) set(ctx context.Context, patch bool, conf ...Configurable) erro
 		// If the current configuration does not exist, continue to set the desired configuration.
 		if status.Code(err) != codes.NotFound {
 			if err != nil && !errors.Is(err, ErrNil) {
-
 				return fmt.Errorf("gnmiext: failed to retrieve current config for %s: %w", cf.XPath(), err)
 			}
 			// If the current configuration is equal to the desired configuration, skip the update.

internal/provider/cisco/iosxr/intf.go

@@ -4,23 +4,72 @@
 package iosxr
 
 import (
+	"errors"
 	"fmt"
 	"regexp"
+	"strconv"
+	"strings"
 
 	"github.com/ironcore-dev/network-operator/internal/provider/cisco/gnmiext/v2"
 )
 
-type PhysIf struct {
+type IFaceSpeed string
+
+const (
+	Speed10G    IFaceSpeed = "TenGigE"
+	Speed25G    IFaceSpeed = "TwentyFiveGigE"
+	Speed40G    IFaceSpeed = "FortyGigE"
+	Speed100G   IFaceSpeed = "HundredGigE"
+	EtherBundle IFaceSpeed = "etherbundle"
+)
+
+type BunldePortActivity string
+
+const (
+	PortActivityOn      BunldePortActivity = "on"
+	PortActivityActive  BunldePortActivity = "active"
+	PortActivityPassive BunldePortActivity = "passive"
+	PortActivityInherit BunldePortActivity = "inherit"
+)
+
+type PhysIfStateType string
+
+const (
+	StateUp        PhysIfStateType = "im-state-up"
+	StateDown      PhysIfStateType = "im-state-down"
+	StateNotReady  PhysIfStateType = "im-state-not-ready"
+	StateAdminDown PhysIfStateType = "im-state-admin-down"
+	StateShutDown  PhysIfStateType = "im-state-shutdown"
+)
+
+// Represent physical and bundle interfaces as part of the same struct as they share a lot of common configuration
+// and only differ in a few attributes like the interface name and the presence of bundle configuration or not.
+type Iface struct {
 	Name         string        `json:"-"`
-	Description  string        `json:"description"`
-	Active       string        `json:"active"`
-	Vrf          string        `json:"Cisco-IOS-XR-infra-rsi-cfg:vrf,omitempty"`
-	Statistics   Statistics    `json:"Cisco-IOS-XR-infra-statsd-cfg:statistics,omitempty"`
-	IPv4Network  IPv4Network   `json:"Cisco-IOS-XR-ipv4-io-cfg:ipv4-network,omitempty"`
-	IPv6Network  IPv6Network   `json:"Cisco-IOS-XR-ipv6-ma-cfg:ipv6-network,omitempty"`
-	IPv6Neighbor IPv6Neighbor  `json:"Cisco-IOS-XR-ipv6-nd-cfg:ipv6-neighbor,omitempty"`
-	MTUs         MTUs          `json:"mtus,omitempty"`
-	Shutdown     gnmiext.Empty `json:"shutdown,omitempty"`
+	Description  string        `json:"description,omitzero"`
+	Statistics   Statistics    `json:"Cisco-IOS-XR-infra-statsd-cfg:statistics,omitzero"`
+	MTUs         MTUs          `json:"mtus,omitzero"`
+	Active       string        `json:"active,omitzero"`
+	Vrf          string        `json:"Cisco-IOS-XR-infra-rsi-cfg:vrf,omitzero"`
+	IPv4Network  IPv4Network   `json:"Cisco-IOS-XR-ipv4-io-cfg:ipv4-network,omitzero"`
+	IPv6Network  IPv6Network   `json:"Cisco-IOS-XR-ipv6-ma-cfg:ipv6-network,omitzero"`
+	IPv6Neighbor IPv6Neighbor  `json:"Cisco-IOS-XR-ipv6-nd-cfg:ipv6-neighbor,omitzero"`
+	Shutdown     gnmiext.Empty `json:"shutdown,omitzero"`
+
+	// Existence of this object causes the creation of the software subinterface
+	ModeNoPhysical string `json:"interface-mode-non-physical,omitzero"`
+
+	// BundleMember configuration for Physical interface as member of a Bundle-Ether
+	BundleMember BundleMember `json:"Cisco-IOS-XR-bundlemgr-cfg:bundle-member,omitzero"`
+
+	// Mode in which an interface is running (e.g., virtual for subinterfaces)
+	Mode         gnmiext.Empty    `json:"interface-virtual,omitzero"`
+	Bundle       Bundle           `json:"Cisco-IOS-XR-bundlemgr-cfg:bundle,omitzero"`
+	SubInterface VlanSubInterface `json:"Cisco-IOS-XR-l2-eth-infra-cfg:vlan-sub-configuration,omitzero"`
+}
+
+type BundleMember struct {
+	ID BundleID `json:"id"`
 }
 
 type Statistics struct {
@@ -29,7 +78,7 @@ type Statistics struct {
 
 type IPv4Network struct {
 	Addresses AddressesIPv4 `json:"addresses"`
-	Mtu       uint16        `json:"mtu"`
+	Mtu       uint16        `json:"mtu,omitzero"`
 }
 
 type AddressesIPv4 struct {
@@ -73,64 +122,157 @@ type MTU struct {
 	Owner string `json:"owner"`
 }
 
-func (i *PhysIf) XPath() string {
+type BundleID struct {
+	BundleID    int32  `json:"bundle-id"`
+	PortAcivity string `json:"port-activity"`
+}
+
+type Bundle struct {
+	MinAct MinimumActive `json:"minimum-active"`
+}
+
+type MinimumActive struct {
+	Links int32 `json:"links"`
+}
+
+type VlanSubInterface struct {
+	VlanIdentifier VlanIdentifier `json:"vlan-identifier"`
+}
+
+type VlanIdentifier struct {
+	FirstTag  int32  `json:"first-tag"`
+	SecondTag int32  `json:"second-tag,omitzero"`
+	VlanType  string `json:"vlan-type"`
+}
+
+func (i *Iface) XPath() string {
 	return fmt.Sprintf("Cisco-IOS-XR-ifmgr-cfg:interface-configurations/interface-configuration[active=act][interface-name=%s]", i.Name)
 }
 
-func (i *PhysIf) String() string {
-	return fmt.Sprintf("Name: %s, Description=%s, ShutDown=%t", i.Name, i.Description, i.Shutdown)
+func (i *Iface) String() string {
+	return fmt.Sprintf("Name: %s, Description=%s", i.Name, i.Description)
 }
 
-type IFaceSpeed string
+type PhysIfState struct {
+	State string `json:"state"`
+	Name  string `json:"-"`
+}
 
-const (
-	Speed10G  IFaceSpeed = "TenGigE"
-	Speed25G  IFaceSpeed = "TwentyFiveGigE"
-	Speed40G  IFaceSpeed = "FortyGigE"
-	Speed100G IFaceSpeed = "HundredGigE"
-)
+func (phys *PhysIfState) XPath() string {
+	// (fixme): hardcoded route processor for the moment
+	return fmt.Sprintf("Cisco-IOS-XR-ifmgr-oper:interface-properties/data-nodes/data-node[data-node-name=0/RP0/CPU0]/system-view/interfaces/interface[interface-name=%s]", phys.Name)
+}
+
+func ExractInterfaceSpeedFromName(ifaceName string) (IFaceSpeed, error) {
+	// Owner of bundle interfaces is 'etherbundle'
+	bundleEtherRE := regexp.MustCompile(`^Bundle-Ether*`)
+	if bundleEtherRE.MatchString(ifaceName) {
+		// For Bundle-Ether interfaces
+		return EtherBundle, nil
+	}
 
-func ExtractMTUOwnerFromIfaceName(ifaceName string) (IFaceSpeed, error) {
 	// Match the port_type in an interface name <port_type>/<rack>/<slot/<module>/<port>
 	// E.g. match TwentyFiveGigE of interface with name TwentyFiveGigE0/0/0/1
 	re := regexp.MustCompile(`^\D*`)
-
-	mtuOwner := string(re.Find([]byte(ifaceName)))
-
-	if mtuOwner == "" {
-		return "", fmt.Errorf("failed to extract MTU owner from interface name %s", ifaceName)
+	speed := string(re.Find([]byte(ifaceName)))
+	if speed == "" {
+		return "", fmt.Errorf("failed to extract speed from interface name %s", ifaceName)
 	}
 
-	switch mtuOwner {
+	switch speed {
 	case string(Speed10G):
 		return Speed10G, nil
 	case string(Speed25G):
 		return Speed25G, nil
 	case string(Speed40G):
-		return Speed25G, nil
+		return Speed40G, nil
 	case string(Speed100G):
 		return Speed100G, nil
 	default:
-		return "", fmt.Errorf("unsupported interface type %s for MTU owner extraction", mtuOwner)
+		return "", fmt.Errorf("unsupported interface type %s§§", speed)
 	}
 }
 
-type PhysIfStateType string
+func CheckInterfaceNameTypeAggregate(name string) error {
+	if name == "" {
+		return errors.New("interface name must not be empty")
+	}
+	// Matches Bundle-Ether<VLAN>[.<VLAN>] or BE<VLAN>[.<VLAN>]
+	re := regexp.MustCompile(`^(Bundle-Ether|BE)(\d+)(\.(\d+))?$`)
+	matches := re.FindStringSubmatch(name)
 
-const (
-	StateUp        PhysIfStateType = "im-state-up"
-	StateDown      PhysIfStateType = "im-state-down"
-	StateNotReady  PhysIfStateType = "im-state-not-ready"
-	StateAdminDown PhysIfStateType = "im-state-admin-down"
-	StateShutDown  PhysIfStateType = "im-state-shutdown"
-)
+	if matches == nil {
+		return fmt.Errorf("unsupported interface format %q, expected one of: %q", name, re.String())
+	}
 
-type PhysIfState struct {
-	State string `json:"state"`
-	Name  string `json:"-"`
+	// Vlan is part of the name
+	if matches[2] == "" {
+		return fmt.Errorf("unsupported interface format %q, expected one of: %q", name, re.String())
+	}
+	// Check outer vlan
+	// fixme: check range up to 65000
+	// err := CheckVlanRange(matches[2])
+
+	// Check inner vlan if we have a subinterface
+	if matches[4] != "" {
+		return CheckVlanRange(matches[4])
+	}
+	return nil
 }
 
-func (phys *PhysIfState) XPath() string {
-	// (fixme): hardcoded route processor for the moment
-	return fmt.Sprintf("Cisco-IOS-XR-ifmgr-oper:interface-properties/data-nodes/data-node[data-node-name=0/RP0/CPU0]/system-view/interfaces/interface[interface-name=%s]", phys.Name)
+func ExtractVlanTagFromName(name string) (vlanID int32, err error) {
+	// TF0/0/0/3.2021 or Te0/0/0/3.2021 or Hun0/0/0/3.2021
+	res := strings.Split(name, ".")
+	switch len(res) {
+	case 1:
+		return 0, nil
+	case 2:
+		vlan, err := strconv.ParseInt(res[1], 10, 32)
+		if err != nil {
+			return 0, fmt.Errorf("failed to parse VLAN ID from interface name %q: %w", name, err)
+		}
+		return int32(vlan), nil
+	default:
+		return 0, fmt.Errorf("unexpected interface name format %q, expected <interface> or <interface>.<vlan>", name)
+	}
+}
+
+func ExtractBundleIdAndVlanTagsFromName(name string) (bundleID, outerVlan int32, err error) {
+	// Matches BE1.1 or Bundle-Ether1.1
+	re := regexp.MustCompile(`^(Bundle-Ether|BE)(\d+)(?:\.(\d+))?$`)
+	matches := re.FindStringSubmatch(name)
+
+	switch len(matches) {
+	case 3:
+		o, err := strconv.ParseInt(matches[2], 10, 32)
+		if err != nil {
+			return 0, 0, fmt.Errorf("failed to parse bundle ID from interface name %q: %w", name, err)
+		}
+		bundleID = int32(o)
+	case 4:
+		o, err := strconv.ParseInt(matches[2], 10, 32)
+		if err != nil {
+			return 0, 0, fmt.Errorf("failed to parse bundle ID from interface name %q: %w", name, err)
+		}
+		i, err := strconv.ParseInt(matches[3], 10, 32)
+		if err != nil {
+			return 0, 0, fmt.Errorf("failed to parse outer VLAN from interface name %q: %w", name, err)
+		}
+		bundleID = int32(o)
+		outerVlan = int32(i)
+	}
+	return bundleID, outerVlan, nil
+}
+
+func CheckVlanRange(vlan string) error {
+	v, err := strconv.Atoi(vlan)
+
+	if err != nil {
+		return fmt.Errorf("failed to parse VLAN %q: %w", vlan, err)
+	}
+
+	if v < 1 || v > 4095 {
+		return fmt.Errorf("VLAN %s is out of range, valid range is 1-4095", vlan)
+	}
+	return nil
 }

internal/provider/cisco/iosxr/intf_test.go

@@ -11,7 +11,7 @@ func init() {
 		Owner: "TwentyFiveGigE",
 	}
 
-	Register("intf", &PhysIf{
+	Register("intf", &Iface{
 		Name:        name,
 		Description: "random interface test",
 		Active:      "act",