Merge pull request #209785 from TomArcherMsft/UserStory1983533

User Story 1983528

Author: 19BMG00

articles/virtual-machines/TOC.yml

@@ -18,6 +18,9 @@
     - name: ARM template
       displayName: Resource Manager
       href: ./linux/quick-create-template.md
+    - name: Terraform
+      displayName: Terraform
+      href: ./linux/quick-create-terraform.md
   - name: Create a Windows VM
     items:
     - name: CLI

articles/virtual-machines/index.yml

@@ -43,6 +43,8 @@ landingContent:
             url: ./linux/quick-create-portal.md
           - text: Azure PowerShell
             url: ./linux/quick-create-powershell.md
+          - text: Terraform
+            url: ./linux/quick-create-terraform.md
 
   # Card (optional)
   - title: Windows quickstarts

articles/virtual-machines/linux/quick-create-terraform.md

@@ -0,0 +1,120 @@
+---
+title: 'Quickstart: Use Terraform to create a Linux VM'
+description: In this quickstart, you learn how to use Terraform to create a Linux virtual machine
+author: tomarchermsft
+ms.service: virtual-machines
+ms.collection: linux
+ms.topic: quickstart
+ms.workload: infrastructure
+ms.date: 08/31/2022
+ms.author: tarcher
+ms.custom: devx-track-terraform
+---
+
+# Quickstart: Use Terraform to create a Linux VM
+
+**Applies to:** :heavy_check_mark: Linux VMs 
+
+Article tested with the following Terraform and Terraform provider versions:
+
+- [Terraform v1.2.7](https://releases.hashicorp.com/terraform/)
+- [AzureRM Provider v.3.20.0](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs)
+
+This article shows you how to create a complete Linux environment and supporting resources with Terraform. Those resources include a virtual network, subnet, public IP address, and more.
+
+[!INCLUDE [Terraform abstract](~/azure-dev-docs-pr/articles/terraform/includes/abstract.md)]
+
+In this article, you learn how to:
+> [!div class="checklist"]
+
+> * Create a virtual network
+> * Create a subnet
+> * Create a public IP address
+> * Create a network security group and SSH inbound rule
+> * Create a virtual network interface card
+> * Connect the network security group to the network interface
+> * Create a storage account for boot diagnostics
+> * Create SSH key
+> * Create a virtual machine
+> * Use SSH to connect to virtual machine
+
+> [!NOTE]
+> The example code in this article is located in the [Microsoft Terraform GitHub repo](https://github.com/Azure/terraform/tree/master/quickstart/101-vm-with-infrastructure). See more [articles and sample code showing how to use Terraform to manage Azure resources](/azure/terraform)
+
+## Prerequisites
+
+[!INCLUDE [open-source-devops-prereqs-azure-subscription.md](~/azure-dev-docs-pr/articles/includes/open-source-devops-prereqs-azure-subscription.md)]
+
+- [Install and configure Terraform](/azure/developer/terraform/quickstart-configure)
+
+## Implement the Terraform code
+
+1. Create a directory in which to test 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-vm-with-infrastructure/providers.tf)]
+
+1. Create a file named `main.tf` and insert the following code:
+
+    [!code-terraform[master](~/terraform_samples/quickstart/101-vm-with-infrastructure/main.tf)]
+
+1. Create a file named `variables.tf` and insert the following code:
+
+    [!code-terraform[master](~/terraform_samples/quickstart/101-vm-with-infrastructure/variables.tf)]
+
+1. Create a file named `outputs.tf` and insert the following code:
+
+    [!code-terraform[master](~/terraform_samples/quickstart/101-vm-with-infrastructure/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
+
+To use SSH to connect to the virtual machine, do the following steps:
+
+1. Run [terraform output](https://www.terraform.io/cli/commands/output) to get the SSH private key and save it to a file.
+
+    ```console
+    terraform output -raw tls_private_key > id_rsa
+    ```
+
+1. Run [terraform output](https://www.terraform.io/cli/commands/output) to get the virtual machine public IP address.
+
+    ```console
+    terraform output public_ip_address
+    ```
+
+1. Use SSH to connect to the virtual machine.
+
+    ```console
+    ssh -i id_rsa azureuser@<public_ip_address>
+    ```
+
+    **Key points:** 
+    - Depending on the permissions of your environment, you might get an error when trying to ssh into the virtual machine using  the `id_rsa` key file. If you get an error stating that the private key file is unprotected and can't be used, try running the following command: `chmod 600 id_rsa`, which will restrict read and write access to the owner of the file.
+
+## 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
+
+In this quickstart, you deployed a simple virtual machine using Terraform. To learn more about Azure virtual machines, continue to the tutorial for Linux VMs.
+
+> [!div class="nextstepaction"]
+> [Azure Linux virtual machine tutorials](./tutorial-manage-vm.md)