updated and fixed all docs

Author: naman-msft

execution_log.csv

@@ -0,0 +1,54 @@
+Timestamp,Type,Input,Output,Number of Attempts,Errors Encountered,Execution Time (in seconds),Success/Failure
+2025-01-30 15:39:46,file,scenarios/ConfigurePythonContainer/configure-python-container.md,converted_configure-python-container.md,11,"time=2025-01-30T15:26:28-08:00 level=error msg=Error testing scenario: failed to execute code block 0 on step 0.
+Error: command exited with 'exit status 3' and the message 'ERROR: (ResourceGroupNotFound) Resource group 'MyResourceGroup' could not be found.
+Code: ResourceGroupNotFound
+Message: Resource group 'MyResourceGroup' could not be found.
+'
+StdErr: ERROR: (ResourceGroupNotFound) Resource group 'MyResourceGroup' could not be found.
+Code: ResourceGroupNotFound
+Message: Resource group 'MyResourceGroup' could not be found.
+
+ time=2025-01-30T15:26:53-08:00 level=error msg=Error testing scenario: failed to execute code block 0 on step 1.
+Error: command exited with 'exit status 3' and the message 'ERROR: (ResourceNotFound) The Resource 'Microsoft.Web/sites/MyPythonAppa47379' under resource group 'MyResourceGroupa47379' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix
+Code: ResourceNotFound
+Message: The Resource 'Microsoft.Web/sites/MyPythonAppa47379' under resource group 'MyResourceGroupa47379' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix
+'
+StdErr: ERROR: (ResourceNotFound) The Resource 'Microsoft.Web/sites/MyPythonAppa47379' under resource group 'MyResourceGroupa47379' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix
+Code: ResourceNotFound
+Message: The Resource 'Microsoft.Web/sites/MyPythonAppa47379' under resource group 'MyResourceGroupa47379' was not found. For more details please go to https://aka.ms/ARMResourceNotFoundFix
+
+ time=2025-01-30T15:28:05-08:00 level=error msg=Error testing scenario: failed to execute code block 0 on step 3.
+Error: json: cannot unmarshal string into Go value of type map[string]interface {}
+StdErr:
+
+ time=2025-01-30T15:29:16-08:00 level=error msg=Error testing scenario: failed to execute code block 0 on step 3.
+Error: json: cannot unmarshal string into Go value of type map[string]interface {}
+StdErr:
+
+ time=2025-01-30T15:30:54-08:00 level=error msg=Error testing scenario: failed to execute code block 0 on step 3.
+Error: json: cannot unmarshal string into Go value of type map[string]interface {}
+StdErr:
+
+ time=2025-01-30T15:32:31-08:00 level=error msg=Error testing scenario: failed to execute code block 0 on step 5.
+Error: json: cannot unmarshal array into Go value of type map[string]interface {}
+StdErr:
+
+ time=2025-01-30T15:33:57-08:00 level=error msg=Error testing scenario: failed to execute code block 0 on step 5.
+Error: json: cannot unmarshal array into Go value of type map[string]interface {}
+StdErr:
+
+ time=2025-01-30T15:35:31-08:00 level=error msg=Error testing scenario: failed to execute code block 0 on step 5.
+Error: json: cannot unmarshal array into Go value of type map[string]interface {}
+StdErr:
+
+ time=2025-01-30T15:36:46-08:00 level=error msg=Error testing scenario: failed to execute code block 0 on step 3.
+Error: json: cannot unmarshal string into Go value of type map[string]interface {}
+StdErr:
+
+ time=2025-01-30T15:38:05-08:00 level=error msg=Error testing scenario: failed to execute code block 0 on step 3.
+Error: json: cannot unmarshal string into Go value of type map[string]interface {}
+StdErr:
+
+ time=2025-01-30T15:39:46-08:00 level=error msg=Error testing scenario: failed to execute code block 0 on step 6.
+Error: json: cannot unmarshal array into Go value of type map[string]interface {}
+StdErr: WARNING: App settings have been redacted. Use `az webapp/logicapp/functionapp config appsettings list` to view.",813.0473608970642,Failure

scenarios/ConfigurePythonContainer/configure-python-container.md

