api: update networkInterfaces, add Lldp

Author: xkonni

api/v1alpha1/common_types.go

@@ -12,6 +12,8 @@ import (
 )
 
 // IP is an IP address.
+// +kubebuilder:validation:Type=string
+// +kubebuilder:validation:Format=ip
 type IP struct {
 	netip.Addr `json:"-"`
 }

api/v1alpha1/server_types.go

@@ -232,6 +232,10 @@ type ServerStatus struct {
 	// +optional
 	Storages []Storage `json:"storages,omitempty"`
 
+	// LLDPInterfaces is a list of LLDP-enabled network interfaces with their neighbors.
+	// +optional
+	LLDPInterfaces []LLDPInterface `json:"lldpInterfaces,omitempty"`
+
 	// Conditions represents the latest available observations of the server's current state.
 	// +patchStrategy=merge
 	// +patchMergeKey=type
@@ -288,12 +292,66 @@ type NetworkInterface struct {
 	// The type is specified as string and is schemaless.
 	// +kubebuilder:validation:Type=string
 	// +kubebuilder:validation:Schemaless
-	// +required
-	IP IP `json:"ip"`
+	// +optional
+	IP *IP `json:"ip,omitempty"`
+
+	// IPv6 is an array of IPv6 addresses assigned to the network interface.
+	// +optional
+	IPv6 []IP `json:"ipv6,omitempty"`
 
 	// MACAddress is the MAC address of the network interface.
 	// +required
 	MACAddress string `json:"macAddress"`
+
+	// Status is the operational status of the network interface.
+	// +optional
+	Status string `json:"status,omitempty"`
+}
+
+// LLDPNeighbor defines the details of an LLDP neighbor.
+type LLDPNeighbor struct {
+	// MACAddress is the MAC address of the LLDP neighbor.
+	// +optional
+	MACAddress string `json:"macAddress,omitempty"`
+
+	// PortID is the port identifier of the LLDP neighbor.
+	// +optional
+	PortID string `json:"portID,omitempty"`
+
+	// PortDescription is the port description of the LLDP neighbor.
+	// +optional
+	PortDescription string `json:"portDescription,omitempty"`
+
+	// SystemName is the system name of the LLDP neighbor.
+	// +optional
+	SystemName string `json:"systemName,omitempty"`
+
+	// SystemDescription is the system description of the LLDP neighbor.
+	// +optional
+	SystemDescription string `json:"systemDescription,omitempty"`
+
+	// EnabledCapabilities represents the enabled capabilities of the LLDP neighbor.
+	// +optional
+	EnabledCapabilities int `json:"enabledCapabilities,omitempty"`
+}
+
+// LLDPInterface defines the details of an LLDP-enabled network interface.
+type LLDPInterface struct {
+	// InterfaceIndex is the index of the network interface.
+	// +optional
+	InterfaceIndex int `json:"interfaceIndex,omitempty"`
+
+	// InterfaceName is the name of the network interface.
+	// +optional
+	InterfaceName string `json:"interfaceName,omitempty"`
+
+	// InterfaceAlternativeNames contains alternative names for the interface.
+	// +optional
+	InterfaceAlternativeNames []string `json:"interfaceAlternativeNames,omitempty"`
+
+	// Neighbors contains the LLDP neighbors discovered on this interface.
+	// +optional
+	Neighbors []LLDPNeighbor `json:"neighbors,omitempty"`
 }
 
 // StorageDrive defines the details of one storage drive

api/v1alpha1/zz_generated.deepcopy.go

@@ -446,6 +446,59 @@ spec:
                 description: IndicatorLED specifies the current state of the server's
                   indicator LED.
                 type: string
+              lldpInterfaces:
+                description: LLDPInterfaces is a list of LLDP-enabled network interfaces
+                  with their neighbors.
+                items:
+                  description: LLDPInterface defines the details of an LLDP-enabled
+                    network interface.
+                  properties:
+                    interfaceAlternativeNames:
+                      description: InterfaceAlternativeNames contains alternative
+                        names for the interface.
+                      items:
+                        type: string
+                      type: array
+                    interfaceIndex:
+                      description: InterfaceIndex is the index of the network interface.
+                      type: integer
+                    interfaceName:
+                      description: InterfaceName is the name of the network interface.
+                      type: string
+                    neighbors:
+                      description: Neighbors contains the LLDP neighbors discovered
+                        on this interface.
+                      items:
+                        description: LLDPNeighbor defines the details of an LLDP neighbor.
+                        properties:
+                          enabledCapabilities:
+                            description: EnabledCapabilities represents the enabled
+                              capabilities of the LLDP neighbor.
+                            type: integer
+                          macAddress:
+                            description: MACAddress is the MAC address of the LLDP
+                              neighbor.
+                            type: string
+                          portDescription:
+                            description: PortDescription is the port description of
+                              the LLDP neighbor.
+                            type: string
+                          portID:
+                            description: PortID is the port identifier of the LLDP
+                              neighbor.
+                            type: string
+                          systemDescription:
+                            description: SystemDescription is the system description
+                              of the LLDP neighbor.
+                            type: string
+                          systemName:
+                            description: SystemName is the system name of the LLDP
+                              neighbor.
+                            type: string
+                        type: object
+                      type: array
+                  type: object
+                type: array
               manufacturer:
                 description: Manufacturer is the name of the server manufacturer.
                 type: string
@@ -463,14 +516,24 @@ spec:
                         IP is the IP address assigned to the network interface.
                         The type is specified as string and is schemaless.
                       type: string
+                    ipv6:
+                      description: IPv6 is an array of IPv6 addresses assigned to
+                        the network interface.
+                      items:
+                        format: ip
+                        type: string
+                      type: array
                     macAddress:
                       description: MACAddress is the MAC address of the network interface.
                       type: string
                     name:
                       description: Name is the name of the network interface.
                       type: string
+                    status:
+                      description: Status is the operational status of the network
+                        interface.
+                      type: string
                   required:
-                  - ip
                   - macAddress
                   - name
                   type: object