terraform scenario

Author: JnHs

articles/copilot/TOC.yml

@@ -38,6 +38,8 @@
     href: generate-cli-scripts.md
   - name: Generate PowerShell scripts
     href: generate-powershell-scripts.md
+  - name: Generate Terraform infrastructure
+    href: generate-terraform-configurations.md
   - name: Author API Management policies
     href: author-api-management-policies.md
   - name: Work with AKS clusters

articles/copilot/capabilities.md

@@ -1,7 +1,7 @@
 ---
 title:  Microsoft Copilot in Azure capabilities
 description: Learn about the things you can do with Microsoft Copilot in Azure.
-ms.date: 05/28/2024
+ms.date: 06/17/2024
 ms.topic: conceptual
 ms.service: copilot-for-azure
 ms.custom:
@@ -39,6 +39,7 @@ Use Microsoft Copilot in Azure to perform many basic tasks in the Azure portal o
 - Write and optimize code:
   - [Generate Azure CLI scripts](generate-cli-scripts.md)
   - [Generate PowerShell scripts](generate-powershell-scripts.md)
+  - [Generate Terraform configurations](generate-terraform-configurations.md)
   - [Discover performance recommendations with Code Optimizations](optimize-code-application-insights.md)
   - [Author API Management policies](author-api-management-policies.md)
   - [Create Kubernetes YAML files](generate-kubernetes-yaml.md)

articles/copilot/generate-terraform-configurations.md

@@ -0,0 +1,34 @@
+---
+title: Generate Terraform configurations using Microsoft Copilot in Azure
+description: Learn about scenarios where Microsoft Copilot in Azure can generate PowerShell scripts for you to customize and use.
+ms.date: 06/17/2024
+ms.topic: conceptual
+ms.service: copilot-for-azure
+ms.author: jenhayes
+author: JnHs
+---
+
+# Generate Terraform configurations using Microsoft Copilot in Azure
+
+Microsoft Copilot in Azure (preview) can generate Terraform configurations that you can use to create and manage your Azure infrastructure.
+
+When you tell Microsoft Copilot in Azure about some Azure infrastructure that you want to manage using Terraform, it provides a configuration using resources from the [AzureRM provider](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs). In addition to the primary resources, any dependent resources required to accomplish a successful deployment are included in the configuration. You can ask follow-up questions to further customize the configuration. Once you've reviewed the configuration and are happy with it, copy the configuration contents and deploy the configuration using your Terraform deployment method of choice.  
+
+[!INCLUDE [scenario-note](includes/scenario-note.md)]
+
+[!INCLUDE [preview-note](includes/preview-note.md)]
+
+## Sample prompts
+
+Here are a few examples of the kinds of prompts you can use to generate Terraform configurations. Modify these prompts based on your real-life scenarios, or try additional prompts to create different kinds of queries.
+
+- "Create a Terraform config for a Cognitive Services instance with name 'mycognitiveservice' and S0 pricing tier. I need it to have the Text Analytics and Face APIs enabled, and I also need the access keys for authentication purposes."
+- "Show me a Terraform configuration for a virtual machine with a size of 'Standard_D2s_v3' and an image of 'UbuntuServer 18.04-LTS'. The resource should be placed in the West US location and have a public IP address. Additionally, it should have a managed disk with a size of 50 GB and be part of a virtual network."
+- "Create Terraform configuration for a container app resource with name 'myapp' and Linux OS. Specify the Docker image to be pulled from 'myrepository' and use port 80 for networking. Set the CPU and memory limits to 2 and 4GB respectively. Enable automatic scaling based on CPU usage and set the scaling range between 2 to 10 instances. Also, configure environment variables and mount a storage account for persistent data."
+- "What is the Terraform code for a Databricks workspace in Azure with name 'myworkspace' and a premium SKU. The workspace should be created in the West US region. I also need to enable workspace-wide access control with Microsoft Entra integration."
+- "Use Terraform to create a new Azure SQL database named 'mydatabase' with Basic SKU and 10 DTU. Set the collation to 'SQL_Latin1_General_CP1_CI_AS' and enable Microsoft Entra authentication. Also, enable long-term backup retention and configure geo-replication to a secondary region for high availability."
+
+## Next steps
+
+- Explore [capabilities](capabilities.md) of Microsoft Copilot in Azure.
+- Learn more about [Terraform on Azure](/azure/developer/terraform/overview).

articles/copilot/index.yml

@@ -90,6 +90,9 @@ conceptualContent:
             - url: ./generate-powershell-scripts.md
               itemType: get-started
               text: Generate PowerShell scripts
+            - url: ./generate-terraform-configurations.md
+              itemType: get-started
+              text: Generate Terraform configurations
             - url: ./generate-kubernetes-yaml.md
               itemType: get-started
               text: Generate Kubernetes YAML files