@@ -0,0 +1,20 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: pg-app
+spec:
+  replicas: 2
+  selector:
+    matchLabels:
+      app: pg-app
+  template:
+    metadata:
+      labels:
+        app: pg-app
+    spec:
+      containers:
+      - name: pg-app
+        image: postgres:11
+        env:
+        - name: POSTGRES_DB
+          value:

scenarios/DeployHAPGOnAKSTerraform/app-deployment.yaml

@@ -0,0 +1,11 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: pg-app-service
+spec:
+  type: LoadBalancer
+  ports:
+    - port: 5432
+      targetPort: 5432
+  selector:
+    app: pg-app

scenarios/DeployHAPGOnAKSTerraform/app-service.yaml

@@ -14,42 +14,44 @@ In this guide, you will deploy a highly-available PostgreSQL cluster that spans
 
 ## Installing Terraform
 
-1. Update Package Index
-Before installing any software, it’s a good practice to update your package index. This ensures that you have the latest information about available packages
-
-```bash
-sudo apt-get update
-```
-
-
-2. Install Required Packages
-You need wget to download files from the internet and unzip to extract the downloaded files. Install them using the following command:
-
-```bash
-sudo apt-get install -y wget unzip
-```
-
-
 3. Download Terraform
 Use wget to download the latest version of Terraform. You can find the latest version on the Terraform releases page. For example, to download version 1.5.0:
 
 ```bash
-wget https://releases.hashicorp.com/terraform/1.5.0/terraform_1.5.0_linux_amd64.zip
+if ! command -v terraform &> /dev/null
+then
+    wget https://releases.hashicorp.com/terraform/1.5.0/terraform_1.5.0_linux_amd64.zip
+fi
 ```
 
 4. Unzip the Downloaded File
 After downloading, you need to extract the Terraform binary from the zip file:
 
 ```bash
-unzip terraform_1.5.0_linux_amd64.zip
+if ! command -v terraform &> /dev/null
+then
+  unzip terraform_1.5.0_linux_amd64.zip
+fi
 ```
 
 
 5. Move Teffaform to a Directory in Your PATH
 To make Terraform accessible from anywhere in your terminal, move it to /usr/local/bin:
 
 ```bash
-sudo mv terraform /usr/local/bin/
+if ! command -v terraform &> /dev/null
+then
+  # Create a bin directory in your home directory if it doesn't exist
+  mkdir -p $HOME/bin
+
+  # Move Terraform to the bin directory in your home directory
+  mv terraform $HOME/bin/
+
+  # Add the bin directory to your PATH if it's not already included
+  if [[ ":$PATH:" != *":$HOME/bin:"* ]]; then
+      export PATH="$HOME/bin:$PATH"
+  fi
+fi
 ```
 
 
@@ -71,18 +73,41 @@ Terraform v1.5.0
 
 1. Create a Terraform Configuration File Create a file named main.tf with the following content:
 
