Skip to content

Commit 9a4bf7f

Browse files
Merge pull request #273801 from chasewilson/chase/OBTUpdate
[aks] update outbound type migration capabilities
2 parents 15bd0f3 + 3f6a835 commit 9a4bf7f

File tree

1 file changed

+19
-22
lines changed

1 file changed

+19
-22
lines changed

articles/aks/egress-outboundtype.md

Lines changed: 19 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
---
22
title: Customize cluster egress with outbound types in Azure Kubernetes Service (AKS)
3-
description: Learn how to define a custom egress route in Azure Kubernetes Service (AKS)
3+
description: Learn how to define a custom egress route in Azure Kubernetes Service (AKS).
44
author: asudbring
55
ms.subservice: aks-networking
66
ms.custom:
77
ms.author: allensu
88
ms.topic: how-to
9-
ms.date: 02/06/2024
9+
ms.date: 04/29/2024
1010
#Customer intent: As a cluster operator, I want to define my own egress paths with user-defined routes. Since I define this up front I do not want AKS provided load balancer configurations.
1111
---
1212

1313
# Customize cluster egress with outbound types in Azure Kubernetes Service (AKS)
1414

15-
You can customize egress for an AKS cluster to fit specific scenarios. By default, AKS will provision a standard SKU load balancer to be set up and used for egress. However, the default setup may not meet the requirements of all scenarios if public IPs are disallowed or additional hops are required for egress.
15+
You can customize egress for an AKS cluster to fit specific scenarios. By default, AKS provisions a standard SKU load balancer to be set up and used for egress. However, the default setup may not meet the requirements of all scenarios if public IPs are disallowed or extra hops are required for egress.
1616

1717
This article covers the various types of outbound connectivity that are available in AKS clusters.
1818

@@ -21,7 +21,7 @@ This article covers the various types of outbound connectivity that are availabl
2121
2222
## Limitations
2323

24-
* Setting `outboundType` requires AKS clusters with a `vm-set-type` of `VirtualMachineScaleSets` and `load-balancer-sku` of `Standard`.
24+
- Setting `outboundType` requires AKS clusters with a `vm-set-type` of `VirtualMachineScaleSets` and `load-balancer-sku` of `Standard`.
2525

2626
## Outbound types in AKS
2727

@@ -36,9 +36,9 @@ The load balancer is used for egress through an AKS-assigned public IP. An outbo
3636

3737
If `loadBalancer` is set, AKS automatically completes the following configuration:
3838

39-
* A public IP address is provisioned for cluster egress.
40-
* The public IP address is assigned to the load balancer resource.
41-
* Backend pools for the load balancer are set up for agent nodes in the cluster.
39+
- A public IP address is provisioned for cluster egress.
40+
- The public IP address is assigned to the load balancer resource.
41+
- Backend pools for the load balancer are set up for agent nodes in the cluster.
4242

4343
![Diagram shows ingress I P and egress I P, where the ingress I P directs traffic to a load balancer, which directs traffic to and from an internal cluster and other traffic to the egress I P, which directs traffic to the Internet, M C R, Azure required services, and the A K S Control Plane.](media/egress-outboundtype/outboundtype-lb.png)
4444

@@ -48,8 +48,8 @@ For more information, see [using a standard load balancer in AKS](load-balancer-
4848

4949
If `managedNatGateway` or `userAssignedNatGateway` are selected for `outboundType`, AKS relies on [Azure Networking NAT gateway](../virtual-network/nat-gateway/manage-nat-gateway.md) for cluster egress.
5050

51-
* Select `managedNatGateway` when using managed virtual networks. AKS will provision a NAT gateway and attach it to the cluster subnet.
52-
* Select `userAssignedNatGateway` when using bring-your-own virtual networking. This option requires that you have provisioned a NAT gateway before cluster creation.
51+
- Select `managedNatGateway` when using managed virtual networks. AKS provisions a NAT gateway and attach it to the cluster subnet.
52+
- Select `userAssignedNatGateway` when using bring-your-own virtual networking. This option requires that you have provisioned a NAT gateway before cluster creation.
5353

5454
For more information, see [using NAT gateway with AKS](nat-gateway.md).
5555

@@ -72,10 +72,10 @@ The following tables show the supported migration paths between outbound types f
7272

7373
### Supported Migration Paths for Managed VNet
7474

75-
| Managed VNet |loadBalancer | managedNATGateway | userAssignedNATGateway | userDefinedRouting |
75+
| Managed VNet | loadBalancer | managedNATGateway | userAssignedNATGateway | userDefinedRouting |
7676
|------------------------|---------------|-------------------|------------------------|--------------------|
77-
| loadBalancer | N/A | Supported | Not Supported | Supported |
78-
| managedNATGateway | Supported | N/A | Not Supported | Supported |
77+
| loadBalancer | N/A | Supported | Not Supported | Not Supported |
78+
| managedNATGateway | Supported | N/A | Not Supported | Not Supported |
7979
| userAssignedNATGateway | Not Supported | Not Supported | N/A | Not Supported |
8080
| userDefinedRouting | Supported | Supported | Not Supported | N/A |
8181

@@ -131,24 +131,21 @@ az aks update -g <resourceGroup> -n <clusterName> --outbound-type userDefinedRou
131131

132132
### Update cluster from loadbalancer to userAssignedNATGateway in BYO vnet scenario
133133

134-
- Associate nat gateway with subnet where the workload is associated with. Please refer to [Create a managed or user-assigned NAT gateway](nat-gateway.md)
134+
- Associate nat gateway with subnet where the workload is associated with. Refer to [Create a managed or user-assigned NAT gateway](nat-gateway.md)
135135

136136
```azurecli-interactive
137137
az aks update -g <resourceGroup> -n <clusterName> --outbound-type userAssignedNATGateway
138138
```
139139

140140
## Next steps
141141

142-
* [Configure standard load balancing in an AKS cluster](load-balancer-standard.md)
143-
* [Configure NAT gateway in an AKS cluster](nat-gateway.md)
144-
* [Configure user-defined routing in an AKS cluster](egress-udr.md)
145-
* [NAT gateway documentation](./nat-gateway.md)
146-
* [Azure networking UDR overview](../virtual-network/virtual-networks-udr-overview.md)
147-
* [Manage route tables](../virtual-network/manage-route-table.yml)
142+
- [Configure standard load balancing in an AKS cluster](load-balancer-standard.md)
143+
- [Configure NAT gateway in an AKS cluster](nat-gateway.md)
144+
- [Configure user-defined routing in an AKS cluster](egress-udr.md)
145+
- [NAT gateway documentation](./nat-gateway.md)
146+
- [Azure networking UDR overview](../virtual-network/virtual-networks-udr-overview.md)
147+
- [Manage route tables](../virtual-network/manage-route-table.yml)
148148

149149
<!-- LINKS - internal -->
150-
[az-feature-register]: /cli/azure/feature#az_feature_register
151-
[az-feature-show]: /cli/azure/feature#az_feature_show
152-
[az-provider-register]: /cli/azure/provider#az_provider_register
153150
[az-aks-update]: /cli/azure/aks#az_aks_update
154151

0 commit comments

Comments
 (0)