Add capabilities to resource type API

This change adds the 'capabilities' concept to the resource type API.

- Capabilities enable resource types to indicate the schema and behaviors they support.
- Capabilities enable clients like the `rad` CLI to understand the behaviors of resource types dynamically.

For example, we're adding the `SupportsRecipes` capability.

- All resource types that support recipes should declare this capability. This is how a UDT will opt-in to recipe functionality during provisioning.
- The `rad` CLI functionality for `rad recipe register` can introspect the resource type to validate recipe support, rather than hardcoding which types have the support and which don't.

----

Description of the changes:

- The manifests previously supported capabilities as part of the API version, we're moving this to the resource type for a simplification.
- The manifest entry for capabilities wasn't sent to the server. Now it is.
- Updated API, converters, and UCP functionality.

Signed-off-by: Ryan Nowak <nowakra@gmail.com>

deploy/manifest/built-in-providers/applications_core.yaml

@@ -4,34 +4,34 @@ types:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: []
+    capabilities: []
   applications:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: []
+    capabilities: []
   environments:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: []
+    capabilities: []
   gateways:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: []
+    capabilities: []
   secretStores:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: []
+    capabilities: []
   extenders:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]
   volumes:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: []
+    capabilities: []

deploy/manifest/built-in-providers/applications_dapr.yaml

@@ -4,19 +4,19 @@ types:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]
   pubSubBrokers:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]
   secretStores:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]
   stateStores:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]

deploy/manifest/built-in-providers/applications_datastores.yaml

@@ -4,14 +4,14 @@ types:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]
   sqlDatabases:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]
   redisCaches:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]

deploy/manifest/built-in-providers/applications_messaging.yaml

@@ -4,4 +4,4 @@ types:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]

deploy/manifest/built-in-providers/microsoft_resources.yaml

@@ -4,5 +4,5 @@ types:
     apiVersions:
       "2025-01-01-preview":
         schema: {}
-        capabilities: []
+    capabilities: []
 

pkg/cli/cmd/resourceprovider/create/create.go

@@ -140,6 +140,7 @@ func (r *Runner) Run(ctx context.Context) error {
 		r.Output.LogInfo("Creating resource type %s/%s", r.ResourceProvider.Name, resourceTypeName)
 		_, err := client.CreateOrUpdateResourceType(ctx, "local", r.ResourceProvider.Name, resourceTypeName, &v20231001preview.ResourceTypeResource{
 			Properties: &v20231001preview.ResourceTypeProperties{
+				Capabilities:      to.SliceOfPtrs(resourceType.Capabilities...),
 				DefaultAPIVersion: resourceType.DefaultAPIVersion,
 			},
 		})

pkg/cli/cmd/resourceprovider/create/create_test.go

@@ -83,7 +83,9 @@ func Test_Run(t *testing.T) {
 			Properties: &v20231001preview.ResourceProviderProperties{},
 		}
 		expectedResourceType := v20231001preview.ResourceTypeResource{
-			Properties: &v20231001preview.ResourceTypeProperties{},
+			Properties: &v20231001preview.ResourceTypeProperties{
+				Capabilities: []*string{to.Ptr("SupportsRecipes")},
+			},
 		}
 		expectedAPIVersion := v20231001preview.APIVersionResource{
 			Properties: &v20231001preview.APIVersionProperties{},

pkg/cli/cmd/resourceprovider/create/testdata/missing-required-field.yaml

@@ -3,4 +3,4 @@ types:
     apiVersions:
       '2025-01-01-preview':
         schema: {}
-        capabilities: ["Recipes"]
+        capabilities: ["SupportsRecipes"]

pkg/cli/cmd/resourceprovider/create/testdata/valid.yaml

@@ -4,4 +4,4 @@ types:
     apiVersions:
       '2025-01-01-preview':
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]

pkg/cli/manifest/manifest.go

@@ -27,6 +27,9 @@ type ResourceProvider struct {
 
 // ResourceType represents a resource type in a resource provider manifest.
 type ResourceType struct {
+	// Capabilities is a list of capabilities for the resource type.
+	Capabilities []string `yaml:"capabilities" validate:"dive,capability"`
+
 	// DefaultAPIVersion is the default API version for the resource type.
 	DefaultAPIVersion *string `yaml:"defaultApiVersion,omitempty" validate:"omitempty,apiVersion"`
 
@@ -40,7 +43,4 @@ type ResourceTypeAPIVersion struct {
 	// TODO: this allows anything right now, and will be ignored. We'll improve this in
 	// a future pull-request.
 	Schema any `yaml:"schema" validate:"required"`
-
-	// Capabilities is a list of capabilities for the resource type.
-	Capabilities []string `yaml:"capabilities" validate:"dive,capability"`
 }

pkg/cli/manifest/manifest_test.go

@@ -29,10 +29,10 @@ func TestReadFileYAML(t *testing.T) {
 			"testResources": {
 				APIVersions: map[string]*ResourceTypeAPIVersion{
 					"2025-01-01-preview": {
-						Schema:       map[string]any{},
-						Capabilities: []string{"Recipes"},
+						Schema: map[string]any{},
 					},
 				},
+				Capabilities: []string{"SupportsRecipes"},
 			},
 		},
 	}
@@ -70,10 +70,10 @@ func TestReadFileJSON(t *testing.T) {
 			"testResources": {
 				APIVersions: map[string]*ResourceTypeAPIVersion{
 					"2025-01-01-preview": {
-						Schema:       map[string]any{},
-						Capabilities: []string{"Recipes"},
+						Schema: map[string]any{},
 					},
 				},
+				Capabilities: []string{"SupportsRecipes"},
 			},
 		},
 	}

pkg/cli/manifest/testdata/duplicate-key.yaml

@@ -4,10 +4,10 @@ types:
     apiVersions:
       '2025-01-01-preview':
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]
 types:
   testResources:
     apiVersions:
       '2025-01-01-preview':
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]

