added terraform quickstart

Author: asudbring

articles/virtual-network/quick-create-terraform.md

@@ -0,0 +1,113 @@
+---
+title: 'Quickstart: Create virtual network and subnets using Terraform'
+titleSuffix: Azure Virtual Network
+description: In this quickstart, you'll create an Azure Virtual Network and Subnets using Terraform. You'll use Azure CLI to verify the resources.
+ms.topic: quickstart
+ms.date: 1/19/2024
+ms.custom: devx-track-terraform
+ms.service: virtual-network
+author: asudbring
+ms.author: allensu
+content_well_notification: 
+  - AI-contribution
+# Customer intent: As a Network Administrator, I want to create a virtual network and subnets using Terraform.
+---
+
+# Quickstart: Create an Azure Virtual Network and Subnets using Terraform
+
+In this quickstart you will learn about a Terraform script that creates an Azure resource group and a virtual network with two subnets. The names of the resource group and the virtual network are generated using a random pet name with a prefix. The script also outputs the names of the created resources. 
+
+The script uses the Azure Resource Manager (azurerm) and Random (random) providers. The azurerm provider is used to interact with Azure resources, while the random provider is used to generate random pet names for the resources. 
+
+The script creates the following resources:
+
+- A resource group: This is a container that holds related resources for an Azure solution. 
+
+- A virtual network: This is the fundamental building block for your private network in Azure. 
+
+- Two subnets: These are segments of a virtual network's IP address range where you can place groups of isolated resources.
+
+[!INCLUDE [About Terraform](~/azure-dev-docs-pr/articles/terraform/includes/abstract.md)]
+
+## Prerequisites
+
+- An Azure account with an active subscription. You can [create an account for free](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
+
+- [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-virtual-network-create-two-subnets). 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-virtual-network-create-two-subnets/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 `main.tf` and insert the following code:
+
+    :::code language="Terraform" source="~/terraform_samples/quickstart/101-virtual-network-create-two-subnets/main.tf":::
+
+1. Create a file named `outputs.tf` and insert the following code:
+
+    :::code language="Terraform" source="~/terraform_samples/quickstart/101-virtual-network-create-two-subnets/outputs.tf":::
+
+1. Create a file named `providers.tf` and insert the following code:
+
+    :::code language="Terraform" source="~/terraform_samples/quickstart/101-virtual-network-create-two-subnets/providers.tf":::
+
+1. Create a file named `variables.tf` and insert the following code:
+
+    :::code language="Terraform" source="~/terraform_samples/quickstart/101-virtual-network-create-two-subnets/variables.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 virtual network name.
+
+    ```console
+    virtual_network_name=$(terraform output -raw virtual_network_name)
+    ```
+
+1. Run [/cli/azure/network/vnet#az-network-vnet-show] to display the details of your newly created virtual network.
+
+    ```azurecli
+    az network vnet show \
+        --resource-group $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"] 
+> [Learn more about using Terraform in Azure](/azure/terraform)