updating the tools folder

Author: naman-msft

tools/Deploy Linux VM with SSH Access_ai_generated.md

@@ -1,44 +1,42 @@
 ---
-title: 'Quickstart: Create a Linux VM and SSH into it'
-description: Learn how to create a Linux virtual machine in Azure and SSH into it using Azure CLI commands within an Exec Doc.
+title: Quickstart: Create a Linux VM and SSH into it using Azure CLI
+description: Learn how to create a Linux virtual machine on Azure and connect to it using SSH with pre-generated SSH keys. This Exec Doc demonstrates deploying the VM in a uniquely named resource group, retrieving its public IP address, and providing the SSH command to connect.
 ms.topic: quickstart
-ms.date: 10/12/2023
-author: azureuser123
-ms.author: azureuser123
-ms.custom: innovation-engine, azurecli, linux-related-content
+ms.date: 10/07/2023
+author: chatgpt
+ms.author: chatgpt
+ms.custom: innovation-engine, azurecli, linux-vm
 ---
 
-In this Exec Doc, you will learn how to create a Linux virtual machine (VM) in Azure using the Azure CLI and then SSH into the newly created VM. All commands have been configured to run non-interactively. Remember to update any variables if necessary and note that resources are appended with a random suffix to avoid naming conflicts in subsequent runs.
+# Quickstart: Create a Linux VM and SSH into it using Azure CLI
 
-## Step 1: Set Environment Variables
+This Exec Doc walks you through deploying a Linux virtual machine (VM) on Azure using the Azure CLI. The VM is deployed in a new resource group with a random suffix to ensure uniqueness. Once the VM is created, the public IP is retrieved and an SSH command is provided so you can connect to the VM.
 
-In this step, we declare the environment variables that will be used throughout the Exec Doc. A random suffix is appended to the resource group and VM names to ensure uniqueness.
+## Step 1: Set Environment Variables and Create a Resource Group
+
+In this step, we declare environment variables that will be used throughout the Exec Doc. We generate random suffixes to ensure that resource names are unique between successive runs.
 
 ```bash
 export RANDOM_SUFFIX=$(openssl rand -hex 3)
-export REGION="WestUS2"
-export MY_RESOURCE_GROUP_NAME="MyResourceGroup$RANDOM_SUFFIX"
-export MY_VM_NAME="MyLinuxVM$RANDOM_SUFFIX"
+export RESOURCE_GROUP="MyResourceGroup$RANDOM_SUFFIX"
+export REGION="centralindia"
 ```
 
-## Step 2: Create a Resource Group
-
-This step creates a new resource group in the specified region.
+Next, we create a resource group in the specified region.
 
 ```bash
-az group create --name $MY_RESOURCE_GROUP_NAME --location $REGION
+az group create --name $RESOURCE_GROUP --location $REGION
 ```
 
-Results: 
+Results:
 
 <!-- expected_similarity=0.3 -->
-
 ```JSON
 {
-  "id": "/subscriptions/xxxxx-xxxxx-xxxxx-xxxxx/resourceGroups/MyResourceGroupxxxxx",
-  "location": "WestUS2",
+  "id": "/subscriptions/xxxxx-xxxxx-xxxxx-xxxxx/resourceGroups/MyResourceGroupxxx",
+  "location": "centralindia",
   "managedBy": null,
-  "name": "MyResourceGroupxxxxx",
+  "name": "MyResourceGroupxxx",
   "properties": {
     "provisioningState": "Succeeded"
   },
@@ -47,46 +45,54 @@ Results:
 }
 ```
 
-## Step 3: Create a Linux Virtual Machine
+## Step 2: Create the Linux Virtual Machine
 
-Now you will create a Linux VM using the Ubuntu LTS image. The command includes the generation of SSH keys if they do not already exist. The default administrator username is set to "azureuser".
+Now that the resource group is ready, we create a Linux VM. In this example, the VM is created with an Ubuntu 22.04 image, which is a valid image name. A default administrator username is provided and SSH keys are generated automatically if they do not exist in your environment.
 
 ```bash
-az vm create --resource-group $MY_RESOURCE_GROUP_NAME --name $MY_VM_NAME --image UbuntuLTS --admin-username azureuser --generate-ssh-keys
+export VM_NAME="LinuxVm$RANDOM_SUFFIX"
+az vm create --resource-group $RESOURCE_GROUP --name $VM_NAME --image Ubuntu2204 --admin-username azureuser --generate-ssh-keys
 ```
 
-Results: 
+Results:
 
 <!-- expected_similarity=0.3 -->
-
 ```JSON
 {
   "fqdns": "",
-  "id": "/subscriptions/xxxxx-xxxxx-xxxxx-xxxxx/resourceGroups/MyResourceGroupxxxxx/providers/Microsoft.Compute/virtualMachines/MyLinuxVMxxxxx",
-  "location": "WestUS2",
-  "name": "MyLinuxVMxxxxx",
+  "id": "/subscriptions/xxxxx-xxxxx-xxxxx-xxxxx/resourceGroups/MyResourceGroupxxx/providers/Microsoft.Compute/virtualMachines/LinuxVmxxx",
+  "location": "centralindia",
+  "macAddress": "...",
   "powerState": "VM running",
   "privateIpAddress": "10.0.0.4",
-  "publicIpAddress": "52.xxx.xxx.xxx"
+  "publicIpAddress": "xx.xx.xx.xx",
+  "resourceGroup": "MyResourceGroupxxx",
+  "zones": ""
 }
 ```
 
-## Step 4: Retrieve the VM's Public IP Address
+## Step 3: Retrieve the VM's Public IP Address
 
-Next, you retrieve the public IP address of the newly created VM. This value is stored in an environment variable for later use in the SSH command.
+After the VM is created, we need its public IP address to connect via SSH. The following command queries the public IP address from the VM's network settings and stores it in an environment variable.
 
 ```bash
-export PUBLIC_IP=$(az vm show -d --resource-group $MY_RESOURCE_GROUP_NAME --name $MY_VM_NAME --query publicIps -o tsv)
+export PUBLIC_IP=$(az vm list-ip-addresses --resource-group $RESOURCE_GROUP --name $VM_NAME --query "[].virtualMachine.network.publicIpAddresses[0].ipAddress" -o tsv)
+echo "The public IP of the VM is: $PUBLIC_IP"
 ```
 
-## Step 5: SSH into the VM
+Results:
 
-Finally, use the SSH command to connect to your Linux VM. The SSH command includes the option to disable strict host key checking to avoid interactive prompts during the first connection.
+<!-- expected_similarity=0.3 -->
+```text
+The public IP of the VM is: xx.xx.xx.xx
+```
+
+## Step 4: SSH into the Linux VM
+
+Now that you have the public IP, the following SSH command is provided for informational purposes. When executed, it will open an interactive SSH session into the Linux VM.
 
 ```bash
-ssh -o StrictHostKeyChecking=no azureuser@$PUBLIC_IP
+ssh azureuser@$PUBLIC_IP
 ```
 
-This SSH command connects you to the VM using the default administrator account "azureuser". Once connected, you can start managing your Linux environment directly.
-
-Happy learning and exploring your new Linux VM in Azure!
+This completes the Exec Doc for deploying a Linux VM and connecting to it via SSH using the Azure CLI.