+```bash
+# Generate a random suffix
+export RANDOM_SUFFIX=$(openssl rand -hex 4)
+export RESOURCE_GROUP_NAME="pg-ha-rg$RANDOM_SUFFIX"
+export AKS_CLUSTER_NAME="pg-ha-aks$RANDOM_SUFFIX"
+export POSTGRES_SERVER_NAME="pg-ha-server$RANDOM_SUFFIX"
+export POSTGRES_DATABASE_NAME=$POSTGRES_DATABASE_NAME
+export POSTGRES_DATABASE_PASSWORD=$(openssl rand -base64 32)
+export POSTGRES_DATABASE_USER="pgadmin$RANDOM_SUFFIX"
+
+# Get the subscription ID programmatically
+export TF_VAR_subscription_id=$(az account show --query id --output tsv)
+
+# Set additional environment variables for Terraform
+export TF_VAR_resource_group_name=$RESOURCE_GROUP_NAME
+export TF_VAR_location="East US"
+export TF_VAR_aks_cluster_name=$AKS_CLUSTER_NAME
+export TF_VAR_postgres_server_name=$POSTGRES_SERVER_NAME
+export TF_VAR_postgres_database_name=$POSTGRES_DATABASE_NAME
+export TF_VAR_postgres_database_user=$POSTGRES_DATABASE_USER
+export TF_VAR_postgres_database_password=$POSTGRES_DATABASE_PASSWORD
+```
+
 ```text
 provider "azurerm" {
   features {}
 }
 
 resource "azurerm_resource_group" "rg" {
-  name     = "pg-ha-rg"
+  name     = $RESOURCE_GROUP_NAME
   location = "West Europe"
 }
 
 resource "azurerm_kubernetes_cluster" "aks" {
-  name                = "pg-ha-aks"
+  name                = $AKS_CLUSTER_NAME
   location            = azurerm_resource_group.rg.location
   resource_group_name = azurerm_resource_group.rg.name
   dns_prefix          = "pgha"
@@ -105,7 +130,7 @@ resource "azurerm_kubernetes_cluster" "aks" {
 }
 
 resource "azurerm_postgresql_server" "pg_server" {
-  name                = "pg-ha-server"
+  name                = $POSTGRES_SERVER_NAME
   resource_group_name = azurerm_resource_group.rg.name
   location            = azurerm_resource_group.rg.location
   version             = "11"
@@ -117,13 +142,13 @@ resource "azurerm_postgresql_server" "pg_server" {
   storage_profile {
     storage_mb = 5120
   }
-  administrator_login          = "pgadmin"
-  administrator_login_password = "YourPassword123!"
+  administrator_login          = $POSTGRES_DATABASE_USER
+  administrator_login_password = $POSTGRES_DATABASE_PASSWORD
   ssl_enforcement_enabled      = true
 }
 
 resource "azurerm_postgresql_database" "pg_database" {
-  name                = "mydatabase"
+  name                = $POSTGRES_DATABASE_NAME
   resource_group_name = azurerm_resource_group.rg.name
   server_name         = azurerm_postgresql_server.pg_server.name
   charset             = "UTF8"
@@ -211,7 +236,7 @@ Apply complete! Resources: 3 added, 0 changed, 0 destroyed.
 6. Verify the Deployment Check the status of the AKS cluster:
 
 ```bash
-az aks show --resource-group pg-ha-rg --name pg-ha-aks --output table
+az aks show --resource-group $RESOURCE_GROUP_NAME --name $AKS_CLUSTER_NAME --output table
 ```
 
 Results:
@@ -226,7 +251,7 @@ pg-ha-aks   pg-ha-rg       West Europe     1.20.7               Succeeded
 7. Connect to PostgreSQL To connect to your PostgreSQL server, you can use the following command:
 
 ```bash
-psql "host=pg-ha-server.postgres.database.azure.com dbname=mydatabase user=pgadmin@pg-ha-server password=YourPassword123! sslmode=require"
+psql "host=$POSTGRES_SERVER_NAME.postgres.database.azure.com dbname=$POSTGRES_DATABASE_NAME user=$POSTGRES_DATABASE_USER@$POSTGRES_SERVER_NAME password=$POSTGRES_DATABASE_PASSWORD sslmode=require"
 ```
 
 Results:
@@ -311,7 +336,17 @@ Wait a few moments until the EXTERNAL-IP is assigned. It may take a couple of mi
 3. Connect to the Application Once the external IP is assigned, you can connect to the PostgreSQL database using the following command. Replace <EXTERNAL-IP> with the actual external IP address you obtained from the previous step:
 
 ```bash
