Recipe packs #109

nithyatsu · 2025-09-03T15:37:09Z

Recipe Pack design. Feature Spec at https://github.com/radius-project/design-notes/blob/main/features/2025-06-compute-extensibility-feature-spec.md

recipe/2025-08-recipe-packs.md

brooke-hamilton · 2025-09-17T18:14:44Z

recipe/2025-08-recipe-packs.md

+#### Registering several recipes to an environment
+
+As an operator I am responsible for creating Radius Environments using which developers can deploy their applications. As part of creating the environment, I manually link recipes one by one using `rad recipe register` or by updating the environment definition. This can be error prone when there are many recipes and environments. Radius should provide a way to bulk register (and manage) recipes.
+
+#### Registering recipes to multiple environments
+
+As an operator I am responsible for creating Radius Environments using which developers can deploy their applications. As part of creating the environment, I manually link recipes one by one using `rad recipe register` or by updating the environment definition. I have 100s of environments which mostly use the same recipes. Piecing the same recipes together for each environment feels like rework.


I think these two scenarios describe the current state rather than scenarios that will be implemented by this design.

recipe/2025-08-recipe-packs.md

zachcasper

Overall looked good except for the approach to versioning.

recipe/2025-08-recipe-packs.md

Signed-off-by: nithyatsu <[email protected]>

nithyatsu · 2025-10-23T22:48:52Z

recipe/2025-08-recipe-packs.md

+We could delete recipe-packs that are not referenced by any environment in any resource-group. If referenced by environments, the delete should also update the environment to not have the recipepack ID in its list of recipe packs. Allowance of recipe pack deletion when there are resources refering to it is in parity with today's recipe behavior. 
+
+By default, delete looks for recipe-pack in current group. It should take in optional scope to delete recipe packs in Other scope. 
+


@willtsai @zachcasper pls review. This is the behavior for recipe-packs, based on our decision to drop tagging support

zachcasper · 2025-10-24T15:56:47Z

recipe/2025-08-recipe-packs.md

+RESOURCE TYPE                    RECIPE KIND          RECIPE LOCATION    RECIPE PARAMETERS
+Radius.Compute/containers        terraform                           https://github.com/project-radius/resource-types-contrib.git//recipes/compute/containers/kubernetes?ref=v0.48  allowPlatformOptions(bool)
+Radius.Security/secrets          terraform                           https://github.com/project-radius/resource-types-contrib.git//recipes/security/secrets?ref=v0.48
+Radius.Storage/volumes           terraform                           https://github.com/project-radius/resource-types-contrib.git//recipes/storage/volumes?ref=v0.48


Suggested change

RESOURCE TYPE RECIPE KIND RECIPE LOCATION RECIPE PARAMETERS

Radius.Compute/containers terraform https://github.com/project-radius/resource-types-contrib.git//recipes/compute/containers/kubernetes?ref=v0.48 allowPlatformOptions(bool)

Radius.Security/secrets terraform https://github.com/project-radius/resource-types-contrib.git//recipes/security/secrets?ref=v0.48

Radius.Storage/volumes terraform https://github.com/project-radius/resource-types-contrib.git//recipes/storage/volumes?ref=v0.48

RESOURCE TYPE RECIPE KIND RECIPE LOCATION

Radius.Compute/containers terraform https://github.com/project-radius/resource-types-contrib.git//recipes/compute/containers/kubernetes?ref=v0.48

PARAMETERS:

- allowPlatformOptions: true

Radius.Security/secrets terraform https://github.com/project-radius/resource-types-contrib.git//recipes/security/secrets?ref=v0.48

Radius.Storage/volumes terraform https://github.com/project-radius/resource-types-contrib.git//recipes/storage/volumes?ref=v0.48

Parameters are not going to fit past the URL.

zachcasper · 2025-10-24T16:00:06Z

recipe/2025-08-recipe-packs.md

+@doc("Description of what this recipe pack provides") 
+description?: string; 
+
+


Suggested change

@doc("Description of what this recipe pack provides")

description?: string;

Why does RecipePacks have a description property when no other Radius resource have a description? I do not see a use case for why this is needed. It's not used anywhere else in this design.

zachcasper · 2025-10-24T16:03:37Z

recipe/2025-08-recipe-packs.md

+$ rad recipe-pack list [-g mygroup]
+
+Lists all recipe packs in all scopes. 
+
+RESOURCE                TYPE                      GROUP     STATE
+computeRecipePack       Radius.Core/recipePacks   default   Succeeded
+dataRecipePack          Radius.Core/recipePacks   default   Succeeded


