Merge pull request #238062 from Padmalathas/Padmalathas-patch-3

Updates Custom Image Creation using Portal

Author: prmerger-automator[bot]

articles/batch/batch-sig-images.md

@@ -2,7 +2,7 @@
 title: Use the Azure Compute Gallery to create a custom image pool
 description: Custom image pools are an efficient way to configure compute nodes to run your Batch workloads.
 ms.topic: conceptual
-ms.date: 03/04/2021
+ms.date: 05/12/2023
 ms.devlang: csharp, python
 ms.custom: devx-track-python, devx-track-azurecli
 ---
@@ -60,7 +60,14 @@ The following steps show how to prepare a VM, take a snapshot, and create an ima
 
 ### Prepare a VM
 
-If you are creating a new VM for the image, use a first party Azure Marketplace image supported by Batch as the base image for your managed image. Only first party images can be used as a base image. To get a full list of Azure Marketplace image references supported by Azure Batch, see the [List node agent SKUs](/java/api/com.microsoft.azure.batch.protocol.accounts.listnodeagentskus) operation.
+If you are creating a new VM for the image, use a first party Azure Marketplace image supported by Batch as the base image for your managed image. Only first party images can be used as a base image. 
+
+To get a full list of current Azure Marketplace image references supported by Azure Batch, use one of the following APIs to return a list of Windows and Linux VM images including the node agent SKU IDs for each image:
+
+- PowerShell: [Azure Batch supported images](/powershell/module/az.batch/get-azbatchsupportedimage)
+- Azure CLI:  [Azure Batch pool supported images](/cli/azure/batch/pool/supported-images)
+- Batch service APIs: [Batch service APIs](batch-apis-tools.md#batch-service-apis) and [Azure Batch service supported images](/rest/api/batchservice/account/listsupportedimages)
+- List node agent SKUs: [Node agent SKUs](/java/api/com.microsoft.azure.batch.protocol.accounts.listnodeagentskus) 
 
 > [!NOTE]
 > You can't use a third-party image that has additional license and purchase terms as your base image. For information about these Marketplace images, see the guidance for [Linux](../virtual-machines/linux/cli-ps-findimage.md#check-the-purchase-plan-information) or [Windows](../virtual-machines/windows/cli-ps-findimage.md#view-purchase-plan-properties)VMs.
@@ -83,6 +90,11 @@ A snapshot is a full, read-only copy of a VHD. To create a snapshot of a VM's OS
 
 To create a managed image from a snapshot, use Azure command-line tools such as the [az image create](/cli/azure/image) command. Create an image by specifying an OS disk snapshot and optionally one or more data disk snapshots.
 
+To create an image from a VM in the portal, see [Capture an image of a VM](../virtual-machines/capture-image-portal.md).
+
+To create an image using a source other than a VM, see [Create an image](../virtual-machines/image-version.md).
+
+
 ### Create an Azure Compute Gallery
 
 Once you have successfully created your managed image, you need to create an Azure Compute Gallery to make your custom image available. To learn how to create an Azure Compute Gallery for your images, see [Create an Azure Compute Gallery](../virtual-machines/create-gallery.md).
@@ -94,12 +106,15 @@ To create a pool from your Shared Image using the Azure CLI, use the `az batch p
 > [!NOTE]
 > You need to authenticate using Azure AD. If you use shared-key-auth, you will get an authentication error.  
 
+> [!IMPORTANT]
+> The node agent SKU id must align with the publisher/offer/SKU in order for the node to start.
+
 ```azurecli
 az batch pool create \
     --id mypool --vm-size Standard_A1_v2 \
     --target-dedicated-nodes 2 \
     --image "/subscriptions/{sub id}/resourceGroups/{resource group name}/providers/Microsoft.Compute/galleries/{gallery name}/images/{image definition name}/versions/{version id}" \
-    --node-agent-sku-id "batch.node.ubuntu 16.04"
+    --{node-agent-sku-id}
 ```
 
 ## Create a pool from a Shared Image using C#
@@ -111,7 +126,7 @@ private static VirtualMachineConfiguration CreateVirtualMachineConfiguration(Ima
 {
     return new VirtualMachineConfiguration(
         imageReference: imageReference,
-        nodeAgentSkuId: "batch.node.windows amd64");
+        nodeAgentSkuId: {});
 }
 
 private static ImageReference CreateImageReference()
@@ -185,7 +200,7 @@ ir = batchmodels.ImageReference(
 # be installed on the node.
 vmc = batchmodels.VirtualMachineConfiguration(
     image_reference=ir,
-    node_agent_sku_id="batch.node.ubuntu 18.04"
+    {node_agent_sku_id}
 )
 
 # Create the unbound pool
@@ -201,7 +216,7 @@ new_pool = batchmodels.PoolAddParameter(
 client.pool.add(new_pool)
 ```
 
-## Create a pool from a Shared Image using the Azure portal
+## Create a pool from a Shared Image or Custom Image using the Azure portal
 
 Use the following steps to create a pool from a Shared Image in the Azure portal.
 
@@ -211,8 +226,10 @@ Use the following steps to create a pool from a Shared Image in the Azure portal
 1. In the **Image Type** section, select **Azure Compute Gallery**.
 1. Complete the remaining sections with information about your managed image.
 1. Select **OK**.
+1. Once the node is allocated, use **Connect** to generate user and the RDP file for Windows OR use SSH to for Linux to login to the allocated node and verify.
 
 ![Create a pool with from a Shared image with the portal.](media/batch-sig-images/create-custom-pool.png)
+  
 
 ## Considerations for large pools
 
@@ -225,4 +242,4 @@ If you plan to create a pool with hundreds or thousands of VMs or more using a S
 ## Next steps
 
 - For an in-depth overview of Batch, see [Batch service workflow and resources](batch-service-workflow-features.md).
-- Learn about the [Azure Compute Gallery](../virtual-machines/shared-image-galleries.md).
+- Learn about the [Azure Compute Gallery](../virtual-machines/shared-image-galleries.md).