Quickstart using Terraform

Author: TomArcherMsft

articles/ddos-protection/TOC.yml

@@ -24,6 +24,8 @@
       displayName: Resource Manager
       href: manage-ddos-protection-template.md
       expanded: true
+    - name: Terraform
+      href: manage-ddos-protection-terraform.md
   - name: DDoS IP Protection
     items:
     - name: Portal

articles/ddos-protection/manage-ddos-protection-terraform.md

@@ -0,0 +1,142 @@
+---
+title: 'Quickstart: Create and configure Azure DDoS Network Protection using Terraform'
+description: In this article, you create and configure Azure DDoS Network Protection using Terraform
+author: TomArcherMsft
+ms.service: ddos-protection
+ms.topic: quickstart
+ms.workload: infrastructure-services
+ms.custom: devx-track-terraform
+ms.author: tarcher
+ms.date: 4/12/2023
+---
+
+# Quickstart: Create and configure Azure DDoS Network Protection using Terraform
+
+This quickstart describes how to use Terraform to create and enable a [distributed denial of service (DDoS) protection plan](ddos-protection-overview) and [Azure virtual network (VNet)](/azure/virtual-network/virtual-networks-overview). An Azure DDoS Network Protection plan defines a set of virtual networks that have DDoS protection enabled across subscriptions. You can configure one DDoS protection plan for your organization and link virtual networks from multiple subscriptions to the same plan.
+
+[!INCLUDE [Terraform abstract](~/azure-dev-docs-pr/articles/terraform/includes/abstract.md)]
+
+In this article, you learn how to:
+
+> [!div class="checklist"]
+> * Create a random value for the Azure resource group name using [random_pet](https://registry.terraform.io/providers/hashicorp/random/latest/docs/resources/pet)
+> * Create an Azure resource group using [azurerm_resource_group](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/resource_group)
+> * Create a random value for the virtual network name using [random_string](https://registry.terraform.io/providers/hashicorp/random/latest/docs/resources/string)
+> * Create an Azure DDoS protection plan using [azurerm_network_ddos_protection_plan](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/network_ddos_protection_plan)
+> * Create an Azure virtual network using [azurerm_virtual_network](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/virtual_network)
+
+[!INCLUDE [AI attribution](../../includes/ai-generated-attribution.md)]
+
+## Prerequisites
+
+- [Install and configure Terraform](/azure/developer/terraform/quickstart-configure)
+
+## Implement the Terraform code
+
+> [!NOTE]
+> The sample code for this article is located in the [Azure Terraform GitHub repo](https://github.com/Azure/terraform/tree/master/quickstart/101-ddos-protection-plan). You can view the log file containing the [test results from current and previous versions of Terraform](https://github.com/Azure/terraform/tree/master/quickstart/101-ddos-protection-plan/TestRecord.md).
+> 
+> See more [articles and sample code showing how to use Terraform to manage Azure resources](/azure/terraform)
+
+1. Create a directory in which to test and run the sample Terraform code and make it the current directory.
+
+1. Create a file named `providers.tf` and insert the following code:
+
+    [!code-terraform[master](~/terraform_samples/quickstart/101-ddos-protection-plan/providers.tf)]
+
+1. Create a file named `main.tf` and insert the following code:
+
+    [!code-terraform[master](~/terraform_samples/quickstart/101-ddos-protection-plan/main.tf)]
+
+1. Create a file named `variables.tf` and insert the following code:
+
+    [!code-terraform[master](~/terraform_samples/quickstart/101-ddos-protection-plan/variables.tf)]
+
+1. Create a file named `outputs.tf` and insert the following code:
+
+    [!code-terraform[master](~/terraform_samples/quickstart/101-ddos-protection-plan/outputs.tf)]
+
+## Initialize Terraform
+
+[!INCLUDE [terraform-init.md](~/azure-dev-docs-pr/articles/terraform/includes/terraform-init.md)]
+
+## Create a Terraform execution plan
+
+[!INCLUDE [terraform-plan.md](~/azure-dev-docs-pr/articles/terraform/includes/terraform-plan.md)]
+
+## Apply a Terraform execution plan
+
+[!INCLUDE [terraform-apply-plan.md](~/azure-dev-docs-pr/articles/terraform/includes/terraform-apply-plan.md)]
+
+## Verify the results
+
+#### [Azure CLI](#tab/azure-cli)
+
+1. Get the Azure resource group name.
+
+    ```console
+    resource_group_name=$(terraform output -raw resource_group_name)
+    ```
+
+1. Get the DDoS protection plan name.
+
+    ```console
+    ddos_protection_plan_name=$(terraform output -raw ddos_protection_plan_name)
+    ```
+
+1. Run [az network ddos-protection show](/cli/azure/network/ddos-protection#az-network-ddos-protection-show) to display information about the new DDoS protection plan.
+
+    ```azurecli
+    az network ddos-protection show \
+        --resource-group $resource_group_name \
+        --name $ddos_protection_plan_name
+    ```
+
+#### [Azure PowerShell](#tab/azure-powershell)
+
+1. Get the Azure resource group name.
+
+    ```console
+    $resource_group_name=$(terraform output -raw resource_group_name)
+    ```
+
+1. Get the DDoS protection plan name.
+
+    ```console
+    $ddos_protection_plan_name=$(terraform output -raw ddos_protection_plan_name)
+    ```
+
+1. Run [Get-AzDdosProtectionPlan](/powershell/module/az.network/get-azddosprotectionplan) to display information about the new DDoS protection plan.
+
+    ```azurepowershell
+    Get-AzDdosProtectionPlan -ResourceGroupName $resource_group_name `
+                             -Name $ddos_protection_plan_name
+    ```
+
+1. Get the virtual network name.
+
+    ```console
+    $virtual_network_name=$(terraform output -raw virtual_network_name)
+    ```
+
+1. Run [Get-AzVirtualNetwork](/powershell/module/az.network/get-azvirtualnetwork) to display information about the new virtual network.
+
+    ```azurepowershell
+    Get-AzVirtualNetwork -ResourceGroupName $resource_group_name `
+                         -Name $virtual_network_name
+    ```
+
+---
+
+## Clean up resources
+
+[!INCLUDE [terraform-plan-destroy.md](~/azure-dev-docs-pr/articles/terraform/includes/terraform-plan-destroy.md)]
+
+## Troubleshoot Terraform on Azure
+
+[Troubleshoot common problems when using Terraform on Azure](/azure/developer/terraform/troubleshoot)
+
+## Next steps
+
+> [!div class="nextstepaction"] 
+> [View and configure DDoS protection telemetry](telemetry.md)