Merge pull request #263740 from asudbring/vnet-terraform-qs

Terraform QuickStart article for Azure Virtual Network

Author: JamesJBarnett

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 create an Azure Virtual Network and Subnets using Terraform. You 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 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: A container that holds related resources for an Azure solution. 
+
+- A virtual network: A fundamental building block for your private network in Azure. 
+
+- Two subnets: 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. Use [`az network vnet show`](/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
+
+ For more information about troubleshooting Terraform, see [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)

articles/virtual-network/toc.yml

@@ -16,6 +16,8 @@
     href: quick-create-bicep.md
   - name: Create virtual network - ARM template
     href: quick-create-template.md
+  - name: Create virtual network - Terraform
+    href: quick-create-terraform.md
   expanded: true
 - name: Tutorials
   items: