feat(controller): add OCP version auto-detection for RAG configuration

Implements logic to automatically detect the OpenShift Cluster Version
and configure the OLS RAG database paths accordingly.

- Adds  to query ClusterVersion API.
- Implements version resolution logic:
  - Exact match for supported versions (e.g., 4.16, 4.18).
  - Fallback to latest for newer/unsupported versions.
  - Allows manual override via CR Spec.
- Updates OpenStackLightspeed Status with detection results.
- Moves version resolution before OLS Operator dependency check to
  provide immediate status feedback.

JIRA: OSPRH-23918

Author: omkarjoshi0304

api/v1beta1/conditions.go

@@ -26,6 +26,9 @@ const (
 	// OpenShift Lightspeed Operator Status=True condition which indicates if OpenShift Lightspeed is installed and
 	// operational and it can be used by OpenStack Lihgtspeed operator.
 	OpenShiftLightspeedOperatorReadyCondition condition.Type = "OpenShiftLightspeedOperatorReady"
+
+	// OCPVersionCondition Status=True condition which indicates OCP version detection and resolution
+	OCPVersionCondition condition.Type = "OCPVersionResolved"
 )
 
 // Common Messages used by API objects.
@@ -44,4 +47,16 @@ const (
 
 	// OpenShiftLigthspeedOperatorReady
 	OpenShiftLightspeedOperatorReady = "OpenShift Lightspeed operator is ready."
+
+	// OCPVersionDetected message when OCP version is detected and resolved successfully
+	OCPVersionDetected = "OCP version detected and resolved successfully"
+
+	// OCPVersionFallback message when using 'latest' OCP documentation as fallback
+	OCPVersionFallback = "Using 'latest' OCP documentation as fallback for unsupported cluster version"
+
+	// OCPVersionOverrideInvalid message when OCP version override is invalid
+	OCPVersionOverrideInvalid = "OCP version override is invalid"
+
+	// OCPVersionDetectionFailed message when OCP version detection fails
+	OCPVersionDetectionFailed = "Failed to detect OCP cluster version"
 )

api/v1beta1/openstacklightspeed_types.go

@@ -37,6 +37,16 @@ type OpenStackLightspeedSpec struct {
 	// +kubebuilder:validation:Optional
 	// ContainerImage for the OpenStack Lightspeed RAG container (will be set to environmental default if empty)
 	RAGImage string `json:"ragImage"`
+
+	// +kubebuilder:validation:Optional
+	// +kubebuilder:default=true
+	// EnableOCPRAG enables automatic OCP documentation based on cluster version
+	EnableOCPRAG bool `json:"enableOCPRAG,omitempty"`
+
+	// +kubebuilder:validation:Optional
+	// OCPVersionOverride allows forcing a specific OCP version instead of auto-detection.
+	// Format should be like "4.15", "4.16", etc.
+	OCPVersionOverride string `json:"ocpVersionOverride,omitempty"`
 }
 
 // OpenStackLightspeedCore defines the desired state of OpenStackLightspeed
@@ -106,12 +116,23 @@ type OpenStackLightspeedStatus struct {
 
 	// ObservedGeneration - the most recent generation observed for this object.
 	ObservedGeneration int64 `json:"observedGeneration,omitempty"`
+
+	// DetectedOCPVersion contains the auto-detected OCP cluster version
+	DetectedOCPVersion string `json:"detectedOCPVersion,omitempty"`
+
+	// ActiveOCPVersion contains the OCP version being used for RAG configuration
+	// Will be one of: "4.16", "4.18", "latest", or empty if OCP RAG is disabled
+	ActiveOCPVersion string `json:"activeOCPVersion,omitempty"`
+
+	// OCPVersionFallback indicates if using 'latest' as fallback for unsupported version
+	OCPVersionFallback bool `json:"ocpVersionFallback,omitempty"`
 }
 
 // +kubebuilder:object:root=true
 // +kubebuilder:subresource:status
 // +kubebuilder:printcolumn:name="Status",type="string",JSONPath=".status.conditions[0].status",description="Status"
 // +kubebuilder:printcolumn:name="Message",type="string",JSONPath=".status.conditions[0].message",description="Message"
