Adding how-to guide for tf private registry for recipes

docs/content/guides/recipes/Terraform/howto-private-registry/index.md

@@ -0,0 +1,72 @@
+---
+type: docs
+title: "How-To: Set up a private registry for your Terraform Radius Recipes"
+linkTitle: "Set up a private registry"
+description: "Learn how to configure your Radius Environment to leverage your private registry as storage for your custom Recipe templates"
+weight: 500
+categories: "How-To"
+tags: ["recipes", "terraform"]
+---
+
+This how-to guide will provide an overview of how to:
+
+- Configure a Radius Environment that leverages a [Radius secret store]({{< ref secretstore >}}) to register a [private Terraform registry](https://developer.hashicorp.com/terraform/registry/private) for your Recipe templates.
+
+### Prerequisites
+
+Before you get started, you'll need to make sure you have the following tools and resources:
+
+- [rad CLI]({{< ref "installation#step-1-install-the-rad-cli" >}})
+- [Radius Bicep VSCode extension]({{< ref "installation#step-2-install-the-vs-code-extension" >}})
+- [kubectl](https://kubernetes.io/docs/tasks/tools/install-kubectl/)
+
+### Step 1: Define a secret store resource
+
+Radius provides support for defining Kubernetes Secrets as Bicep resources, through the Radius Secret Store. Users have the option to both leverage an existing Kubernetes Secret or define a new Kubernetes Secret in the resource, see the [Radius Secret Store schema]({{< ref secretstore >}}) for more information.
+
+
+
+Create a Bicep file `env.bicep` and define your resource:
+
+{{< rad file="snippets/env.bicep" embed=true marker="//SECRETSTORE" >}}
+
+> Note the property `pat` is a required property that refers to your personal access token, while `username` can be optional.
+
+## Step 2: Define your Radius Recipe
+
+Define your Radius Recipe, keep in mind that your `templatePath` should contain a `git::` prefix as per [Terraform requirements](https://developer.hashicorp.com/terraform/language/modules/sources#generic-git-repository).
+
+{{< rad file="snippets/env.bicep" embed=true marker="//RECIPE" >}}
+
+
+## Step 3: Define your Radius Recipe configurations
+
+Radius provides a property `recipeConfig` which allows users to setup specific Git module sources for your Terraform Radius Recipes. Define this property in your Radius Environment resource, visit the [Radius Environment schema]({{< ref environment-schema >}}) page for more information.
+
+{{< rad file="snippets/env.bicep" embed=true marker="//ENV" >}}
+
+> Note the keys listed inside of the `pat` property should match your path name to the secret store.
+
+
+## Step 4: Deploy your Radius Environment
+
+Deploy your new Radius Environment:
+
+```
+rad deploy env.bicep
+```
+
+## Cleanup
+
+You can delete a Radius Environment by running the following command:
+
+```
+rad env delete prod
+```
+
+## Further reading
+
+- [Recipes overview]({{< ref "/guides/recipes/overview" >}})
+- [Radius Environments]({{< ref "/guides/deploy-apps/environments/overview" >}})
+- [`rad recipe CLI reference`]({{< ref rad_recipe >}})
+- [`rad env CLI reference`]({{< ref rad_env >}})

docs/content/guides/recipes/Terraform/howto-private-registry/snippets/env.bicep

@@ -0,0 +1,61 @@
+import radius as radius
+
+//ENV
+resource env 'Applications.Core/environments@2023-10-01-preview' = {
+  name: 'prod'
+  properties: {
+    compute: {
+      kind: 'kubernetes'
+      resourceId: 'self'
+      namespace: 'default'
+    }
+    recipeConfig: {
+      terraform: {
+        authentication:{
+          git:{  
+            // PAT is a required key value, personal access token
+            pat:{
+              // This has to be a path name to the secret store
+              'dev.azure.com':{
+                secret: secretStoreGithub.id
+              }
+            }
+          }          
+        }
+      }
+//ENV
+    }
+
+
+//RECIPE
+    recipes: {      
+      'Applications.Datastores/mongoDatabases':{
+          default: {
+            templateKind: 'terraform'
+            // Git template path
+            templatePath: 'git::https://dev.azure.com/test-private-repo'
+          }
+      }
+    }
+  //RECIPE
+ }
+}
+
+//SECRETSTORE
+resource secretStoreGithub 'Applications.Core/secretStores@2023-10-01-preview' = {
+  name: 'github'
+  properties:{
+    type: 'generic'
+    data: {
+      // Call it out in the documentation that pat is a required key value
+      pat: {
+        value: '<my-access-token>'
+      }
+      // Optional key value
+      username: {
+        value: '<my-username>'
+      }
+    }
+  }
+}
+//SECRETSTORE