Azure Arc Enable Cluster - Document Details

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.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types

powershell_heavy

windows_first

Summary

The documentation provides both Azure CLI (Bash) and PowerShell examples for all steps, but does not include any Linux-specific shell examples (such as plain Bash or zsh), nor does it mention Linux tooling or patterns. PowerShell is given equal prominence to Azure CLI, which is more common on Windows, and the PowerShell examples use Windows-style variable syntax. In some cases, PowerShell examples are shown before or alongside CLI, but there is no explicit Linux-first approach. There are no examples or notes for Linux-specific environments, nor any mention of WSL or native Linux shells.

Recommendations

Add explicit Bash (Linux/macOS) examples where relevant, especially for environment variable syntax and command usage.
Clarify that Azure CLI examples are intended for Bash/zsh shells on Linux/macOS, and PowerShell examples are for Windows users.
Consider providing a Linux/macOS tab (with Bash syntax) in addition to Azure CLI and PowerShell, or clarify that the Azure CLI tab uses Bash.
Include notes on any differences in command output or file paths (e.g., kubeconfig location) between Windows and Linux.
Where PowerShell is used, ensure it is not presented as the default or primary method unless justified by audience data.

Create Pull Request

Scan History

Date	Scan	Status	Result
2026-01-16 00:00	#258	completed	Biased
2026-01-14 00:00	#250	in_progress	Biased
2026-01-13 00:00	#246	completed	Biased
2026-01-11 00:00	#240	completed	Biased
2026-01-10 00:00	#237	completed	Biased
2026-01-09 00:34	#234	completed	Biased
2026-01-08 00:53	#231	completed	Biased
2026-01-06 18:15	#225	cancelled	Clean
2025-09-11 00:00	#108	completed	Clean
2025-08-17 00:01	#83	cancelled	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

    az group create --name $AKS_CLUSTER_GROUP_NAME --location $LOCATION
    az aks create `
       --resource-group $AKS_CLUSTER_GROUP_NAME `
       --name $AKS_NAME `
       --enable-aad `
       --generate-ssh-keys

    $WORKSPACE_NAME="$GROUP_NAME-workspace"

    az monitor log-analytics workspace create `
        --resource-group $GROUP_NAME `
        --workspace-name $WORKSPACE_NAME

    $LOG_ANALYTICS_WORKSPACE_ID=$(az monitor log-analytics workspace show `
        --resource-group $GROUP_NAME `
        --workspace-name $WORKSPACE_NAME `
        --query customerId `
        --output tsv)
    $LOG_ANALYTICS_WORKSPACE_ID_ENC=[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($LOG_ANALYTICS_WORKSPACE_ID))# Needed for the next step
    $LOG_ANALYTICS_KEY=$(az monitor log-analytics workspace get-shared-keys `
        --resource-group $GROUP_NAME `
        --workspace-name $WORKSPACE_NAME `
        --query primarySharedKey `
        --output tsv)
    $LOG_ANALYTICS_KEY_ENC=[Convert]::ToBase64String([System.Text.Encoding]::UTF8.GetBytes($LOG_ANALYTICS_KEY))

    $EXTENSION_NAME="appenv-ext"
    $NAMESPACE="appplat-ns"
    $CONNECTED_ENVIRONMENT_NAME="<connected-environment-name>"

    az k8s-extension create `
        --resource-group $GROUP_NAME `
        --name $EXTENSION_NAME `
        --cluster-type connectedClusters `
        --cluster-name $CLUSTER_NAME `
        --extension-type 'Microsoft.App.Environment' `
        --release-train stable `
        --auto-upgrade-minor-version true `
        --scope cluster `
        --release-namespace $NAMESPACE `
        --configuration-settings "Microsoft.CustomLocation.ServiceAccount=default" `
        --configuration-settings "appsNamespace=${NAMESPACE}" `
        --configuration-settings "clusterName=${CONNECTED_ENVIRONMENT_NAME}" `
        --configuration-settings "logProcessor.appLogs.destination=log-analytics" `
        --configuration-protected-settings "logProcessor.appLogs.logAnalyticsConfig.customerId=${LOG_ANALYTICS_WORKSPACE_ID_ENC}" `
        --configuration-protected-settings "logProcessor.appLogs.logAnalyticsConfig.sharedKey=${LOG_ANALYTICS_KEY_ENC}"

    $CUSTOM_LOCATION_NAME="my-custom-location" # Name of the custom location
    $CONNECTED_CLUSTER_ID=$(az connectedk8s show --resource-group $GROUP_NAME --name $CLUSTER_NAME --query id --output tsv)

    az customlocation create `
        --resource-group $GROUP_NAME `
        --name $CUSTOM_LOCATION_NAME `
        --host-resource-id $CONNECTED_CLUSTER_ID `
        --namespace $NAMESPACE `
        --cluster-extension-ids $EXTENSION_ID

    $CUSTOM_LOCATION_ID=$(az customlocation show `
        --resource-group $GROUP_NAME `
        --name $CUSTOM_LOCATION_NAME `
        --query id `
        --output tsv)

    az containerapp connected-env create `
        --resource-group $GROUP_NAME `
        --name $CONNECTED_ENVIRONMENT_NAME `
        --custom-location $CUSTOM_LOCATION_ID `
        --location $LOCATION

$GROUP_NAME="my-arc-cluster-group"
$AKS_CLUSTER_GROUP_NAME="my-aks-cluster-group"
$AKS_NAME="my-aks-cluster"
$LOCATION="eastus"

    $EXTENSION_ID=$(az k8s-extension show `
        --cluster-type connectedClusters `
        --cluster-name $CLUSTER_NAME `
        --resource-group $GROUP_NAME `
        --name $EXTENSION_NAME `
        --query id `
        --output tsv)