Suggested change

$ rad recipe-pack list [-g mygroup]

Lists all recipe packs in all scopes.

RESOURCE TYPE GROUP STATE

computeRecipePack Radius.Core/recipePacks default Succeeded

dataRecipePack Radius.Core/recipePacks default Succeeded

$ rad recipe-pack list

RECIPE PACK GROUP

computeRecipePack default

dataRecipePack default

myCustomPack1 myGroup1

myCustomPack2 myGroup2

Let's keep the UI as clean as possible. Example shown to emphasize that list should return all RecipePacks from all Resource Groups.

zachcasper · 2025-10-24T16:04:24Z

recipe/2025-08-recipe-packs.md

+RESOURCE                TYPE                      GROUP     
+computeRecipePack       Radius.Core/recipePacks   default   


Suggested change

RESOURCE TYPE GROUP

computeRecipePack Radius.Core/recipePacks default

RECIPE PACK GROUP

computeRecipePack default

zachcasper · 2025-10-24T16:05:20Z

recipe/2025-08-recipe-packs.md

+dataRecipePack          Radius.Core/recipePacks   default   Succeeded
+```
+
+if -g is provided, list recipe packs in that scope.


Suggested change

if -g is provided, list recipe packs in that scope.

if --group or -g is provided, results are filtered for the specified Resource Group.

zachcasper · 2025-10-24T16:17:32Z

recipe/2025-08-recipe-packs.md

+We could delete recipe-packs that are not referenced by any environment in any resource-group. If referenced by environments, the delete should also update the environment to not have the recipepack ID in its list of recipe packs. Allowance of recipe pack deletion when there are resources refering to it is in parity with today's recipe behavior. 
+
+By default, delete looks for recipe-pack in current group. It should take in optional scope to delete recipe packs in Other scope. 


Suggested change

We could delete recipe-packs that are not referenced by any environment in any resource-group. If referenced by environments, the delete should also update the environment to not have the recipepack ID in its list of recipe packs. Allowance of recipe pack deletion when there are resources refering to it is in parity with today's recipe behavior.

By default, delete looks for recipe-pack in current group. It should take in optional scope to delete recipe packs in Other scope.

The delete command deletes the Recipe Pack and removes the Recipe Pack from all existing Environments. Because the Recipe is stored on each resource's status property, Radius retains details of the actual Recipe used to deploy the resource. Therefore, deleting a Recipe Pack only impacts the ability to deploy new resources using the referenced Recipes. This is in parity with today's Recipe behavior.

By default, delete looks for Recipe Packs in the current Resource Group. Users can also specify the --group or -g parameter to reference a different Resource Group.

Rewrote for clarity, but no actual changes.

zachcasper · 2025-10-24T16:19:56Z

recipe/2025-08-recipe-packs.md

+4. Show environment
+
+```
+$ rad environment show my-env
+RESOURCE            TYPE                            GROUP     STATE
+my-env              Radius.Core/environments        default   Succeeded
+
+RECIPE PACKS        
+computeRecipePack   
+dataRecipePack      
+```


Suggested change

4. Show environment

```

$ rad environment show my-env

RESOURCE TYPE GROUP STATE

my-env Radius.Core/environments default Succeeded

RECIPE PACKS

computeRecipePack

dataRecipePack

```

Duplicate with line 634.

zachcasper · 2025-10-24T16:20:23Z

recipe/2025-08-recipe-packs.md

+```
+$ rad environment show my-env
+RESOURCE            TYPE                      GROUP     STATE
+my-env              Radius.Core/environments  default   Succeeded
+
+RECIPE PACK        
+computeRecipePack  
+dataRecipePack
+```


Suggested change

```

$ rad environment show my-env

RESOURCE TYPE GROUP STATE

my-env Radius.Core/environments default Succeeded

RECIPE PACK

computeRecipePack

dataRecipePack

