Batch Custom Images - 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

windows_first

powershell_heavy

missing_linux_example

Summary

The documentation demonstrates a Windows bias by presenting Windows-specific details and examples before Linux equivalents, particularly in connection instructions (RDP for Windows is mentioned before SSH for Linux). There are no explicit Linux command-line examples (e.g., Bash or CLI), and the only code sample for SDK usage uses a Windows node agent SKU ('batch.node.windows amd64') without a Linux equivalent. Additionally, there are no PowerShell or Bash command examples for creating images or pools, and the REST API and CLI sections are OS-neutral but lack Linux-specific context.

Recommendations

Provide parallel Linux examples wherever Windows-specific instructions are given (e.g., show SSH before or alongside RDP).
Include Linux node agent SKU examples in the SDK code samples (e.g., 'batch.node.ubuntu 20.04').
Add Bash/CLI command examples for common tasks such as creating snapshots, images, and pools, not just REST API or .NET SDK.
When referencing documentation, link to both Linux and Windows guides equally and in parallel.
Ensure that all steps and considerations are clearly marked for both Windows and Linux users, especially where procedures differ.

Create Pull Request

Scan History

Date	Scan	Status	Result
2025-07-12 23:44	#41	cancelled	Biased
2025-07-12 00:58	#8	cancelled	Clean
2025-07-10 05:06	#7	processing	Clean

Flagged Code Snippets

private static VirtualMachineConfiguration CreateVirtualMachineConfiguration(ImageReference imageReference)
{
    return new VirtualMachineConfiguration(
        imageReference: imageReference,
        nodeAgentSkuId: "batch.node.windows amd64");
}

private static ImageReference CreateImageReference()
{
    return new ImageReference(
        virtualMachineImageId: "/subscriptions/{sub id}/resourceGroups/{resource group name}/providers/Microsoft.Compute/images/{image definition name}");
}

private static void CreateBatchPool(BatchClient batchClient, VirtualMachineConfiguration vmConfiguration)
{
    try
    {
        CloudPool pool = batchClient.PoolOperations.CreatePool(
            poolId: PoolId,
            targetDedicatedComputeNodes: PoolNodeCount,
            virtualMachineSize: PoolVMSize,
            virtualMachineConfiguration: vmConfiguration);

        pool.Commit();
    }