Document Details
Batch Upgrade Policy
❌
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
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation page demonstrates a Windows bias by providing only Windows-based examples for both REST API and SDK usage. The sample configurations and code exclusively reference Windows images (e.g., MicrosoftWindowsServer, WindowsServer, batch.node.windows amd64) and Windows-specific properties (windowsConfiguration, enableAutomaticUpdates). There are no examples or guidance for provisioning Linux-based pools, nor are Linux image references or configuration options discussed. The documentation also references Windows Update and in-VM patching in a way that is specific to Windows, without mentioning the Linux equivalents.
Recommendations:
- Add parallel examples for Linux pools, including REST API and SDK (C#) snippets that use Linux image references (e.g., Ubuntu, CentOS) and nodeAgentSkuId values appropriate for Linux.
- Explicitly document Linux-specific configuration options, such as linuxConfiguration blocks, and discuss any differences in automatic OS upgrade behavior between Windows and Linux.
- Mention Linux update mechanisms (e.g., package manager updates) where Windows Update is discussed, or clarify if/how automatic upgrades differ for Linux nodes.
- Ensure that references to image publishers, offers, and SKUs include both Windows and Linux options, and provide guidance for selecting Linux images.
- Where Windows-specific properties are required (e.g., windowsConfiguration), clarify their Linux equivalents or state when they are not applicable.
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
{
"name": "test1",
"type": "Microsoft.Batch/batchAccounts/pools",
"parameters": {
"properties": {
"vmSize": "Standard_d4s_v3",
"deploymentConfiguration": {
"virtualMachineConfiguration": {
"imageReference": {
"publisher": "MicrosoftWindowsServer",
"offer": "WindowsServer",
"sku": "2019-datacenter-smalldisk",
"version": "latest"
},
"nodePlacementConfiguration": {
"policy": "Zonal"
},
"nodeAgentSKUId": "batch.node.windows amd64",
"windowsConfiguration": {
"enableAutomaticUpdates": false
}
}
},
"scaleSettings": {
"fixedScale": {
"targetDedicatedNodes": 2,
"targetLowPriorityNodes": 0
}
},
"upgradePolicy": {
"mode": "Automatic",
"automaticOSUpgradePolicy": {
"disableAutomaticRollback": true,
"enableAutomaticOSUpgrade": true,
"useRollingUpgradePolicy": true,
"osRollingUpgradeDeferral": true
},
"rollingUpgradePolicy": {
"enableCrossZoneUpgrade": true,
"maxBatchInstancePercent": 20,
"maxUnhealthyInstancePercent": 20,
"maxUnhealthyUpgradedInstancePercent": 20,
"pauseTimeBetweenBatches": "PT0S",
"prioritizeUnhealthyInstances": false,
"rollbackFailedInstancesOnPolicyBreach": false
}
}
}
}
}