Document Details
Reference Kubernetes Provider
❌
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:
⚠️
windows_first
Summary:
The documentation demonstrates a subtle Windows bias in its references to Azure VMSS (Virtual Machine Scale Sets) and managed identities. Specifically, links and instructions for enabling managed identities and assigning roles reference Windows VMSS documentation and URLs, even though AKS clusters can run on Linux VMSS as well. No explicit PowerShell or Windows-only command-line examples are present, and all CLI and YAML examples are cross-platform. However, the documentation consistently references Windows VMSS in authentication scenarios, which may confuse or exclude Linux VMSS users.
Recommendations:
- Wherever managed identity or VMSS is referenced, provide links and instructions for both Windows and Linux VMSS. For example, link to both Windows and Linux quickstarts for enabling managed identity.
- Clarify in the authentication sections that the instructions apply to both Windows and Linux VMSS, or specify any differences if they exist.
- Audit all links to Azure documentation to ensure they are not Windows-specific unless required. If both OSes are supported, use generic or dual links.
- Explicitly state that AKS clusters typically run on Linux VMSS and provide Linux-centric examples or notes where appropriate.
Create pull request
Scan History
| Date | Scan ID | Status | Bias Status |
|---|---|---|---|
| 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
#### Use user-assigned managed identity of virtual machine scale set
1. [Create a user-assigned managed identity](/azure/active-directory/managed-identities-azure-resources/how-manage-user-assigned-managed-identities#create-a-user-assigned-managed-identity) and note down its client ID after creation.
1. [Assign the user-assigned managed identity to the virtual machine scale set](/azure/active-directory/managed-identities-azure-resources/qs-configure-portal-windows-vmss#user-assigned-managed-identity) used by the Azure Kubernetes Service (AKS) cluster.
1. [Grant the user-assigned managed identity **App Configuration Data Reader** role](/azure/active-directory/managed-identities-azure-resources/qs-configure-portal-windows-vmss#user-assigned-managed-identity) in Azure App Configuration.
1. Set the `spec.auth.managedIdentityClientId` property to the client ID of the user-assigned managed identity in the following sample `AzureAppConfigurationProvider` resource and deploy it to the AKS cluster.