Document Details
Azure Arc Enable 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.
Bias Analysis
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 ID | Status | Bias Status |
|---|---|---|---|
| 2025-07-12 23:44 | #41 | in_progress | ❌ 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)
$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 containerapp connected-env create `
--resource-group $GROUP_NAME `
--name $CONNECTED_ENVIRONMENT_NAME `
--custom-location $CUSTOM_LOCATION_ID `
--location $LOCATION
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)