Skip to content

Commit 71d8ebe

Browse files
committed
Doc corrections
- Add GitHub notices link
1 parent f4ce89e commit 71d8ebe

File tree

3 files changed

+70
-36
lines changed

3 files changed

+70
-36
lines changed

articles/batch/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -105,6 +105,8 @@
105105
href: batch-compute-node-environment-variables.md
106106
- name: Feature retirements
107107
items:
108+
- name: Active change, retirement, and end of life notices
109+
href: https://github.com/Azure/Batch/labels/notice
108110
- name: Cloud Service Configuration Pools
109111
href: batch-pool-cloud-service-to-virtual-machine-configuration.md
110112
- name: Batch certificates

articles/batch/batch-custom-image-pools-to-azure-compute-gallery-migration-guide.md

Lines changed: 28 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,54 @@
11
---
22
title: Migrate Azure Batch Custom Image Pools to Azure Compute Gallery
33
description: Learn how to migrate Azure Batch custom image pools to Azure compute gallery and plan for feature end of support.
4-
author: harperche
5-
ms.author: harpercheng
64
ms.service: batch
75
ms.topic: how-to
8-
ms.date: 02/23/2023
6+
ms.date: 03/07/2023
97
---
108

11-
# Migrate Azure Batch custom image pools to Azure Compute Gallery
12-
13-
To improve reliability, scale, and align with modern Azure offerings, Azure Batch will retire custom image Batch pools specified from virtual hard disk (VHD) blobs in Azure Storage and Azure Managed Images on *March 31, 2024*. Learn how to migrate your Azure Batch custom image pools using Azure Compute Gallery.
9+
# Migrate Azure Batch custom image pools to Azure Compute Gallery
1410

11+
To improve reliability, scale, and align with modern Azure offerings, Azure Batch will retire custom image Batch pools specified
12+
from virtual hard disk (VHD) blobs in Azure Storage and Azure Managed Images on *March 31, 2026*. Learn how to migrate your Azure
13+
Batch custom image pools using Azure Compute Gallery.
1514

1615
## Feature end of support
1716

18-
When you create an Azure Batch pool using the Virtual Machine Configuration, you specify an image reference that provides the operating system for each compute node in the pool. You can create a pool of virtual machines either with a supported Azure Marketplace image or with a custom image. Custom images from VHD blobs and managed Images are either legacy offerings or non-scalable solutions for Azure Batch. To ensure reliable infrastructure provisioning at scale, all custom image sources other than Azure Compute Gallery will be retired on *March 31, 2024*.
17+
When you create an Azure Batch pool using the Virtual Machine Configuration, you specify an image reference that provides the
18+
operating system for each compute node in the pool. You can create a pool of virtual machines either with a supported Azure
19+
Marketplace image or with a custom image. Custom images from VHD blobs and managed Images are either legacy offerings or
20+
non-scalable solutions for Azure Batch. To ensure reliable infrastructure provisioning at scale, all custom image sources other
21+
than Azure Compute Gallery will be retired on *March 31, 2026*.
1922

2023
## Alternative: Use Azure Compute Gallery references for Batch custom image pools
2124

22-
When you use the Azure Compute Gallery (formerly known as Shared Image Gallery) for your custom image, you have control over the operating system type and configuration, as well as the type of data disks. Your shared image can include applications and reference data that become available on all the Batch pool nodes as soon as they're provisioned. You can also have multiple versions of an image as needed for your environment. When you use an image version to create a VM, the image version is used to create new disks for the VM.
25+
When you use the Azure Compute Gallery (formerly known as Shared Image Gallery) for your custom image, you have control over
26+
the operating system type and configuration, and the type of data disks. Your shared image can include applications and reference
27+
data that become available on all the Batch pool nodes as soon as they're provisioned. You can also have multiple versions of an
28+
image as needed for your environment. When you use an image version to create a VM, the image version is used to create new
29+
disks for the VM.
2330

24-
Using a shared image saves time in preparing your pool's compute nodes to run your Batch workload. It's possible to use an Azure Marketplace image and install software on each compute node after provisioning, but using a shared image can lead to more efficiencies, in faster compute node to ready state and reproducible workloads. Additionally, you can specify multiple replicas for the shared image so when you create pools with many compute nodes, provisioning latencies can be lower.
31+
Using a shared image saves time in preparing your pool's compute nodes to run your Batch workload. It's possible to use an
32+
Azure Marketplace image and install software on each compute node after allocation. However, using a shared image can lead
33+
to more efficiencies in faster compute node to ready state and reproducible workloads. Additionally, you can specify multiple
34+
replicas for the shared image so when you create pools with many compute nodes, provisioning latencies can be lower.
2535

2636
## Migrate Your Eligible Pools
2737

28-
To migrate your Batch custom image pools from managed image to shared image, review the Azure Batch guide on using [Azure Compute Gallery to create a custom image pool](batch-sig-images.md).
38+
To migrate your Batch custom image pools from managed image to shared image, review the Azure Batch guide on using
39+
[Azure Compute Gallery to create a custom image pool](batch-sig-images.md).
2940

