feat: define CRDs for VRF type

In this commit we define VRF type. A VRF is composed by a single route
distinguisher (RD), and a set of route targets (RTs). Each route target
is composed by the address families it affects, an action for it (e.g.,
import or export), and wether the RT is to be applied to the EVPN
context.

Author: nikatza

api/v1alpha1/vrf_types.go

@@ -0,0 +1,121 @@
+// 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"
+)
+
+// VRFSpec defines the basic structure of a Virtual Routing and Forwarding (VRF) instance/context. A single VRF instance
+// has a single Route Distinguisher (RD) and a set of Route Targets (RT). RTs control the import and export of routes
+// among different VRFs.
+type VRFSpec struct {
+	// Name defines the name of the VRF.
+	//
+	// +required
+	Name *string `json:"foo,omitempty"`
+
+	// RD defines the Route Distinguisher (RD) for the VRF as per RFC 4364
+	//
+	// +kubebuilder:validation:Pattern=`^([0-9]+:[0-9]+|([0-9]{1,3}\.){3}[0-9]{1,3}:[0-9]+)$`
+	RD *string `json:"routeDistinguisher,omitempty"`
+
+	// RTs defines the list of Route Targets (RTs) associated with the VRF.
+
+	RTs []RouteTarget `json:"routeTargets,omitempty"`
+}
+
+// VRFStatus defines the observed state of VRF.
+type VRFStatus struct {
+	// INSERT ADDITIONAL STATUS FIELD - define observed state of cluster
+	// Important: Run "make" to regenerate code after modifying this file
+	// The conditions are a list of status objects that describe the state of the Interface.
+	//+listType=map
+	//+listMapKey=type
+	//+patchStrategy=merge
+	//+patchMergeKey=type
+	//+optional
+	Conditions []metav1.Condition `json:"conditions,omitempty" patchStrategy:"merge" patchMergeKey:"type"`
+}
+
+// +kubebuilder:object:root=true
+// +kubebuilder:subresource:status
+
+// VRF is the Schema for the vrves API
+type VRF struct {
+	metav1.TypeMeta `json:",inline"`
+
+	// metadata is a standard object metadata
+	// +optional
+	metav1.ObjectMeta `json:"metadata,omitempty,omitzero"`
+
+	// spec defines the desired state of VRF
+	// +required
+	Spec VRFSpec `json:"spec"`
+
+	// status defines the observed state of VRF
+	// +optional
+	Status VRFStatus `json:"status,omitempty,omitzero"`
+}
+
+// +kubebuilder:object:root=true
+
+// VRFList contains a list of VRF
+type VRFList struct {
+	metav1.TypeMeta `json:",inline"`
+	metav1.ListMeta `json:"metadata,omitempty"`
+	Items           []VRF `json:"items"`
+}
+
+// RouteTarget defines the structure for a single route target in a VRF.
+type RouteTarget struct {
+
+	// Value specifies the Route Target (RT) value as per RFC 4364.
+	//
+	// +kubebuilder:validation:Pattern=`^([0-9]+:[0-9]+|([0-9]{1,3}\.){3}[0-9]{1,3}:[0-9]+)$`
+	Value string `json:"value,omitempty"`
+
+	// AddressFamily specifies the address families for the Route Target.
+	//
+	// +kubebuilder:validation:Enum=ipv4;ipv6
+	// +kubebuilder:validation:XValidation:rule="self.addressFamily == null || self.addressFamily.size() == self.addressFamily.distinct().size()",message="addressFamily must not contain duplicates"
+	AddressFamilies []AddressFamily `json:"addressFamily,omitempty"`
+
+	// Action specifies the action to be taken for the Route Target.
+	//
+	// +kubebuilder:validation:Enum=none;import;export;both
+	Action RTAction `json:"action,omitempty"`
+
+	// EVPN specifies whether we should also add -or not- the EVPN route-target
+	//
+	// +kubebuilder:validation:Enum=add;ignore
+	EVPN EVPNAction `json:"evpn,omitempty"`
+}
+
+type AddressFamily string
+
+const (
+	AddressFamilyIPv4 AddressFamily = "ipv4"
+	AddressFamilyIPv6 AddressFamily = "ipv6"
+)
+
+type RTAction string
+
+const (
+	RTNone   RTAction = "none"
+	RTImport RTAction = "import"
+	RTExport RTAction = "export"
+	RTBoth   RTAction = "both"
+)
+
+type EVPNAction string
+
+const (
+	EVPNAdd    EVPNAction = "add"
+	EVPNIgnore EVPNAction = "ignore"
+)
+
+func init() {
+	SchemeBuilder.Register(&VRF{}, &VRFList{})
+}