You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/batch/batch-apis-tools.md
+4-5Lines changed: 4 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: APIs and tools for developers
3
3
description: Learn about the APIs and tools available for developing solutions with the Azure Batch service.
4
4
ms.topic: conceptual
5
-
ms.date: 06/11/2021
5
+
ms.date: 03/20/2023
6
6
ms.custom: seodec18
7
7
---
8
8
@@ -47,19 +47,19 @@ Your applications and services can issue direct REST API calls or use one or mor
47
47
48
48
## Batch Management APIs
49
49
50
-
The Azure Resource Manager APIs for Batch provide programmatic access to Batch accounts. Using these APIs, you can programmatically manage Batch accounts, quotas, application packages, and other resources through the Microsoft.Batch provider.
50
+
The Azure Resource Manager APIs for Batch provide programmatic access to Batch accounts. Using these APIs, you can programmatically manage Batch accounts, quotas, application packages, and other resources through the Microsoft.Batch provider.
51
51
52
52
| API | API reference | Download | Tutorial | Code samples |
53
53
| --- | --- | --- | --- | --- |
54
54
|**Batch Management REST**|[Azure REST API - Docs](/rest/api/batchmanagement/)|- |- |[GitHub](https://github.com/Azure-Samples/batch-dotnet-manage-batch-accounts)|
55
55
|**Batch Management .NET**|[Azure SDK for .NET - Docs](/dotnet/api/overview/azure/batch/management/management-batch(deprecated))|[NuGet](https://www.nuget.org/packages/Microsoft.Azure.Management.Batch/)|[Tutorial](batch-management-dotnet.md)|[GitHub](https://github.com/Azure-Samples/azure-batch-samples/tree/master/CSharp)|
56
56
|**Batch Management Python**|[Azure SDK for Python - Docs](/samples/azure-samples/azure-samples-python-management/batch/)|[PyPI](https://pypi.org/project/azure-mgmt-batch/)|- |- |
57
-
|**Batch Management JavaScript**|[Azure SDK for JavaScript - Docs](/javascript/api/overview/azure/arm-batch-readme)|[npm](https://www.npmjs.com/package/@azure/arm-batch)|- |- |
57
+
|**Batch Management JavaScript**|[Azure SDK for JavaScript - Docs](/javascript/api/overview/azure/arm-batch-readme)|[npm](https://www.npmjs.com/package/@azure/arm-batch)|- |- |
58
58
|**Batch Management Java**|[Azure SDK for Java - Docs](/java/api/overview/azure/batch/management)|[Maven](https://search.maven.org/search?q=a:azure-batch)|- |- |
59
59
60
60
## Batch command-line tools
61
61
62
-
These command-line tools provide the same functionality as the Batch service and Batch Management APIs:
62
+
These command-line tools provide the same functionality as the Batch service and Batch Management APIs:
63
63
64
64
-[Batch PowerShell cmdlets](/powershell/module/az.batch/): The Azure Batch cmdlets in the [Azure PowerShell](/powershell/azure/) module enable you to manage Batch resources with PowerShell.
65
65
-[Azure CLI](/cli/azure): The Azure CLI is a cross-platform toolset that provides shell commands for interacting with many Azure services, including the Batch service and Batch Management service. For more information, see [Manage Batch resources with Azure CLI](batch-cli-get-started.md).
@@ -70,7 +70,6 @@ These additional tools may be helpful for building and debugging your Batch appl
70
70
71
71
-[Azure portal](https://portal.azure.com/): You can create, monitor, and delete Batch pools, jobs, and tasks in the Azure portal. You can view status information for these and other resources while you run your jobs, and even download files from the compute nodes in your pools. For example, you can download a failed task's `stderr.txt` while troubleshooting. You can also download Remote Desktop (RDP) files that you can use to log in to compute nodes.
72
72
-[Azure Batch Explorer](https://azure.github.io/BatchExplorer/): Batch Explorer is a free, rich-featured, standalone client tool to help create, debug, and monitor Azure Batch applications. Download an [installation package](https://azure.github.io/BatchExplorer/) for Mac, Linux, or Windows.
73
-
-[Azure Batch Shipyard](https://github.com/Azure/batch-shipyard): Batch Shipyard is a tool to help provision, execute, and monitor container-based batch processing and HPC workloads on Azure Batch.
74
73
-[Azure Storage Explorer](https://azure.microsoft.com/features/storage-explorer/): While not strictly an Azure Batch tool, the Storage Explorer can be helpful when developing and debugging your Batch solutions.
Copy file name to clipboardExpand all lines: articles/batch/batch-docker-container-workloads.md
+2-3Lines changed: 2 additions & 3 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: Container workloads
3
3
description: Learn how to run and scale apps from container images on Azure Batch. Create a pool of compute nodes that support running container tasks.
4
4
ms.topic: how-to
5
-
ms.date: 08/18/2021
5
+
ms.date: 03/20/2023
6
6
ms.devlang: csharp, python
7
7
ms.custom: "seodec18, devx-track-csharp"
8
8
---
@@ -182,7 +182,7 @@ ImageReference imageReference = new ImageReference(
- For easy deployment of container workloads on Azure Batch through [Shipyard recipes](https://github.com/Azure/batch-shipyard/tree/master/recipes), see the [Batch Shipyard](https://github.com/Azure/batch-shipyard) toolkit.
389
388
- For information on installing and using Docker CE on Linux, see the [Docker](https://docs.docker.com/engine/installation/) documentation.
390
389
- Learn how to [Use a managed custom image to create a pool of virtual machines](batch-custom-images.md).
391
390
- Learn more about the [Moby project](https://mobyproject.org/), a framework for creating container-based systems.
Copy file name to clipboardExpand all lines: articles/batch/batch-pool-compute-intensive-sizes.md
+12-17Lines changed: 12 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,21 +2,21 @@
2
2
title: Use compute-intensive Azure VMs with Batch
3
3
description: How to take advantage of HPC and GPU virtual machine sizes in Azure Batch pools. Learn about OS dependencies and see several scenario examples.
4
4
ms.topic: how-to
5
-
ms.date: 12/17/2018
5
+
ms.date: 03/20/2023
6
6
---
7
7
# Use RDMA or GPU instances in Batch pools
8
8
9
9
To run certain Batch jobs, you can take advantage of Azure VM sizes designed for large-scale computation. For example:
10
10
11
-
* To run multi-instance [MPI workloads](batch-mpi.md), choose H-series or other sizes that have a network interface for Remote Direct Memory Access (RDMA). These sizes connect to an InfiniBand network for inter-node communication, which can accelerate MPI applications.
11
+
* To run multi-instance [MPI workloads](batch-mpi.md), choose H-series or other sizes that have a network interface for Remote Direct Memory Access (RDMA). These sizes connect to an InfiniBand network for inter-node communication, which can accelerate MPI applications.
12
12
13
13
* For CUDA applications, choose N-series sizes that include NVIDIA Tesla graphics processing unit (GPU) cards.
14
14
15
15
This article provides guidance and examples to use some of Azure's specialized sizes in Batch pools. For specs and background, see:
16
16
17
-
* High performance compute VM sizes ([Linux](../virtual-machines/sizes-hpc.md), [Windows](../virtual-machines/sizes-hpc.md))
17
+
* High performance compute VM sizes ([Linux](../virtual-machines/sizes-hpc.md), [Windows](../virtual-machines/sizes-hpc.md))
18
18
19
-
* GPU-enabled VM sizes ([Linux](../virtual-machines/sizes-gpu.md), [Windows](../virtual-machines/sizes-gpu.md))
19
+
* GPU-enabled VM sizes ([Linux](../virtual-machines/sizes-gpu.md), [Windows](../virtual-machines/sizes-gpu.md))
20
20
21
21
> [!NOTE]
22
22
> Certain VM sizes might not be available in the regions where you create your Batch accounts. To check that a size is available, see [Products available by region](https://azure.microsoft.com/regions/services/) and [Choose a VM size for a Batch pool](batch-pool-vm-sizes.md).
@@ -30,7 +30,7 @@ The RDMA or GPU capabilities of compute-intensive sizes in Batch are supported o
30
30
| Size | Capability | Operating systems | Required software | Pool settings |
|[NC, NCv2, NCv3, NDv2 series](../virtual-machines/linux/n-series-driver-setup.md)| NVIDIA Tesla GPU (varies by series) | Ubuntu 16.04 LTS, or<br/>CentOS 7.3 or 7.4<br/>(Azure Marketplace) | NVIDIA CUDA or CUDA Toolkit drivers | N/A |
33
+
|[NC, NCv2, NCv3, NDv2 series](../virtual-machines/linux/n-series-driver-setup.md)| NVIDIA Tesla GPU (varies by series) | Ubuntu 16.04 LTS, or<br/>CentOS 7.3 or 7.4<br/>(Azure Marketplace) | NVIDIA CUDA or CUDA Toolkit drivers | N/A |
|[H16r, H16mr, A8, A9](../virtual-machines/sizes-hpc.md)<br/>[NC24r, NC24rs_v2, NC24rs_v3, ND24rs<sup>*</sup>](../virtual-machines/windows/n-series-driver-setup.md#rdma-network-connectivity)| RDMA | Windows Server 2016, 2012 R2, or<br/>2012 (Azure Marketplace) | Microsoft MPI 2012 R2 or later, or<br/> Intel MPI 5<br/><br/>Windows RDMA drivers | Enable inter-node communication, disable concurrent task execution |
43
-
|[NC, NCv2, NCv3, ND, NDv2 series](../virtual-machines/windows/n-series-driver-setup.md)| NVIDIA Tesla GPU (varies by series) | Windows Server 2016 or <br/>2012 R2 (Azure Marketplace) | NVIDIA CUDA or CUDA Toolkit drivers| N/A |
43
+
|[NC, NCv2, NCv3, ND, NDv2 series](../virtual-machines/windows/n-series-driver-setup.md)| NVIDIA Tesla GPU (varies by series) | Windows Server 2016 or <br/>2012 R2 (Azure Marketplace) | NVIDIA CUDA or CUDA Toolkit drivers| N/A |
44
44
|[NV, NVv2 series](../virtual-machines/windows/n-series-driver-setup.md)| NVIDIA Tesla M60 GPU | Windows Server 2016 or<br/>2012 R2 (Azure Marketplace) | NVIDIA GRID drivers | N/A |
45
45
46
46
<sup>*</sup>RDMA-capable N-series sizes also include NVIDIA Tesla GPUs
@@ -61,7 +61,7 @@ The RDMA or GPU capabilities of compute-intensive sizes in Batch are supported o
61
61
62
62
To configure a specialized VM size for your Batch pool, you have several options to install required software or drivers:
63
63
64
-
* For pools in the virtual machine configuration, choose a preconfigured [Azure Marketplace](https://azuremarketplace.microsoft.com/marketplace/) VM image that has drivers and software preinstalled. Examples:
64
+
* For pools in the virtual machine configuration, choose a preconfigured [Azure Marketplace](https://azuremarketplace.microsoft.com/marketplace/) VM image that has drivers and software preinstalled. Examples:
65
65
66
66
*[CentOS-based 7.4 HPC](https://azuremarketplace.microsoft.com/marketplace/apps/openlogic.centos-hpc?tab=Overview) - includes RDMA drivers and Intel MPI 5.1
67
67
@@ -73,17 +73,14 @@ To configure a specialized VM size for your Batch pool, you have several options
73
73
74
74
*[Ubuntu Server (with GPU and RDMA drivers) for Azure Batch container pools](https://azuremarketplace.microsoft.com/marketplace/apps/microsoft-azure-batch.ubuntu-server-container-rdma?tab=Overview)
75
75
76
-
* Create a [custom Windows or Linux VM image](batch-sig-images.md) on which you have installed drivers, software, or other settings required for the VM size.
76
+
* Create a [custom Windows or Linux VM image](batch-sig-images.md) on which you have installed drivers, software, or other settings required for the VM size.
77
77
78
78
* Create a Batch [application package](batch-application-packages.md) from a zipped driver or application installer, and configure Batch to deploy the package to pool nodes and install once when each node is created. For example, if the application package is an installer, create a [start task](jobs-and-tasks.md#start-task) command line to silently install the app on all pool nodes. Consider using an application package and a pool start task if your workload depends on a particular driver version.
79
79
80
-
> [!NOTE]
80
+
> [!NOTE]
81
81
> The start task must run with elevated (admin) permissions, and it must wait for success. Long-running tasks will increase the time to provision a Batch pool.
82
82
>
83
83
84
-
*[Batch Shipyard](https://github.com/Azure/batch-shipyard) automatically configures the GPU and RDMA drivers to work transparently with containerized workloads on Azure Batch. Batch Shipyard is entirely driven with configuration files. There are many sample recipe configurations available that enable GPU and RDMA workloads such as the [CNTK GPU Recipe](https://github.com/Azure/batch-shipyard/tree/master/recipes/CNTK-GPU-OpenMPI) which preconfigures GPU drivers on N-series VMs and loads Microsoft Cognitive Toolkit software as a Docker image.
85
-
86
-
87
84
## Example: NVIDIA GPU drivers on Windows NC VM pool
88
85
89
86
To run CUDA applications on a pool of Windows NC nodes, you need to install NVDIA GPU drivers. The following sample steps use an application package to install the NVIDIA GPU drivers. You might choose this option if your workload depends on a specific GPU driver version.
@@ -94,7 +91,7 @@ To run CUDA applications on a pool of Windows NC nodes, you need to install NVDI
94
91
1. Using the Batch APIs or Azure portal, create a pool in the virtual machine configuration with the desired number of nodes and scale. The following table shows sample settings to install the NVIDIA GPU drivers silently using a start task:
95
92
96
93
| Setting | Value |
97
-
| ---- | ----- |
94
+
| ---- | ----- |
98
95
|**Image Type**| Marketplace (Linux/Windows) |
99
96
|**Publisher**| MicrosoftWindowsServer |
100
97
|**Offer**| WindowsServer |
@@ -124,8 +121,8 @@ To run CUDA applications on a pool of Linux NC nodes, you need to install necess
124
121
125
122
To run Windows MPI applications on a pool of Azure H16r VM nodes, you need to configure the HpcVmDrivers extension and install [Microsoft MPI](/message-passing-interface/microsoft-mpi). Here are sample steps to deploy a custom Windows Server 2016 image with the necessary drivers and software:
126
123
127
-
1. Deploy an Azure H16r VM running Windows Server 2016. For example, create the VM in the US West region.
128
-
2. Add the HpcVmDrivers extension to the VM by [running an Azure PowerShell command](../virtual-machines/sizes-hpc.md) from a client computer that connects to your Azure subscription, or using Azure Cloud Shell.
124
+
1. Deploy an Azure H16r VM running Windows Server 2016. For example, create the VM in the US West region.
125
+
2. Add the HpcVmDrivers extension to the VM by [running an Azure PowerShell command](../virtual-machines/sizes-hpc.md) from a client computer that connects to your Azure subscription, or using Azure Cloud Shell.
129
126
1. Make a Remote Desktop connection to the VM.
130
127
1. Download the [setup package](https://www.microsoft.com/download/details.aspx?id=57467) (MSMpiSetup.exe) for the latest version of Microsoft MPI, and install Microsoft MPI.
131
128
1. Follow the steps to create an [Azure Compute Gallery image](batch-sig-images.md) for Batch.
@@ -159,5 +156,3 @@ Using the Batch APIs or Azure portal, create a pool using this image and with th
159
156
## Next steps
160
157
161
158
* To run MPI jobs on an Azure Batch pool, see the [Windows](batch-mpi.md) or [Linux](/archive/blogs/windowshpc/introducing-mpi-support-for-linux-on-azure-batch) examples.
162
-
163
-
* For examples of GPU workloads on Batch, see the [Batch Shipyard](https://github.com/Azure/batch-shipyard/) recipes.
Copy file name to clipboardExpand all lines: articles/batch/pool-file-shares.md
+1-2Lines changed: 1 addition & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
title: Azure file share for Azure Batch pools
3
3
description: How to mount an Azure Files share from compute nodes in a Linux or Windows pool in Azure Batch.
4
4
ms.topic: how-to
5
-
ms.date: 08/23/2021
5
+
ms.date: 03/20/2023
6
6
---
7
7
8
8
# Use an Azure file share with a Batch pool
@@ -30,4 +30,3 @@ For details on how to mount an Azure file share on a pool, see [Mount a virtual
30
30
## Next steps
31
31
32
32
- To learn about other options to read and write data in Batch, see [Persist job and task output](batch-task-output.md).
33
-
- Explore the [Batch Shipyard](https://github.com/Azure/batch-shipyard) toolkit, which includes [Shipyard recipes](https://github.com/Azure/batch-shipyard/tree/master/recipes) to deploy file systems for Batch container workloads.
0 commit comments