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 commands, but does not include any Linux-specific shell examples beyond Bash, nor does it mention or prioritize Linux-native tools or workflows. In most cases, PowerShell examples are presented alongside Bash, but the presence of PowerShell throughout and the lack of explicit Linux (e.g., zsh, fish, or other Linux shell) or macOS guidance suggests a mild Windows bias. Additionally, PowerShell examples are always present, and sometimes the syntax (such as variable assignment) is tailored for Windows/PowerShell users.

Recommendations

Clarify that Bash examples are suitable for Linux and macOS users, and PowerShell is for Windows users.
Explicitly mention Linux and macOS compatibility in the prerequisites and setup sections.
Where environment variables are set, note any differences in syntax or behavior between Bash (Linux/macOS) and PowerShell (Windows).
Consider adding a short section or note for users on Linux or macOS, confirming that all Azure CLI commands work natively in their environments.
If possible, provide troubleshooting tips or links for common issues encountered on Linux/macOS (e.g., file permissions, path differences).

Create Pull Request

Scan History

Date	Scan	Status	Result
2025-07-12 23:44	#41	cancelled	Biased
2025-07-12 00:58	#8	cancelled	Clean
2025-07-10 05:06	#7	processing	Clean

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

    $EXTENSION_ID=$(az k8s-extension show `
        --cluster-type connectedClusters `
        --cluster-name $CLUSTER_NAME `
        --resource-group $GROUP_NAME `
        --name $EXTENSION_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"

    $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)