-psql "host=<EXTERNAL-IP> dbname=mydatabase user=pgadmin@pg-ha-server password=YourPassword123! sslmode=require"
+# Fetch the external IP address
+export EXTERNAL_IP=$(kubectl get services pg-app-service -o jsonpath='{.status.loadBalancer.ingress[0].ip}')
+
+# Check if the EXTERNAL_IP is not empty
+if [ -z "$EXTERNAL_IP" ]; then
+  echo "Error: External IP address not found. Please wait a few moments and try again."
+  exit 1
+fi
+
+# Connect to the PostgreSQL database
+psql "host=$EXTERNAL_IP dbname=mydatabase user=pgadmin@pg-ha-server password=YourPassword123! sslmode=require"
 ```
 
 Results:

scenarios/DeployHAPGOnAKSTerraform/deploy-ha-pg-on-aks-terraform.md

@@ -1,15 +1,15 @@
 provider "azurerm" {
   features {}
-  subscription_id = "325e7c34-99fb-4190-aa87-1df746c67705"
+  subscription_id = var.subscription_id
 }
 
 resource "azurerm_resource_group" "rg" {
-  name     = "pg-ha-rg"
-  location = "East US"
+  name     = var.resource_group_name
+  location = var.location
 }
 
 resource "azurerm_kubernetes_cluster" "aks" {
-  name                = "pg-ha-aks"
+  name                = var.aks_cluster_name
   location            = azurerm_resource_group.rg.location
   resource_group_name = azurerm_resource_group.rg.name
   dns_prefix          = "pgha"
@@ -26,19 +26,19 @@ resource "azurerm_kubernetes_cluster" "aks" {
 }
 
 resource "azurerm_postgresql_server" "pg_server" {
-  name                         = "pg-ha-server"
+  name                         = var.postgres_server_name
   resource_group_name          = azurerm_resource_group.rg.name
   location                     = azurerm_resource_group.rg.location
   version                      = "11"
-  administrator_login          = "pgadmin"
-  administrator_login_password = "YourPassword123!"
+  administrator_login          = var.postgres_database_user
+  administrator_login_password = var.postgres_database_password
   ssl_enforcement_enabled      = true
   sku_name                     = "B_Gen5_2"
   storage_mb                   = 5120
 }
 
 resource "azurerm_postgresql_database" "pg_database" {
-  name                = "mydatabase"
+  name                = var.postgres_database_name
   resource_group_name = azurerm_resource_group.rg.name
   server_name         = azurerm_postgresql_server.pg_server.name
   charset             = "UTF8"

scenarios/DeployHAPGOnAKSTerraform/main.tf

@@ -0,0 +1,40 @@
+variable "subscription_id" {
+  description = "Azure Subscription ID"
+  type        = string
+}
+
+variable "resource_group_name" {
+  description = "Resource Group Name"
+  type        = string
+}
+
+variable "location" {
+  description = "Azure Region"
+  type        = string
+}
+
+variable "aks_cluster_name" {
+  description = "AKS Cluster Name"
+  type        = string
+}
+
+variable "postgres_server_name" {
+  description = "PostgreSQL Server Name"
+  type        = string
+}
+
+variable "postgres_database_name" {
+  description = "PostgreSQL Database Name"
+  type        = string
+}
+
+variable "postgres_database_user" {
+  description = "PostgreSQL Database User"
+  type        = string
+}
+
+variable "postgres_database_password" {
+  description = "PostgreSQL Database Password"
+  type        = string
+  sensitive   = true
+}

scenarios/DeployHAPGOnAKSTerraform/variables.tf

@@ -236,7 +236,8 @@ Use the [az disk update](/cli/azure/disk#az-disk-update) command to change the p
 The following command adjusts the performance of your disk. Update the values in the command, and then run it:
 
 ```azurecli
-az disk update --subscription $subscription --resource-group $rgname --name $MY_DISK_NAME --disk-iops-read-write=5000 --disk-mbps-read-write=200
+export SUBSCRIPTION_ID=$(az account show --query id --output tsv)
+az disk update --subscription $SUBSCRIPTION_ID --resource-group $MY_RESOURCE_GROUP_NAME --name $MY_DISK_NAME --disk-iops-read-write=5000 --disk-mbps-read-write=200
 ```
 
 # [PowerShell](#tab/azure-powershell)

scenarios/DeployPremiumSSDV2/deploy-premium-ssd-v2.md

@@ -55,7 +55,7 @@ az vm run-command invoke --resource-group $MY_RESOURCE_GROUP_NAME --name $MY_VM_
 
 ## CPU
 
-### <a id="mpstat"></a>mpstat
+### mpstat
 
 The `mpstat` utility is part of the `sysstat` package. It displays per CPU utilization and averages, which is helpful to quickly identify CPU usage. `mpstat` provides an overview of CPU utilization across the available CPUs, helping identify usage balance and if a single CPU is heavily loaded.