+// +kubebuilder:printcolumn:name="OCP Version",type="string",JSONPath=".status.activeOCPVersion"
 
 // OpenStackLightspeed is the Schema for the openstacklightspeeds API
 type OpenStackLightspeed struct {

bundle/manifests/lightspeed.openstack.org_openstacklightspeeds.yaml

@@ -23,6 +23,9 @@ spec:
       jsonPath: .status.conditions[0].message
       name: Message
       type: string
+    - jsonPath: .status.activeOCPVersion
+      name: OCP Version
+      type: string
     name: v1beta1
     schema:
       openAPIV3Schema:
@@ -58,6 +61,11 @@ spec:
                 description: Namespace where the CatalogSource containing the OLS
                   operator is located
                 type: string
+              enableOCPRAG:
+                default: true
+                description: EnableOCPRAG enables automatic OCP documentation based
+                  on cluster version
+                type: boolean
               feedbackDisabled:
                 description: Disable feedback collection
                 type: boolean
@@ -99,6 +107,11 @@ spec:
                 description: Name of the model to use at the API endpoint provided
                   in LLMEndpoint
                 type: string
+              ocpVersionOverride:
+                description: |-
+                  OCPVersionOverride allows forcing a specific OCP version instead of auto-detection.
+                  Format should be like "4.15", "4.16", etc.
+                type: string
               ragImage:
                 description: ContainerImage for the OpenStack Lightspeed RAG container
                   (will be set to environmental default if empty)
@@ -118,6 +131,11 @@ spec:
           status:
             description: OpenStackLightspeedStatus defines the observed state of OpenStackLightspeed
             properties:
+              activeOCPVersion:
+                description: |-
+                  ActiveOCPVersion contains the OCP version being used for RAG configuration
+                  Will be one of: "4.16", "4.18", "latest", or empty if OCP RAG is disabled
+                type: string
               conditions:
                 description: Conditions
                 items:
@@ -160,11 +178,19 @@ spec:
                   - type
                   type: object
                 type: array
+              detectedOCPVersion:
+                description: DetectedOCPVersion contains the auto-detected OCP cluster
+                  version
+                type: string
               observedGeneration:
                 description: ObservedGeneration - the most recent generation observed
                   for this object.
                 format: int64
                 type: integer
+              ocpVersionFallback:
+                description: OCPVersionFallback indicates if using 'latest' as fallback
+                  for unsupported version
+                type: boolean
             type: object
         type: object
     served: true

bundle/manifests/openstack-lightspeed-operator.clusterserviceversion.yaml

@@ -81,6 +81,13 @@ spec:
     spec:
       clusterPermissions:
       - rules:
+        - apiGroups:
+          - config.openshift.io
+          resources:
+          - clusterversions
+          verbs:
+          - get
+          - list
         - apiGroups:
           - lightspeed.openstack.org
           resources:

config/crd/bases/lightspeed.openstack.org_openstacklightspeeds.yaml

@@ -23,6 +23,9 @@ spec:
       jsonPath: .status.conditions[0].message
       name: Message
       type: string
+    - jsonPath: .status.activeOCPVersion
+      name: OCP Version
+      type: string
     name: v1beta1
     schema:
       openAPIV3Schema:
@@ -58,6 +61,11 @@ spec:
                 description: Namespace where the CatalogSource containing the OLS
                   operator is located
                 type: string
+              enableOCPRAG:
+                default: true
+                description: EnableOCPRAG enables automatic OCP documentation based
+                  on cluster version
+                type: boolean
               feedbackDisabled:
                 description: Disable feedback collection
                 type: boolean
@@ -99,6 +107,11 @@ spec:
                 description: Name of the model to use at the API endpoint provided
                   in LLMEndpoint
                 type: string
+              ocpVersionOverride:
+                description: |-
+                  OCPVersionOverride allows forcing a specific OCP version instead of auto-detection.
+                  Format should be like "4.15", "4.16", etc.
+                type: string
               ragImage:
                 description: ContainerImage for the OpenStack Lightspeed RAG container
                   (will be set to environmental default if empty)
@@ -118,6 +131,11 @@ spec:
           status:
             description: OpenStackLightspeedStatus defines the observed state of OpenStackLightspeed
             properties:
+              activeOCPVersion:
+                description: |-
+                  ActiveOCPVersion contains the OCP version being used for RAG configuration
+                  Will be one of: "4.16", "4.18", "latest", or empty if OCP RAG is disabled
+                type: string
               conditions:
                 description: Conditions
                 items:
@@ -160,11 +178,19 @@ spec:
                   - type
                   type: object
                 type: array
+              detectedOCPVersion:
+                description: DetectedOCPVersion contains the auto-detected OCP cluster
+                  version
+                type: string
               observedGeneration:
                 description: ObservedGeneration - the most recent generation observed
                   for this object.
                 format: int64
                 type: integer
+              ocpVersionFallback:
+                description: OCPVersionFallback indicates if using 'latest' as fallback
+                  for unsupported version
+                type: boolean
             type: object
         type: object
     served: true

config/rbac/role.yaml

@@ -4,6 +4,13 @@ kind: ClusterRole
 metadata:
   name: manager-role
 rules:
+- apiGroups:
+  - config.openshift.io
+  resources:
+  - clusterversions
+  verbs:
+  - get
+  - list
 - apiGroups:
   - lightspeed.openstack.org
   resources:

internal/controller/funcs.go

@@ -137,11 +137,38 @@ func GetOLSConfig(ctx context.Context, helper *common_helper.Helper) (uns.Unstru
 		"OLSConfig")
 }
 
