Use constants for annotations and features

Author: ciarams87

internal/controller/manager.go

@@ -36,6 +36,7 @@ import (
 	gatewayv1 "sigs.k8s.io/gateway-api/apis/v1"
 	gatewayv1alpha2 "sigs.k8s.io/gateway-api/apis/v1alpha2"
 	gatewayv1beta1 "sigs.k8s.io/gateway-api/apis/v1beta1"
+	"sigs.k8s.io/gateway-api/pkg/consts"
 
 	ngfAPIv1alpha1 "github.com/nginx/nginx-gateway-fabric/v2/apis/v1alpha1"
 	ngfAPIv1alpha2 "github.com/nginx/nginx-gateway-fabric/v2/apis/v1alpha2"
@@ -493,7 +494,7 @@ func registerControllers(
 			options: []controller.Option{
 				controller.WithOnlyMetadata(),
 				controller.WithK8sPredicate(
-					predicate.AnnotationPredicate{Annotation: graph.BundleVersionAnnotation},
+					predicate.AnnotationPredicate{Annotation: consts.BundleVersionAnnotation},
 				),
 			},
 		},

internal/controller/state/change_processor.go

@@ -15,6 +15,7 @@ import (
 	v1 "sigs.k8s.io/gateway-api/apis/v1"
 	"sigs.k8s.io/gateway-api/apis/v1alpha2"
 	"sigs.k8s.io/gateway-api/apis/v1beta1"
+	"sigs.k8s.io/gateway-api/pkg/consts"
 
 	ngfAPIv1alpha1 "github.com/nginx/nginx-gateway-fabric/v2/apis/v1alpha1"
 	ngfAPIv1alpha2 "github.com/nginx/nginx-gateway-fabric/v2/apis/v1alpha2"
@@ -63,6 +64,8 @@ type ChangeProcessorConfig struct {
 	GatewayCtlrName string
 	// GatewayClassName is the name of the GatewayClass resource.
 	GatewayClassName string
+	// ExperimentalFeatures indicates if experimental features are enabled.
+	ExperimentalFeatures bool
 }
 
 // ChangeProcessorImpl is an implementation of ChangeProcessor.
@@ -190,7 +193,7 @@ func NewChangeProcessorImpl(cfg ChangeProcessorConfig) *ChangeProcessorImpl {
 			{
 				gvk:       cfg.MustExtractGVK(&apiext.CustomResourceDefinition{}),
 				store:     newObjectStoreMapAdapter(clusterStore.CRDMetadata),
-				predicate: annotationChangedPredicate{annotation: graph.BundleVersionAnnotation},
+				predicate: annotationChangedPredicate{annotation: consts.BundleVersionAnnotation},
 			},
 			{
 				gvk:       cfg.MustExtractGVK(&ngfAPIv1alpha2.NginxProxy{}),
@@ -275,6 +278,7 @@ func (c *ChangeProcessorImpl) Process() *graph.Graph {
 		c.cfg.PlusSecrets,
 		c.cfg.Validators,
 		c.cfg.Logger,
+		c.cfg.ExperimentalFeatures,
 	)
 
 	return c.latestGraph

internal/controller/state/change_processor_test.go

@@ -18,6 +18,7 @@ import (
 	v1 "sigs.k8s.io/gateway-api/apis/v1"
 	"sigs.k8s.io/gateway-api/apis/v1alpha2"
 	"sigs.k8s.io/gateway-api/apis/v1beta1"
+	"sigs.k8s.io/gateway-api/pkg/consts"
 
 	ngfAPIv1alpha1 "github.com/nginx/nginx-gateway-fabric/v2/apis/v1alpha1"
 	ngfAPIv1alpha2 "github.com/nginx/nginx-gateway-fabric/v2/apis/v1alpha2"
@@ -666,13 +667,13 @@ var _ = Describe("ChangeProcessor", func() {
 					ObjectMeta: metav1.ObjectMeta{
 						Name: "gatewayclasses.gateway.networking.k8s.io",
 						Annotations: map[string]string{
-							graph.BundleVersionAnnotation: graph.SupportedVersion,
+							consts.BundleVersionAnnotation: consts.BundleVersion,
 						},
 					},
 				}
 
 				gatewayAPICRDUpdated = gatewayAPICRD.DeepCopy()
-				gatewayAPICRDUpdated.Annotations[graph.BundleVersionAnnotation] = "v1.99.0"
+				gatewayAPICRDUpdated.Annotations[consts.BundleVersionAnnotation] = "v1.99.0"
 			})
 			BeforeEach(func() {
 				expRouteHR1 = &graph.L7Route{
@@ -1556,7 +1557,7 @@ var _ = Describe("ChangeProcessor", func() {
 					}
 
 					expGraph.GatewayClass.Conditions = conditions.NewGatewayClassSupportedVersionBestEffort(
-						graph.SupportedVersion,
+						consts.BundleVersion,
 					)
 
 					processAndValidateGraph(expGraph)
@@ -1574,7 +1575,7 @@ var _ = Describe("ChangeProcessor", func() {
 					}
 
 					expGraph.GatewayClass.Conditions = conditions.NewGatewayClassSupportedVersionBestEffort(
-						graph.SupportedVersion,
+						consts.BundleVersion,
 					)
 
 					graphCfg := processor.Process()

internal/controller/state/graph/gatewayclass.go

@@ -8,18 +8,13 @@ import (
 	"k8s.io/apimachinery/pkg/util/validation/field"
 	"sigs.k8s.io/controller-runtime/pkg/client"
 	v1 "sigs.k8s.io/gateway-api/apis/v1"
+	"sigs.k8s.io/gateway-api/pkg/consts"
+	"sigs.k8s.io/gateway-api/pkg/features"
 
 	"github.com/nginx/nginx-gateway-fabric/v2/internal/controller/state/conditions"
 	"github.com/nginx/nginx-gateway-fabric/v2/internal/framework/kinds"
 )
 
-const (
-	// BundleVersionAnnotation is the annotation on Gateway API CRDs that contains the installed version.
-	BundleVersionAnnotation = "gateway.networking.k8s.io/bundle-version"
-	// SupportedVersion is the supported version of the Gateway API CRDs.
-	SupportedVersion = "v1.4.0"
-)
-
 var gatewayCRDs = map[string]apiVersion{
 	"gatewayclasses.gateway.networking.k8s.io":     {},
 	"gateways.gateway.networking.k8s.io":           {},
@@ -40,6 +35,10 @@ type GatewayClass struct {
 	Conditions []conditions.Condition
 	// Valid shows whether the GatewayClass is valid.
 	Valid bool
+	// Experimental indicates whether experimental features are supported.
+	// This is true only when BOTH the ExperimentalFeatures config flag is enabled
+	// AND the Gateway API CRDs have the experimental channel annotation.
+	Experimental bool
 }
 
 // processedGatewayClasses holds the resources that belong to NGF.
@@ -82,6 +81,7 @@ func buildGatewayClass(
 	gc *v1.GatewayClass,
 	nps map[types.NamespacedName]*NginxProxy,
 	crdVersions map[types.NamespacedName]*metav1.PartialObjectMetadata,
+	experimentalEnabled bool,
 ) *GatewayClass {
 	if gc == nil {
 		return nil
@@ -92,13 +92,17 @@ func buildGatewayClass(
 		np = getNginxProxyForGatewayClass(*gc.Spec.ParametersRef, nps)
 	}
 
-	conds, valid := validateGatewayClass(gc, np, crdVersions)
+	conds, valid, crdExperimental := validateGatewayClass(gc, np, crdVersions)
+
+	// Experimental features are enabled only if both the config flag AND CRD channel are experimental
+	experimental := experimentalEnabled && crdExperimental
 
 	return &GatewayClass{
-		Source:     gc,
-		NginxProxy: np,
-		Valid:      valid,
-		Conditions: conds,
+		Source:       gc,
+		NginxProxy:   np,
+		Valid:        valid,
+		Conditions:   conds,
+		Experimental: experimental,
 	}
 }
 
@@ -144,14 +148,14 @@ func validateGatewayClass(
 	gc *v1.GatewayClass,
 	npCfg *NginxProxy,
 	crdVersions map[types.NamespacedName]*metav1.PartialObjectMetadata,
-) ([]conditions.Condition, bool) {
+) ([]conditions.Condition, bool, bool) {
 	var conds []conditions.Condition
 
-	supportedVersionConds, versionsValid := validateCRDVersions(crdVersions)
+	supportedVersionConds, versionsValid, experimental := validateCRDVersions(crdVersions)
 	conds = append(conds, supportedVersionConds...)
 
 	if gc.Spec.ParametersRef == nil {
-		return conds, versionsValid
+		return conds, versionsValid, experimental
 	}
 
 	path := field.NewPath("spec").Child("parametersRef")
@@ -160,7 +164,7 @@ func validateGatewayClass(
 	// return early since parametersRef isn't valid
 	if len(refConds) > 0 {
 		conds = append(conds, refConds...)
-		return conds, versionsValid
+		return conds, versionsValid, experimental
 	}
 
 	if npCfg == nil {
@@ -171,7 +175,7 @@ func validateGatewayClass(
 				field.NotFound(path.Child("name"), gc.Spec.ParametersRef.Name).Error(),
 			),
 		)
-		return conds, versionsValid
+		return conds, versionsValid, experimental
 	}
 
 	if !npCfg.Valid {
@@ -181,10 +185,10 @@ func validateGatewayClass(
 			conditions.NewGatewayClassRefInvalid(msg),
 			conditions.NewGatewayClassInvalidParameters(msg),
 		)
-		return conds, versionsValid
+		return conds, versionsValid, experimental
 	}
 
-	return append(conds, conditions.NewGatewayClassResolvedRefs()), versionsValid
+	return append(conds, conditions.NewGatewayClassResolvedRefs()), versionsValid, experimental
 }
 
 var supportedParamKinds = map[string]struct{}{
@@ -198,9 +202,9 @@ type apiVersion struct {
 
 func validateCRDVersions(
 	crdMetadata map[types.NamespacedName]*metav1.PartialObjectMetadata,
-) (conds []conditions.Condition, valid bool) {
-	installedAPIVersions := getBundleVersions(crdMetadata)
-	supportedAPIVersion := parseVersionString(SupportedVersion)
+) (conds []conditions.Condition, valid bool, experimental bool) {
+	installedAPIVersions, channels := getBundleVersions(crdMetadata)
+	supportedAPIVersion := parseVersionString(consts.BundleVersion)
 
 	var unsupported, bestEffort bool
 
@@ -212,15 +216,23 @@ func validateCRDVersions(
 		}
 	}
 
+	// Check if any CRD is using experimental channel
+	for _, ch := range channels {
+		if ch == features.FeatureChannelExperimental {
+			experimental = true
+			break
+		}
+	}
+
 	if unsupported {
-		return conditions.NewGatewayClassUnsupportedVersion(SupportedVersion), false
+		return conditions.NewGatewayClassUnsupportedVersion(consts.BundleVersion), false, experimental
 	}
 
 	if bestEffort {
-		return conditions.NewGatewayClassSupportedVersionBestEffort(SupportedVersion), true
+		return conditions.NewGatewayClassSupportedVersionBestEffort(consts.BundleVersion), true, experimental
 	}
 
-	return nil, true
+	return nil, true, experimental
 }
 
 func parseVersionString(version string) apiVersion {
@@ -245,15 +257,25 @@ func parseVersionString(version string) apiVersion {
 	}
 }
 
-func getBundleVersions(crdMetadata map[types.NamespacedName]*metav1.PartialObjectMetadata) []apiVersion {
+func getBundleVersions(
+	crdMetadata map[types.NamespacedName]*metav1.PartialObjectMetadata,
+) ([]apiVersion, []features.FeatureChannel) {
 	versions := make([]apiVersion, 0, len(gatewayCRDs))
+	channels := make([]features.FeatureChannel, 0, len(gatewayCRDs))
 
 	for nsname, md := range crdMetadata {
 		if _, ok := gatewayCRDs[nsname.Name]; ok {
-			bundleVersion := md.Annotations[BundleVersionAnnotation]
+			bundleVersion := md.Annotations[consts.BundleVersionAnnotation]
 			versions = append(versions, parseVersionString(bundleVersion))
+
+			// Default to standard channel if annotation is missing
+			ch := md.Annotations[consts.ChannelAnnotation]
+			if ch == "" {
+				ch = string(features.FeatureChannelStandard)
+			}
+			channels = append(channels, features.FeatureChannel(ch))
 		}
 	}
 
-	return versions
+	return versions, channels
 }