```

$ rad environment show my-env

ENVIRONMENT GROUP

my-env default

KUBERNETES

Namespace: my-env

AWS:

Account ID: 1234567890123

Region: us-east-1

AZURE:

Subscription ID: c95e0456-ea5b-4a22-a0cd-e3767f24725b

Resource Group Name: myResourceGroup

RECIPE PACKS GROUP

computeRecipePack default

dataRecipePack default

myCustomPack1 myGroup1

myCustomPack2 myGroup2

zachcasper · 2025-10-24T16:22:59Z

recipe/2025-08-recipe-packs.md

+$ rad recipe list -environment my-env
+RECIPE PACK             RESOURCE TYPE                    RECIPE KIND           RECIPE LOCATION
+computeRecipePack       Radius.Compute/containers        terraform                           https://github.com/project-radius/resource-types-contrib.git//recipes/compute/containers/kubernetes?ref=v0.48
+computeRecipePack       Radius.Security/secrets          terraform                           https://github.com/project-radius/resource-types-contrib.git//recipes/security/secrets?ref=v0.48
+computeRecipePack       Radius.Storage/volumes           terraform                           https://github.com/project-radius/resource-types-contrib.git//recipes/storage/volumes?ref=v0.48
+dataRecipePack          Radius.Data/redisCaches          terraform                           https://github.com/project-radius/resource-types-contrib.git//recipes/data/redisCaches?ref=v0.48
+networkingRecipePack    Radius.Compute/gateways          terraform                           https://github.com/project-radius/resource-types-contrib.git//recipes/compute/gateways?ref=v0.48


Suggested change

$ rad recipe list -environment my-env

RECIPE PACK RESOURCE TYPE RECIPE KIND RECIPE LOCATION

computeRecipePack Radius.Compute/containers terraform https://github.com/project-radius/resource-types-contrib.git//recipes/compute/containers/kubernetes?ref=v0.48

computeRecipePack Radius.Security/secrets terraform https://github.com/project-radius/resource-types-contrib.git//recipes/security/secrets?ref=v0.48

computeRecipePack Radius.Storage/volumes terraform https://github.com/project-radius/resource-types-contrib.git//recipes/storage/volumes?ref=v0.48

dataRecipePack Radius.Data/redisCaches terraform https://github.com/project-radius/resource-types-contrib.git//recipes/data/redisCaches?ref=v0.48

networkingRecipePack Radius.Compute/gateways terraform https://github.com/project-radius/resource-types-contrib.git//recipes/compute/gateways?ref=v0.48

$ rad recipe list -environment my-env

RECIPE PACK GROUP RESOURCE TYPE RECIPE KIND RECIPE LOCATION

computeRecipePack default Radius.Compute/containers terraform https://github.com/project-radius/resource-types-contrib.git//recipes/compute/containers/kubernetes?ref=v0.48

computeRecipePack default Radius.Security/secrets terraform https://github.com/project-radius/resource-types-contrib.git//recipes/security/secrets?ref=v0.48

computeRecipePack default Radius.Storage/volumes terraform https://github.com/project-radius/resource-types-contrib.git//recipes/storage/volumes?ref=v0.48

dataRecipePack default Radius.Data/redisCaches terraform https://github.com/project-radius/resource-types-contrib.git//recipes/data/redisCaches?ref=v0.48

networkingRecipePack default Radius.Compute/gateways terraform https://github.com/project-radius/resource-types-contrib.git//recipes/compute/gateways?ref=v0.48

willtsai reviewed Sep 3, 2025

View reviewed changes

nithyatsu marked this pull request as ready for review September 10, 2025 17:55

nithyatsu requested review from a team as code owners September 10, 2025 17:55

nithyatsu changed the title ~~Recipe packs~~ Recipe packs (WIP) Sep 10, 2025

lakshmimsft reviewed Sep 10, 2025

View reviewed changes

recipe/2025-08-recipe-packs.md Show resolved Hide resolved

lakshmimsft reviewed Sep 10, 2025

View reviewed changes

recipe/2025-08-recipe-packs.md Show resolved Hide resolved

ytimocin reviewed Sep 10, 2025

View reviewed changes

zachcasper suggested changes Sep 10, 2025

View reviewed changes

lakshmimsft reviewed Sep 17, 2025

View reviewed changes

recipe/2025-08-recipe-packs.md Show resolved Hide resolved

willtsai reviewed Sep 17, 2025

View reviewed changes

recipe/2025-08-recipe-packs.md Outdated Show resolved Hide resolved

nicolejms reviewed Sep 17, 2025

View reviewed changes

recipe/2025-08-recipe-packs.md Show resolved Hide resolved

lakshmimsft reviewed Sep 17, 2025

View reviewed changes

recipe/2025-08-recipe-packs.md Outdated Show resolved Hide resolved

brooke-hamilton reviewed Sep 17, 2025

View reviewed changes

nithyatsu changed the title ~~Recipe packs (WIP)~~ Recipe packs Sep 18, 2025

zachcasper reviewed Sep 19, 2025

View reviewed changes

recipe/2025-08-recipe-packs.md Outdated Show resolved Hide resolved

brooke-hamilton reviewed Oct 1, 2025

View reviewed changes

recipe/2025-08-recipe-packs.md Outdated Show resolved Hide resolved

recipe/2025-08-recipe-packs.md Show resolved Hide resolved

zachcasper suggested changes Oct 1, 2025

View reviewed changes

recipe/2025-08-recipe-packs.md Show resolved Hide resolved

recipe/2025-08-recipe-packs.md Show resolved Hide resolved

recipe/2025-08-recipe-packs.md Outdated Show resolved Hide resolved

nithyatsu mentioned this pull request Oct 23, 2025

[Recipe Packs] Add a recipe pack list page radius-project/dashboard#163

Open

1 task

nithyatsu added 11 commits October 23, 2025 14:42

draft recipe-pack design

4e98b55

Signed-off-by: nithyatsu <[email protected]>

add schema

df836e0

Signed-off-by: nithyatsu <[email protected]>

wip

645bff3

Signed-off-by: nithyatsu <[email protected]>

wip

a70e14b

Signed-off-by: nithyatsu <[email protected]>

wip

711d1ce

Signed-off-by: nithyatsu <[email protected]>

wip

44fb67b

Signed-off-by: nithyatsu <[email protected]>

wip

37b48a3

Signed-off-by: nithyatsu <[email protected]>

wip

59dfe79

Signed-off-by: nithyatsu <[email protected]>

wip

9f5c4a9

Signed-off-by: nithyatsu <[email protected]>

wip

8306391

Signed-off-by: nithyatsu <[email protected]>

WIP

07ee472

Signed-off-by: nithyatsu <[email protected]>

nithyatsu added 9 commits October 23, 2025 14:42

wip

df0665c

Signed-off-by: nithyatsu <[email protected]>

wip

de0f49e

Signed-off-by: nithyatsu <[email protected]>

wip

51824d8

Signed-off-by: nithyatsu <[email protected]>

wip

9f82f3b

Signed-off-by: nithyatsu <[email protected]>

wip

cae0e91

Signed-off-by: nithyatsu <[email protected]>

wip

60e18cc

Signed-off-by: nithyatsu <[email protected]>

wip

0e1ca07

Signed-off-by: nithyatsu <[email protected]>

wip

b909835

Signed-off-by: nithyatsu <[email protected]>

wip

275005b

Signed-off-by: nithyatsu <[email protected]>

nithyatsu force-pushed the recipe-packs branch from dca4efb to 275005b Compare October 23, 2025 21:43

nithyatsu added 4 commits October 23, 2025 15:24

wip

3700ae8

Signed-off-by: nithyatsu <[email protected]>

wip

0e08ecd

Signed-off-by: nithyatsu <[email protected]>

wip

dddc17b

Signed-off-by: nithyatsu <[email protected]>

wip

210590a

Signed-off-by: nithyatsu <[email protected]>

nithyatsu commented Oct 23, 2025

View reviewed changes

zachcasper suggested changes Oct 24, 2025

View reviewed changes

		We could delete recipe-packs that are not referenced by any environment in any resource-group. If referenced by environments, the delete should also update the environment to not have the recipepack ID in its list of recipe packs. Allowance of recipe pack deletion when there are resources refering to it is in parity with today's recipe behavior.

		By default, delete looks for recipe-pack in current group. It should take in optional scope to delete recipe packs in Other scope.

		@doc("Description of what this recipe pack provides")
		description?: string;

		RESOURCE TYPE GROUP
		computeRecipePack Radius.Core/recipePacks default

	if -g is provided, list recipe packs in that scope.
	if --group or -g is provided, results are filtered for the specified Resource Group.

-```
-$ rad environment show my-env
-RESOURCE            TYPE                      GROUP     STATE
-my-env              Radius.Core/environments  default   Succeeded
-RECIPE PACK
-computeRecipePack
-dataRecipePack
-```
+$ rad environment show my-env
+ENVIRONMENT         GROUP
+my-env              default
+KUBERNETES
+Namespace: my-env
+AWS:
+Account ID: 1234567890123
+Region:     us-east-1
+AZURE:
+Subscription ID:     c95e0456-ea5b-4a22-a0cd-e3767f24725b
+Resource Group Name: myResourceGroup
+RECIPE PACKS        GROUP
+computeRecipePack   default
+dataRecipePack      default
+myCustomPack1       myGroup1
+myCustomPack2       myGroup2

Recipe packs #109

Are you sure you want to change the base?

Recipe packs #109

Uh oh!

Conversation

nithyatsu commented Sep 3, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

zachcasper left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

nithyatsu commented Sep 3, 2025 •

edited

Loading