+// BuildRAGConfigs builds the RAG configuration array with priorities.
+// OpenStack RAG is always included with priority 1.
+// OCP RAG is added with priority 2 if ocpVersion is provided.
+func BuildRAGConfigs(instance *apiv1beta1.OpenStackLightspeed, ocpVersion string) []map[string]interface{} {
+	rags := []map[string]interface{}{
+		// OpenStack RAG - Priority 1
+		{
+			"image":     instance.Spec.RAGImage,
+			"indexPath": OpenStackLightspeedVectorDBPath,
+			"priority":  1,
+		},
+	}
+
+	// Add OCP RAG if enabled
+	if ocpVersion != "" {
+		rags = append(rags, map[string]interface{}{
+			"image":     instance.Spec.RAGImage,
+			"indexPath": GetOCPVectorDBPath(ocpVersion),
+			"indexID":   GetOCPIndexName(ocpVersion),
+			"priority":  2,
+		})
+	}
+
+	return rags
+}
+
 // PatchOLSConfig patches OLSConfig with information from OpenStackLightspeed instance.
 func PatchOLSConfig(
 	helper *common_helper.Helper,
 	instance *apiv1beta1.OpenStackLightspeed,
 	olsConfig *uns.Unstructured,
+	ocpVersion string,
 ) error {
 	// Patch the Providers section
 	providersPatch := []interface{}{
@@ -187,17 +214,14 @@ func PatchOLSConfig(
 	}
 
 	// Patch the RAG section
-	// NOTE(lucasagomes): We don't need indexID here because the tag on our RAG images
-	// already matches the indexID that the Vector DB used when it was built. OLS leverages
-	// that to set the right index.
-	openstackRAG := []interface{}{
-		map[string]interface{}{
-			"image":     instance.Spec.RAGImage,
-			"indexPath": OpenStackLightspeedVectorDBPath,
-		},
+	// Build RAG array with priorities using BuildRAGConfigs
+	ragConfigs := BuildRAGConfigs(instance, ocpVersion)
+	ragSlice := make([]interface{}, len(ragConfigs))
+	for i, rag := range ragConfigs {
+		ragSlice[i] = rag
 	}
 
-	if err := uns.SetNestedSlice(olsConfig.Object, openstackRAG, "spec", "ols", "rag"); err != nil {
+	if err := uns.SetNestedSlice(olsConfig.Object, ragSlice, "spec", "ols", "rag"); err != nil {
 		return err
 	}