Basic Load balancer deprecation: Guidelines for Azure HDInsight
This article describes the details about the impact on HDInsight clusters and the necessary steps required as HDInsight service is transitioning to use standard load balancers for all its cluster configurations.
This transition is done in line with the announcement of retirement of Azure basic load balancer by 30 September 2025 and no support for new deployment by Mar 31, 2025. For more information, see Azure Basic Load Balancer retires on 30 September 2025. Upgrade to Standard Load Balancer.
Impact on HDInsight clusters
Long running clusters (when you don’t create and delete cluster frequently for your use case)
Scenario 1: Existing HDInsight clusters without custom virtual network (No virtual network used during cluster creation).
- No immediate disruption until Mar 31, 2025. However, we strongly recommend re-creating the cluster before Mar 31, 2025 to avoid potential disruption.
Scenario 2: Existing HDInsight clusters with custom virtual network (Used your own VNet for cluster creation).
- No immediate disruption until Mar 31, 2025. However, we strongly recommend re-creating the cluster before Mar 31, 2025 to avoid potential disruption.
New cluster creation
Scenario 1: HDInsight clusters without custom virtual network (Creating cluster without any virtual network).
- In this case, no impact. You can recreate the cluster directly.
Scenario 2: HDInsight clusters with custom virtual network (Using your own VNet during cluster creation).
In this case, there are two options to create a cluster
Approach 1: Create the cluster with a new subnet
Choose the outbound connectivity for your cluster
Follow this document Use Source Network Address Translation (SNAT) for outbound connections, and choose one method to provide outbound connectivity for the new cluster. The most recommended way is to attach a NAT gateway and a Network Security Group (NSG) to the subnet.
Create a new NAT gateway and a new Network Security Group(NSG) or use the existing ones.
Note
You can use an existing NAT gateway and NSG.
Follow the docs Quickstart: Create a NAT gateway - Azure portal, and Create, change, or delete an Azure network security group to create a new NAT gateway and a new network security group. You can refer to this document Control network traffic in Azure HDInsight to set up correct NSG rules.
Create a new subnet and associate the subnet with the NAT gateway and network security group.
Note
If you are unable to find the NAT gateway, see, FAQ of the NAT gateway Azure NAT Gateway frequently asked questions.
Create a new cluster with the subnet.
Approach 2: Create the cluster using the existing subnet
Your existing virtual network may be incompatible with Azure Standard Load Balancer, to upgrade your existing custom virtual network to integrate with Azure standard load balancer (which HDInsight clusters use by default now), see, Use Source Network Address Translation (SNAT) for outbound connections to provide outbound connectivity for the cluster.
The most recommended way is to attach a network security group and a NAT gateway to the subnet. Since the existing subnet which has HDInsight clusters with Azure basic load balancers can't be associated with an NAT gateway due to incompatibility with basic load balancer, there are two scenarios:
Case 1: Existing subnet has no HDInsight clusters with Azure Basic Load Balancers
Follow these steps:
Create a new NAT gateway and a new Network Security Group(NSG) or use the existing ones.
Note
You could use an existing NAT gateway and NSG.
Follow this document Quickstart: Create a NAT gateway - Azure portal, and Create, change, or delete an Azure network security group to create a new NAT gateway and a new network security group.
You can refer to this document Control network traffic in Azure HDInsight to set up correct NSG rules.
Associate the NAT gateway with your subnet along with a network security group.
Create the cluster with the subnet.
Note
If you are unable to find the NAT gateway, see, FAQ of the NAT gateway (Azure NAT Gateway frequently asked questions).
Case 2: Existing subnet has HDInsight clusters with Azure Basic load balancers
Consider one of these methods:
Method 1: The most recommended way is to associate a NAT gateway to the subnet along with network security group.
According to Azure NAT Gateway frequently asked questions, NAT gateway is incompatible with Azure basic load balancer.
To associate with a NAT Gateway, perform the following steps.
Delete all the existing HDInsight clusters with Azure basic load balancers in this subnet.
Create a new NAT gateway and a new Network Security Group(NSG) or use the existing ones.
Note
You could use an existing NAT gateway and NSG.
Follow this document Quickstart: Create a NAT gateway - Azure portal, and Create, change, or delete an Azure network security group to create a new NAT gateway and a new network security group.
You can refer to this document Control network traffic in Azure HDInsight to set up correct NSG rules.
Associate the subnet with the NAT gateway and network security group.
Note
If you are unable to find the NAT gateway, see, FAQ of the NAT gateway (Azure NAT Gateway frequently asked questions.
Re-create the clusters with the subnet.
Method 2: Select option other than Associate a NAT gateway to the subnet provided in Use Source Network Address Translation (SNAT) for outbound connections, and follow the instruction for the selected option.
Method 3: Create a new subnet and then create the cluster with the new subnet.
Note
If you are using an ESP cluster with MFA disabled, ensure to check the MFA status once cluster is recreated using a NAT gateway.