fix(apiserver): register OpenAPI v2 spec for aggregation (#1803)

* fix(apiserver): register OpenAPI v2 spec for aggregation

Signed-off-by: Himanshu Singh <himansh.singh3@gmail.com>

* fix(apiserver): initialize OpenAPI specs before applyTo and enforce v3 version

This commit addresses OpenAPI spec generation issues by ensuring both V2 and V3 configurations are instantiated before calling 'recommendedOptions.ApplyTo(serverConfig)'. This allows the authentication wiring to properly decorate the OpenAPI security definitions. Additionally, it explicitly sets the V3 spec 'Info.Version' to 'v1alpha1' to satisfy strict OpenAPI schema requirements.

Signed-off-by: Himanshu Singh <himansh.singh3@gmail.com>

---------

Signed-off-by: Himanshu Singh <himansh.singh3@gmail.com>

Author: himsngh

pkg/apiserver/apiserver.go

@@ -231,14 +231,26 @@ func newServerConfig(aggClient aggregatorclient.Interface, opts NewAPIServerOpts
 	}
 
 	serverConfig := genericapiserver.NewRecommendedConfig(Codecs)
-	if err := recommendedOptions.ApplyTo(serverConfig); err != nil {
-		return nil, err
-	}
 
 	serverConfig.OpenAPIV3Config = genericapiserver.DefaultOpenAPIV3Config(
 		openapi.GetOpenAPIDefinitions,
 		genericopenapi.NewDefinitionNamer(Scheme))
 	serverConfig.OpenAPIV3Config.Info.Title = "Kapp-controller"
+	serverConfig.OpenAPIV3Config.Info.Version = "v1alpha1"
+
+	// Register OpenAPI v2 configuration to satisfy the Kubernetes Aggregation Controller.
+	// In K8s 1.30+, the aggregator syncs both v2 and v3 specs; providing v2 prevents
+	// "resource not found" errors in the kube-apiserver logs (Fixes #1703).
+	serverConfig.OpenAPIConfig = genericapiserver.DefaultOpenAPIConfig(
+		openapi.GetOpenAPIDefinitions,
+		genericopenapi.NewDefinitionNamer(Scheme))
+	serverConfig.OpenAPIConfig.Info.Title = "Kapp-controller"
+	serverConfig.OpenAPIConfig.Info.Version = "v1alpha1"
+
+	if err := recommendedOptions.ApplyTo(serverConfig); err != nil {
+		return nil, err
+	}
+
 	return serverConfig, nil
 }