Azure Arc Enable Cluster - Document Details

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 explicit Linux shell (e.g., Bash) examples outside of the Azure CLI tab. PowerShell is given equal prominence to Azure CLI, which is more commonly used on Windows. There are no Linux-specific instructions, troubleshooting, or environment notes, and PowerShell is not natively available on most Linux distributions. The structure (CLI first, then PowerShell) is better than Windows-first, but the parity is not complete for Linux users.

Recommendations

Clarify in the prerequisites or setup sections that Azure CLI commands are intended for Bash or compatible Linux shells, and provide explicit Bash examples where environment variable syntax or command usage differs from PowerShell.
Remove or de-emphasize PowerShell examples unless there is a specific Windows-only step, or add a dedicated Bash/Linux tab for clarity.
Add troubleshooting notes or environment setup tips for Linux users, such as installing required tools (e.g., base64 with -w0 flag, which differs on macOS), and note any differences in command output or file paths (e.g., ~/.kube/config).
Where environment variables are set, ensure the Bash syntax is always shown and explained, as PowerShell variable assignment is not portable to Linux.
If PowerShell is to be retained, clarify that it is cross-platform but less common on Linux, and provide guidance for users who may not have it installed.

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

    $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}"

    $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