Add API types for Cisco vPCs

Author: nikatza

PROJECT

@@ -118,4 +118,13 @@ resources:
   kind: ISIS
   path: github.com/ironcore-dev/network-operator/api/v1alpha1
   version: v1alpha1
+- api:
+    crdVersion: v1
+    namespaced: true
+  controller: true
+  domain: cloud.sap
+  group: networking
+  kind: NXOSVPC
+  path: github.com/ironcore-dev/network-operator/api/v1alpha1
+  version: v1alpha1
 version: "3"

api/v1alpha1/nxosvpc_types.go

@@ -0,0 +1,169 @@
+// SPDX-FileCopyrightText: 2025 SAP SE or an SAP affiliate company and IronCore contributors
+// SPDX-License-Identifier: Apache-2.0
+
+package v1alpha1
+
+import (
+	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
+)
+
+// kind: NXOSVirtualPortchannel
+
+// spec:
+//   id: 69
+//   rolePriority: 100
+//   systemPriority: 10
+//   delayRestore: 150
+
+//   peer:
+//     switch:
+//       enabled: true
+//     gateway:
+//       enabled: true
+//     router: # layer3 peer-router
+//       enabled: true
+//     keepalive:
+//       source: 10.114.235.155
+//       destination: 10.114.235.156
+//     autoRecovery:
+//       reloadDelay: 360
+//   fastConvergence:
+//     enabled: true
+//   peerLinkRef: # could also go into peer.linkRef
+//     - name: ora-sw1101a-bb101-po104
+
+// NXOSVPCSpec defines the desired state of NXOSVPC (Cisco's NXOS Virtual Port Channel)
+type NXOSVPCSpec struct {
+	// DeviceName is the name of the Device this object belongs to. The Device object must exist in the same namespace.
+	// Immutable.
+	// +required
+	// +kubebuilder:validation:XValidation:rule="self == oldSelf",message="DeviceRef is immutable"
+	DeviceRef LocalObjectReference `json:"deviceRef"`
+
+	// ID is the vPC domain ID.
+	// +required
+	// +kubebuilder:validation:Minimum=1
+	// +kubebuilder:validation:Maximum=1000
+	DomainID int32 `json:"domainId"`
+
+	// AdminState is the administrative state of the vPC domain.
+	// +optional
+	// +kubebuilder:default="enabled"
+	AdminState string `json:"adminState,omitempty"`
+
+	// RolePriority is the role priority for this vPC domain.
+	// +optional
+	// +kubebuilder:validation:Minimum=1
+	// +kubebuilder:validation:Maximum=65535
+	RolePriority int32 `json:"rolePriority,omitempty"`
+
+	// SystemPriority is the system priority for this vPC domain.
+	// +optional
+	// +kubebuilder:validation:Minimum=1
+	// +kubebuilder:validation:Maximum=65535
+	SystemPriority int32 `json:"systemPriority,omitempty"`
+
+	// DelayRestoreSVI is the delay in bringing up bringing-up the interface-vlan
+	// +optional
+	// +kubebuilder:validation:Minimum=1
+	// +kubebuilder:validation:Maximum=3600
+	DelayRestoreSVI int32 `json:"delayRestoreSVI,omitempty"`
+
+	// DelayRestoreVPC is the delay in bringing up the vPC links after restoring the peer-link
+	// +optional
+	// +kubebuilder:validation:Minimum=1
+	// +kubebuilder:validation:Maximum=3600
+	DelayRestoreVPC int32 `json:"delayRestoreVPC,omitempty"`
+
+	// +optional
+	FastConvergence AdminSt `json:"fastConvergence,omitzero"`
+
+	// +optional
+	Peer Peer `json:"peer,omitzero"`
+}
+
+// AdminSt represents administrative state (enabled/disabled)
+type AdminSt struct {
+	// +required
+	Enabled bool `json:"enabled"`
+}
+
+type Peer struct {
+	// TODO
+	//LinkRef   []LocalObjectReference `json:"linkRef,omitempty"`
+	// +optional
+	KeepAlive    KeepAlive    `json:"keepalive,omitzero"`
+	AutoRecovery AutoRecovery `json:"autoRecovery"`
+	PeerSwitch   AdminSt      `json:"peerSwitch"`
+	PeerGateway  AdminSt      `json:"peerGateway"`
+	// Router defines layer3 peer-router settings
+	Router AdminSt `json:"router"`
+}
+
+type KeepAlive struct {
+	// Source IP address for keepalive messages
+	// +kubebuilder:validation:MinLength=1
+	// +kubebuilder:validation:MaxLength=253
+	Source string `json:"source,omitempty"`
+	// Destination IP address for keepalive messages
+	// +kubebuilder:validation:MinLength=1
+	// +kubebuilder:validation:MaxLength=253
+	Destination string `json:"destination,omitempty"`
+}
+
+type AutoRecovery struct {
+	Enabled bool `json:"enabled,omitempty"`
+	// +optional
+	// +kubebuilder:validation:Minimum=60
+	// +kubebuilder:validation:Maximum=3600
+	ReloadDelay uint32 `json:"reloadDelay,omitempty"`
+}
+
+// NXOSVPCStatus defines the observed state of NXOSVPC.
+type NXOSVPCStatus struct {
+	// The conditions are a list of status objects that describe the state of the VPC.
+	//+listType=map
+	//+listMapKey=type
+	//+patchStrategy=merge
+	//+patchMergeKey=type
+	//+optional
+	Conditions []metav1.Condition `json:"conditions,omitempty"`
+}
+
+// +kubebuilder:object:root=true
+// +kubebuilder:subresource:status
+// +kubebuilder:resource:path=nxosvpcs
+// +kubebuilder:resource:singular=nxosvpc
+// +kubebuilder:resource:shortName=vpc
+// +kubebuilder:printcolumn:name="Domain",type=string,JSONPath=`.spec.domainId`
+// +kubebuilder:printcolumn:name="AdminState",type=string,JSONPath=`.spec.adminState`
+// +kubebuilder:printcolumn:name="Device",type=string,JSONPath=`.spec.deviceRef.name`
+// +kubebuilder:printcolumn:name="Ready",type=string,JSONPath=`.status.conditions[?(@.type=="Ready")].status`
+// +kubebuilder:printcolumn:name="Age",type="date",JSONPath=".metadata.creationTimestamp"
+
+// NXOSVPC is the Schema for the nxosvpcs API
+type NXOSVPC struct {
+	metav1.TypeMeta   `json:",inline"`
+	metav1.ObjectMeta `json:"metadata,omitempty"`
+
+	// spec defines the desired state of NXOSVPC
+	// +required
+	Spec NXOSVPCSpec `json:"spec,omitempty"`
+
+	// status defines the observed state of NXOSVPC
+	// +optional
+	Status NXOSVPCStatus `json:"status,omitempty,omitzero"`
+}
+
+// +kubebuilder:object:root=true
+
+// NXOSVPCList contains a list of NXOSVPC
+type NXOSVPCList struct {
+	metav1.TypeMeta `json:",inline"`
+	metav1.ListMeta `json:"metadata,omitempty"`
+	Items           []NXOSVPC `json:"items"`
+}
+
+func init() {
+	SchemeBuilder.Register(&NXOSVPC{}, &NXOSVPCList{})
+}