Skip to content

Commit cfa27bd

Browse files
authored
Merge pull request #231415 from alfpark/batch-update4
Remove references to Batch Shipyard
2 parents e625129 + bf52b2d commit cfa27bd

File tree

5 files changed

+19
-29
lines changed

5 files changed

+19
-29
lines changed

articles/batch/TOC.yml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -363,8 +363,6 @@
363363
href: https://azure.github.io/BatchExplorer/
364364
- name: Batch feedback
365365
href: https://feedback.azure.com/d365community/forum/7462aa60-0c25-ec11-b6e6-000d3a4f07b8
366-
- name: Batch Shipyard
367-
href: https://github.com/Azure/batch-shipyard
368366
- name: Blog
369367
href: /archive/blogs/windowshpc/
370368
- name: HPC on Azure

articles/batch/batch-apis-tools.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: APIs and tools for developers
33
description: Learn about the APIs and tools available for developing solutions with the Azure Batch service.
44
ms.topic: conceptual
5-
ms.date: 06/11/2021
5+
ms.date: 03/20/2023
66
ms.custom: seodec18
77
---
88

@@ -47,19 +47,19 @@ Your applications and services can issue direct REST API calls or use one or mor
4747

4848
## Batch Management APIs
4949

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.
5151

5252
| API | API reference | Download | Tutorial | Code samples |
5353
| --- | --- | --- | --- | --- |
5454
| **Batch Management REST** |[Azure REST API - Docs](/rest/api/batchmanagement/) |- |- |[GitHub](https://github.com/Azure-Samples/batch-dotnet-manage-batch-accounts) |
5555
| **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) |
5656
| **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) |- |- |
5858
| **Batch Management Java** |[Azure SDK for Java - Docs](/java/api/overview/azure/batch/management) |[Maven](https://search.maven.org/search?q=a:azure-batch) |- |- |
5959

6060
## Batch command-line tools
6161

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:
6363

6464
- [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.
6565
- [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
7070

7171
- [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.
7272
- [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.
7473
- [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.
7574

7675
## Additional resources

articles/batch/batch-docker-container-workloads.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Container workloads
33
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.
44
ms.topic: how-to
5-
ms.date: 08/18/2021
5+
ms.date: 03/20/2023
66
ms.devlang: csharp, python
77
ms.custom: "seodec18, devx-track-csharp"
88
---
@@ -182,7 +182,7 @@ ImageReference imageReference = new ImageReference(
182182
ContainerRegistry containerRegistry = new ContainerRegistry(
183183
registryServer: "https://hub.docker.com",
184184
userName: "UserName",
185-
password: "YourPassword"
185+
password: "YourPassword"
186186
);
187187

188188
// Specify container configuration, prefetching Docker images
@@ -385,7 +385,6 @@ containerTask.ContainerSettings = cmdContainerSettings;
385385

386386
## Next steps
387387

388-
- 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.
389388
- For information on installing and using Docker CE on Linux, see the [Docker](https://docs.docker.com/engine/installation/) documentation.
390389
- Learn how to [Use a managed custom image to create a pool of virtual machines](batch-custom-images.md).
391390
- Learn more about the [Moby project](https://mobyproject.org/), a framework for creating container-based systems.

articles/batch/batch-pool-compute-intensive-sizes.md

Lines changed: 12 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -2,21 +2,21 @@
22
title: Use compute-intensive Azure VMs with Batch
33
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.
44
ms.topic: how-to
5-
ms.date: 12/17/2018
5+
ms.date: 03/20/2023
66
---
77
# Use RDMA or GPU instances in Batch pools
88

99
To run certain Batch jobs, you can take advantage of Azure VM sizes designed for large-scale computation. For example:
1010

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.
1212

1313
* For CUDA applications, choose N-series sizes that include NVIDIA Tesla graphics processing unit (GPU) cards.
1414

1515
This article provides guidance and examples to use some of Azure's specialized sizes in Batch pools. For specs and background, see:
1616

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))
1818

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))
2020

2121
> [!NOTE]
2222
> 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
3030
| Size | Capability | Operating systems | Required software | Pool settings |
3131
| -------- | -------- | ----- | -------- | ----- |
3232
| [H16r, H16mr, A8, A9](../virtual-machines/sizes-hpc.md)<br/>[NC24r, NC24rs_v2, NC24rs_v3, ND24rs<sup>*</sup>](../virtual-machines/linux/n-series-driver-setup.md#rdma-network-connectivity) | RDMA | Ubuntu 16.04 LTS, or<br/>CentOS-based HPC<br/>(Azure Marketplace) | Intel MPI 5<br/><br/>Linux RDMA drivers | Enable inter-node communication, disable concurrent task execution |
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 |
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 |
3434
| [NV, NVv2 series](../virtual-machines/linux/n-series-driver-setup.md) | NVIDIA Tesla M60 GPU | Ubuntu 16.04 LTS, or<br/>CentOS 7.3<br/>(Azure Marketplace) | NVIDIA GRID drivers | N/A |
3535

3636
<sup>*</sup>RDMA-capable N-series sizes also include NVIDIA Tesla GPUs
@@ -40,7 +40,7 @@ The RDMA or GPU capabilities of compute-intensive sizes in Batch are supported o
4040
| Size | Capability | Operating systems | Required software | Pool settings |
4141
| -------- | ------ | -------- | -------- | ----- |
4242
| [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 |
4444
| [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 |
4545

4646
<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
6161

6262
To configure a specialized VM size for your Batch pool, you have several options to install required software or drivers:
6363

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:
6565

6666
* [CentOS-based 7.4 HPC](https://azuremarketplace.microsoft.com/marketplace/apps/openlogic.centos-hpc?tab=Overview) - includes RDMA drivers and Intel MPI 5.1
6767

@@ -73,17 +73,14 @@ To configure a specialized VM size for your Batch pool, you have several options
7373

7474
* [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)
7575

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.
7777

7878
* 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.
7979

80-
> [!NOTE]
80+
> [!NOTE]
8181
> 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.
8282
>
8383
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-
8784
## Example: NVIDIA GPU drivers on Windows NC VM pool
8885

8986
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
9491
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:
9592

9693
| Setting | Value |
97-
| ---- | ----- |
94+
| ---- | ----- |
9895
| **Image Type** | Marketplace (Linux/Windows) |
9996
| **Publisher** | MicrosoftWindowsServer |
10097
| **Offer** | WindowsServer |
@@ -124,8 +121,8 @@ To run CUDA applications on a pool of Linux NC nodes, you need to install necess
124121

125122
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:
126123

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.
129126
1. Make a Remote Desktop connection to the VM.
130127
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.
131128
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
159156
## Next steps
160157

161158
* 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.

articles/batch/pool-file-shares.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Azure file share for Azure Batch pools
33
description: How to mount an Azure Files share from compute nodes in a Linux or Windows pool in Azure Batch.
44
ms.topic: how-to
5-
ms.date: 08/23/2021
5+
ms.date: 03/20/2023
66
---
77

88
# 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
3030
## Next steps
3131

3232
- 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

Comments
 (0)