Document Details

Arc Enabled Workloads Arc Enabled Aks Cluster
Home / Scan 2 / Arc Enabled Workloads Arc Enabled Aks Cluster
❌
This page contains Windows bias

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Bias Types:
⚠️ powershell_heavy
⚠️ windows_first
⚠️ missing_linux_example
Summary:
The documentation page demonstrates a strong Windows bias by providing all command-line examples and automation scripts exclusively in PowerShell syntax. There are no Bash or Linux shell equivalents, and the scripting patterns (e.g., function definitions, parameter handling) are tailored for Windows/PowerShell users. This may hinder accessibility for Linux or macOS administrators, who are more likely to use Bash or other Unix shells.
Recommendations:
  • Provide equivalent Bash shell scripts for all PowerShell examples, especially for the main cluster creation workflow.
  • When showing command-line examples (such as az CLI usage), present both PowerShell and Bash syntax side-by-side or clearly indicate differences.
  • Avoid using PowerShell-specific constructs (like function definitions and parameter blocks) as the only automation example; instead, offer cross-platform alternatives.
  • Explicitly mention that the Azure CLI is cross-platform and can be used from Bash, PowerShell, or CMD, and link to relevant installation or usage guides for Linux/macOS.
  • Add a note or section for Linux/macOS users, clarifying any differences or additional steps required.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-07-13 21:37 #48 completed ❌ Biased
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

# Create an Arc-enabled AKS cluster on an edge zone function createArcEnabledAksOnEz { param( [string] $SubscriptionId, [string] $AKSClusterResourceGroupName, [string] $location = "westus", [string] $AKSName, [string] $edgeZone, [int] $nodeCount = 2, [string] $vmSize = "standard_nv12ads_a10_v5", [string] $ArcResourceGroupName, [switch] $Debug ) # Set the subscription az account set --subscription $SubscriptionId # Login to Azure az provider register --namespace Microsoft.AzureArcData # Create new resource group az group create --name $AKSClusterResourceGroupName --location $location # Create new cluster and deploy in edge zone Write-Output "Creating AKS cluster in edge zone..." az aks create -g $AKSClusterResourceGroupName -n $AKSName --location $location --edge-zone $edgeZone --node-count $nodeCount -s $vmSize --generate-ssh-keys # Create new resource group for Arc az group create --name $ArcResourceGroupName --location eastus # Download cluster credentials and get AKS cluster context az aks get-credentials --resource-group $AKSClusterResourceGroupName --name $AKSName --overwrite-existing # Connect the AKS cluster to Arc $CLUSTER_NAME = "$ArcResourceGroupName-cluster" # Name of the connected cluster resource Write-Output "Connecting AKS cluster to Azure Arc..." az connectedk8s connect --resource-group $ArcResourceGroupName --name $CLUSTER_NAME # DEBUG: Test connection to Arc if ($Debug) { Write-Debug az connectedk8s show --resource-group $ArcResourceGroupName --name $CLUSTER_NAME } } createArcEnabledAksOnEz -SubscriptionId "ffc37441-49e9-4291-a520-0b2d4972bb99" ` -AKSClusterResourceGroupName "t1" ` -location "westus" ` -AKSName "my-aks-cluster" ` -edgeZone "losangeles" ` -nodeCount 2 ` -vmSize "standard_nv12ads_a10_v5" ` -ArcResourceGroupName "t2"