pkg/cli/manifest/testdata/invalid-yaml.yaml

@@ -5,4 +5,4 @@ types:
     apiVersions:
       '2025-01-01-preview':
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]

pkg/cli/manifest/testdata/missing-required-field.yaml

@@ -3,4 +3,4 @@ types:
     apiVersions:
       '2025-01-01-preview':
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]

pkg/cli/manifest/testdata/valid.json

@@ -4,10 +4,10 @@
     "testResources": {
       "apiVersions": {
         "2025-01-01-preview": {
-          "schema": {},
-          "capabilities": ["Recipes"]
+          "schema": {}
         }
-      }
+      },
+      "capabilities": ["SupportsRecipes"]
     }
   }
 }

pkg/cli/manifest/testdata/valid.yaml

@@ -4,4 +4,4 @@ types:
     apiVersions:
       '2025-01-01-preview':
         schema: {}
-        capabilities: ["Recipes"]
+    capabilities: ["SupportsRecipes"]

pkg/ucp/api/v20231001preview/resourceprovidersummary_conversion.go

@@ -48,6 +48,7 @@ func (dst *ResourceProviderSummary) ConvertFrom(src v1.DataModelInterface) error
 	dst.ResourceTypes = map[string]*ResourceProviderSummaryResourceType{}
 	for resourceTypeName, resourceType := range dm.Properties.ResourceTypes {
 		dst.ResourceTypes[resourceTypeName] = &ResourceProviderSummaryResourceType{
+			Capabilities:      to.SliceOfPtrs(resourceType.Capabilities...),
 			DefaultAPIVersion: resourceType.DefaultAPIVersion,
 			APIVersions:       map[string]map[string]any{},
 		}

pkg/ucp/api/v20231001preview/resourceprovidersummary_conversion_test.go

@@ -44,6 +44,7 @@ func Test_ResourceProviderSummary_DataModelToVersioned(t *testing.T) {
 				},
 				ResourceTypes: map[string]*ResourceProviderSummaryResourceType{
 					"testResources": {
+						Capabilities:      []*string{to.Ptr("SupportsRecipes")},
 						DefaultAPIVersion: to.Ptr("2025-01-01"),
 						APIVersions: map[string]map[string]any{
 							"2025-01-01": {},

pkg/ucp/api/v20231001preview/resourcetype_conversion.go

@@ -17,6 +17,8 @@ limitations under the License.
 package v20231001preview
 
 import (
+	"fmt"
+
 	v1 "github.com/radius-project/radius/pkg/armrpc/api/v1"
 	"github.com/radius-project/radius/pkg/to"
 	"github.com/radius-project/radius/pkg/ucp/datamodel"
@@ -39,7 +41,18 @@ func (src *ResourceTypeResource) ConvertTo() (v1.DataModelInterface, error) {
 		},
 	}
 
+	capabilities := []string{}
+	for _, capability := range src.Properties.Capabilities {
+		err := validateCapability(capability)
+		if err != nil {
+			return nil, err
+		}
+
+		capabilities = append(capabilities, *capability)
+	}
+
 	dst.Properties = datamodel.ResourceTypeProperties{
+		Capabilities:      capabilities,
 		DefaultAPIVersion: src.Properties.DefaultAPIVersion,
 	}
 
@@ -61,8 +74,21 @@ func (dst *ResourceTypeResource) ConvertFrom(src v1.DataModelInterface) error {
 
 	dst.Properties = &ResourceTypeProperties{
 		ProvisioningState: to.Ptr(ProvisioningState(dm.InternalMetadata.AsyncProvisioningState)),
+		Capabilities:      to.SliceOfPtrs(dm.Properties.Capabilities...),
 		DefaultAPIVersion: dm.Properties.DefaultAPIVersion,
 	}
 
 	return nil
 }
+
+func validateCapability(input *string) error {
+	if input == nil {
+		return v1.NewClientErrInvalidRequest("capability cannot be null")
+	}
+
+	if *input == datamodel.CapabilitySupportsRecipes {
+		return nil
+	}
+
+	return v1.NewClientErrInvalidRequest(fmt.Sprintf("capability %q is not recognized. Supported capabilities: %s", *input, datamodel.CapabilitySupportsRecipes))
+}

pkg/ucp/api/v20231001preview/resourcetype_conversion_test.go

@@ -48,6 +48,7 @@ func Test_ResourceType_VersionedToDataModel(t *testing.T) {
 					},
 				},
 				Properties: datamodel.ResourceTypeProperties{
+					Capabilities:      []string{"SupportsRecipes"},
 					DefaultAPIVersion: to.Ptr("2025-01-01"),
 				},
 			},
@@ -87,6 +88,7 @@ func Test_ResourceType_DataModelToVersioned(t *testing.T) {
 				Name: to.Ptr("testResources"),
 				Properties: &ResourceTypeProperties{
 					ProvisioningState: to.Ptr(ProvisioningStateSucceeded),
+					Capabilities:      []*string{to.Ptr("SupportsRecipes")},
 					DefaultAPIVersion: to.Ptr("2025-01-01"),
 				},
 			},

pkg/ucp/api/v20231001preview/testdata/resourceprovidersummary_datamodel.json

@@ -6,6 +6,7 @@
     },
     "resourceTypes": {
       "testResources": {
+        "capabilities": ["SupportsRecipes"],
         "defaultApiVersion": "2025-01-01",
         "apiVersions": {
           "2025-01-01": {}

pkg/ucp/api/v20231001preview/testdata/resourcetype_datamodel.json

@@ -4,6 +4,7 @@
   "type": "System.Resources/resourceProviders/resourceTypes",
   "provisioningState": "Succeeded",
   "properties": {
+    "capabilities": ["SupportsRecipes"],
     "defaultApiVersion": "2025-01-01"
   }
 }

pkg/ucp/api/v20231001preview/testdata/resourcetype_resource.json

@@ -2,6 +2,7 @@
   "id": "/planes/radius/local/providers/System.Resources/resourceProviders/Applications.Test/resourceTypes/testResources",
   "name": "testResources",
   "properties": {
+    "capabilities": ["SupportsRecipes"],
     "defaultApiVersion": "2025-01-01"
   }
 }

pkg/ucp/backend/controller/resourceproviders/resourcetype_put.go

@@ -78,6 +78,7 @@ func (c *ResourceTypePutController) updateSummary(id resources.ID, resourceType
 			resourceTypeEntry = datamodel.ResourceProviderSummaryPropertiesResourceType{}
 		}
 
+		resourceTypeEntry.Capabilities = resourceType.Properties.Capabilities
 		resourceTypeEntry.DefaultAPIVersion = resourceType.Properties.DefaultAPIVersion
 		summary.Properties.ResourceTypes[resourceTypeName] = resourceTypeEntry
 		return nil