30-
If you have either a VHD blob or a managed image, you can convert them directly to a Compute Gallery image that can be used with Azure Batch custom image pools. When you're creating a VM image definition for a Compute Gallery, on the Version tab, there is an option to select the source for image types to migrate that're being retired for Batch custom image pools:
41+
If you have either a VHD blob or a managed image, you can convert them directly to a Compute Gallery image that can be used
42+
with Azure Batch custom image pools. When you're creating a VM image definition for a Compute Gallery, on the Version tab,
43+
you can select a source option to migrate from, including types being retired for Batch custom image pools:
3144

3245
| Source | Other fields |
3346
|---|---|
3447
| Managed image | Select the **Source image** from the drop-down. The managed image must be in the same region that you chose in **Instance details.** |
3548
| VHD in a storage account | Select **Browse** to choose the storage account for the VHD. |
3649

37-
For more information about this process, see [creating an image definition and version for Compute Gallery](../virtual-machines/image-version.md#create-an-image).
50+
For more information about this process, see
51+
[creating an image definition and version for Compute Gallery](../virtual-machines/image-version.md#create-an-image).
3852

3953
## FAQs
4054

@@ -48,12 +62,11 @@ For more information about this process, see [creating an image definition and v
4862

4963
- What considerations are there for Compute Gallery image based Pools?
5064

51-
See the [guide](batch-sig-images.md#considerations-for-large-pools) for more information.
65+
See the [considerations for large pools](batch-sig-images.md#considerations-for-large-pools).
5266

5367
- Can I use Azure Compute Gallery images in different subscriptions or in different Azure AD tenants?
54-
55-
If the Shared Image is not in the same subscription as the Batch account, you must register the Microsoft.Batch resource provider for that subscription. The two subscriptions must be in the same Azure AD tenant. The image can be in a different region as long as it has replicas in the same region as your Batch account.
5668

69+
If the Shared Image isn't in the same subscription as the Batch account, you must register the `Microsoft.Batch` resource provider for that subscription. The two subscriptions must be in the same Azure AD tenant. The image can be in a different region as long as it has replicas in the same region as your Batch account.
5770

5871
## Next steps
5972

articles/batch/batch-pools-to-simplified-compute-node-communication-model-migration-guide.md

Lines changed: 40 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,60 +1,79 @@
11
---
22
title: Migrate Azure Batch pools to the Simplified compute node communication model
33
description: Learn how to migrate Azure Batch pools to the simplified compute node communication model and plan for feature end of support.
4-
author: harperche
5-
ms.author: harpercheng
64
ms.service: batch
75
ms.topic: how-to
8-
ms.date: 02/23/2023
6+
ms.date: 03/07/2023
97
---
108

11-
# Migrate Azure Batch pools to the Simplified compute node communication model
12-
13-
To improve security, simplify the user experience, and enable key future improvements, Azure Batch will retire the classic compute node communication model on *March 31, 2026*. Learn how to migrate your Batch pools to using the simplified compute node communication model.
9+
# Migrate Azure Batch pools to the Simplified compute node communication model
1410

11+
To improve security, simplify the user experience, and enable key future improvements, Azure Batch will retire the classic
12+
compute node communication model on *March 31, 2026*. Learn how to migrate your Batch pools to using the simplified compute
13+
node communication model.
1514

1615
## About the feature
1716

18-
An Azure Batch pool contains one or more compute nodes, which execute user-specified workloads in the form of Batch tasks. To enable Batch functionality and Batch pool infrastructure management, compute nodes must communicate with the Azure Batch service. In the Classic compute node communication model, the Batch service initiates communication to the compute nodes and compute nodes must be able to communicate with Azure Storage for baseline operations. In the Simplified compute node communication model, Batch pools only require outbound access to the Batch service for baseline operations.
17+
An Azure Batch pool contains one or more compute nodes, which execute user-specified workloads in the form of Batch tasks.
18+
To enable Batch functionality and Batch pool infrastructure management, compute nodes must communicate with the Azure Batch
19+
service. In the classic compute node communication model, the Batch service initiates communication to the compute nodes and
20+
compute nodes must be able to communicate with Azure Storage for baseline operations. In the Simplified compute node
21+
communication model, Batch pools only require outbound access to the Batch service for baseline operations.
1922

2023
## Feature end of support
2124

22-
The simplified compute node communication model will replace the classic compute node communication model after *March 31, 2026*. The change is introduced in two phases. From now until *September 30, 2024*, the default node communication mode for newly created [Batch pools with virtual networks](./batch-virtual-network.md) will remain as classic. After *September 30, 2024*, the default node communication mode for newly created Batch pools with virtual networks will switch to the simplified. After *March 31, 2026*, the option to use classic compute node communication mode will no longer be honored. Batch pools without user-specified virtual networks are unaffected by this change and the default communication mode is controlled by the Batch service.
25+
The simplified compute node communication model will replace the classic compute node communication model after *March 31, 2026*.
26+
The change is introduced in two phases:
27+
28+
- From now until *September 30, 2024*, the default node communication mode for newly created
29+
[Batch pools with virtual networks](./batch-virtual-network.md) will remain as classic.
30+
- After *September 30, 2024*, the default node communication mode for newly created Batch pools with virtual networks will
31+
switch to the simplified.
32+
33+
After *March 31, 2026*, the option to use classic compute node communication mode will no longer be honored. Batch pools
34+
without user-specified virtual networks are generally unaffected by this change and the Batch service controls the default
35+
communication mode.
2336

2437
## Alternative: Use Simplified Compute Node Communication Model
2538

26-
The simplified compute node communication mode streamlines the way Batch pool infrastructure is managed on behalf of users. This communication mode reduces the complexity and scope of inbound and outbound networking connections required in the baseline operations.
39+
The simplified compute node communication mode streamlines the way Batch pool infrastructure is managed on behalf of users.
40+
This communication mode reduces the complexity and scope of inbound and outbound networking connections required in the
41+
baseline operations.
2742

28-
The simplified model also provides more fine-grained data exfiltration control, since outbound communication to *Storage.region* is no longer required. You can explicitly lock down outbound communication to Azure Storage if necessary for your workflow (such as AppPackage storage accounts, other storage accounts for resource files or output files, or other similar scenarios).
43+
The simplified model also provides more fine-grained data exfiltration control, since outbound communication to
44+
*Storage.region* is no longer required. You can explicitly lock down outbound communication to Azure Storage if necessary for
45+
your workflow. For example, autostorage accounts for AppPackages and other storage accounts for resource files or output files
46+
can be scoped appropriately.
2947

3048
## Migrate Your Eligible Pools
3149

32-
To migrate your Batch pools from classic to the simplified compute node communication model, please follow this document from the section entitled [potential impact between classic and simplified communication modes](simplified-compute-node-communication.md#potential-impact-between-classic-and-simplified-communication-modes) to either create new pools or update existing pools with simplified compute node communication.
50+
To migrate your Batch pools from classic to the simplified compute node communication model, follow this document
51+
from the section entitled
52+
[potential impact between classic and simplified communication modes](simplified-compute-node-communication.md#potential-impact-between-classic-and-simplified-communication-modes).
53+
You can either create new pools or update existing pools with simplified compute node communication.
3354

3455
## FAQs
3556

36-
- Will I still require a public IP address for my nodes?
57+
- Are public IP addresses still required for my pools?
3758

38-
The public IP address is still needed to initiate the outbound connection to Azure Batch. If you want to eliminate the need for public IP addresses entirely, see the guide to [create a simplified node communication pool without public IP addresses](./simplified-node-communication-pool-no-public-ip.md)
59+
By default, a public IP address is still needed to initiate the outbound connection to the Azure Batch service from compute nodes. If you want to eliminate the need for public IP addresses from compute nodes entirely, see the guide to [create a simplified node communication pool without public IP addresses](./simplified-node-communication-pool-no-public-ip.md)
3960

4061
- How can I connect to my nodes for diagnostic purposes?
4162

42-
RDP or SSH connectivity to the node is unaffected – load balancer(s) will still be created which can route those requests through to the node when provisioned with a public IP address.
63+
RDP or SSH connectivity to the node is unaffected – load balancer(s) are still created which can route those requests through to the node when provisioned with a public IP address.
4364

44-
- What differences will I see in billing?
65+
- Are there any differences in billing?
4566

4667
There should be no cost or billing implications for the new model.
4768

48-
- Are there any changes to agents on the compute node?
49-
50-
An extra agent will be running on compute nodes for both Windows and Linux, azbatch-cluster-agent.
69+
- Are there any changes to Azure Batch agents on the compute node?
5170

52-
- Will there be any change to how my linked resources from Azure Storage in Batch pools and tasks are downloaded?
71+
An extra agent on compute nodes is invoked in simplified compute node communication mode for both Linux and Windows, `Microsoft.BatchClusters.Agent` and `Microsoft.BatchClusters.Agent.exe`, respectively.
5372

54-
This behavior is unaffected – all user-specified resources that require Azure Storage such as resource files, output files, or application packages will still be made from the compute node directly to Azure Storage. You'll need to ensure your networking configuration allows these flows.
73+
- Are there any changes to how my linked resources from Azure Storage in Batch pools and tasks are downloaded?
5574

75+
This behavior is unaffected – all user-specified resources that require Azure Storage such as resource files, output files, or application packages are made from the compute node directly to Azure Storage. You need to ensure your networking configuration allows these flows.
5676

5777
## Next steps
5878

5979
For more information, see [Simplified compute node communication](./simplified-compute-node-communication.md).
60-

0 commit comments

Comments
 (0)