Adding how-to guide for tf private registry for recipes

.github/config/en-custom.txt

@@ -311,6 +311,7 @@ redoc
 resourceGroup
 replacePrefix
 repo
+repos
 resourceGroupName
 RecipeSpecified
 resourceId

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

@@ -0,0 +1,71 @@
+---
+type: docs
+title: "How-To: Pull Terraform modules from private git repositories"
+linkTitle: "Private git repos"
+description: "Learn how to setup your Radius environment to pull Terraform Recipe templates from a private git repository."
+weight: 500
+categories: "How-To"
+tags: ["recipes", "terraform"]
+---
+
+This how-to guide will describe how to:
+
+- Configure a Radius Environment to be able to pull Terraform Recipe templates from a private git repository.
+
+### 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/)
+- A [personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#about-personal-access-tokens) for your Git repository.
+
+## Step 1: Define a secret store resource
+
+Begin by configuring a [Radius Secret Store]({{< ref secretstore >}}) with the personal access token or username + password you previously created, which has access to your private git repository.
+
+Create a Bicep file `env.bicep`, import Radius, 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` is an optional field you can specify if your git platform requires a username.
+
+## Step 2: Configure Terraform Recipe git authentication
+
+`recipeConfig` allows you to configure how Recipes should be setup and run. One available option is to specify git credentials for pulling Terraform Recipes from git sources. For more information refer to the [Radius Environment schema]({{< ref environment-schema >}}) page.
+
+In your `env.bicep` file add an Environment resource, along with Recipe configuration which leverages the previously defined secret store for git authentication.
+
+{{< 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 3: Add a Terraform Recipe
+
+Update your Environment with a Terraform Recipe, pointing to your private git repository. Note that your `templatePath` should contain a `git::` prefix, per the [Terraform module documentation](https://developer.hashicorp.com/terraform/language/modules/sources#generic-git-repository).
+
+{{< rad file="snippets/env.bicep" embed=true marker="//RECIPE" >}}
+
+## 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,59 @@
+//SECRETSTORE
+import radius as radius
+
+resource secretStoreGithub 'Applications.Core/secretStores@2023-10-01-preview' = {
+  name: 'github'
+  properties:{
+    type: 'generic'
+    data: {
+      // Required value, refers to the personal access token or password of the git platform
+      pat: {
+        value: '<my-access-token>'
+      }
+      // Optional value, refers to the username of the git platform
+      username: {
+        value: '<my-username>'
+      }
+    }
+  }
+}
+//SECRETSTORE
+
+//ENV
+resource env 'Applications.Core/environments@2023-10-01-preview' = {
+  name: 'prod'
+  properties: {
+    compute: {
+      kind: 'kubernetes'
+      namespace: 'default'
+    }
+    recipeConfig: {
+      terraform: {
+        authentication:{
+          git:{  
+            pat:{
+              // The hostname of your git platform, such as 'dev.azure.com' or 'github.com'
+              '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
+ }
+}