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 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 ID | Status | Bias Status |
|---|---|---|---|
| 2025-09-11 00:00 | #108 | completed | ✅ Clean |
| 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
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)