|
2 | 2 | title: Concepts - IP address planning in Azure Kubernetes Service (AKS)
|
3 | 3 | description: Learn about IP address planning in Azure Kubernetes Service (AKS).
|
4 | 4 | ms.topic: conceptual
|
5 |
| -ms.date: 05/21/2024 |
| 5 | +ms.date: 05/28/2024 |
6 | 6 | author: schaffererin
|
7 | 7 | ms.author: schaffererin
|
8 | 8 |
|
@@ -43,24 +43,13 @@ If you're using [Azure CNI Pod Subnet][azure-cni-podsubnet] and you expect your
|
43 | 43 |
|
44 | 44 | The IP address plan for an AKS cluster consists of a virtual network, at least one subnet for nodes and pods, and a Kubernetes service address range.
|
45 | 45 |
|
46 |
| -** TODO: Update Table to reflect all CNI's** |
47 |
| - |
48 | 46 | | Azure Resource | Address Range | Limits and Sizing |
|
49 | 47 | | -------------- | -------------- | ----------------- |
|
50 | 48 | | Azure Virtual Network | Max size /8. 65,536 configured IP address limit. See [Azure CNI Pod Subnet Static Block Allocation][podsubnet-static-block-allocation] for exception| Overlapping address spaces within your network can cause issues. |
|
51 | 49 | | Subnet | Must be large enough to accommodate nodes, pods, and all Kubernetes and Azure resources in your cluster. For instance, if you deploy an internal Azure Load Balancer, its front-end IPs are allocated from the cluster subnet, not public IPs. | Subnet size should also account for upgrade operations and future scaling needs. <p/> Use the following equation to calculate the minimum subnet size, including an extra node for upgrade operations: `(number of nodes + 1) + ((number of nodes + 1) * maximum pods per node that you configure)` <p/> Example for a 50-node cluster: `(51) + (51 * 30 (default)) = 1,581` (/21 or larger) <p/> Example for a 50-node cluster, preparing to scale up an extra 10 nodes: `(61) + (61 * 30 (default)) = 1,891` (/21 or larger) <p/> If you don't specify a maximum number of pods per node when you create your cluster, the maximum number of pods per node is set to 30. The minimum number of IP addresses required is based on that value. If you calculate your minimum IP address requirements on a different maximum value, see [Maximum pods per node](#maximum-pods-per-node) to set this value when you deploy your cluster. |
|
52 | 50 | | Kubernetes Service Address Range | Any network element on or connected to this virtual network must not use this range. | The service address CIDR must be smaller than /12. You can reuse this range across different AKS clusters. |
|
53 | 51 | | Kubernetes DNS Service IP Address | IP address within the Kubernetes service address range used by cluster service discovery. | Don't use the first IP address in your address range. The first address in your subnet range is used for the _kubernetes.default.svc.cluster.local_ address. |
|
54 | 52 |
|
55 |
| - |
56 |
| - |
57 |
| -| Address range | Azure resource | Limits and sizing | |
58 |
| -| ------------- | -------------- | ----------------- | |
59 |
| -| Virtual network | The Azure virtual network can be as large as /8, but is limited to 65,536 configured IP addresses. Consider all your networking needs, including communicating with services in other virtual networks, before configuring your address space. For example, if you configure too large of an address space, you might run into issues with overlapping other address spaces within your network.| |
60 |
| -| Subnet | Must be large enough to accommodate the nodes, pods, and all Kubernetes and Azure resources that might be provisioned in your cluster. For example, if you deploy an internal Azure Load Balancer, its front-end IPs are allocated from the cluster subnet, not public IPs. The subnet size should also take into account upgrade operations or future scaling needs.<p/> Use the following equation to calculate the _minimum_ subnet size including an extra node for upgrade operations: `(number of nodes + 1) + ((number of nodes + 1) * maximum pods per node that you configure)`<p/> Example for a 50 node cluster: `(51) + (51 * 30 (default)) = 1,581` (/21 or larger)<p/>Example for a 50 node cluster that also includes preparation to scale up an extra 10 nodes: `(61) + (61 * 30 (default)) = 1,891` (/21 or larger)<p>If you don't specify a maximum number of pods per node when you create your cluster, the maximum number of pods per node is set to _30_. The minimum number of IP addresses required is based on that value. If you calculate your minimum IP address requirements on a different maximum value, see [Maximum pods per node](#maximum-pods-per-node) to set this value when you deploy your cluster. | |
61 |
| -| Kubernetes service address range | Any network element on or connected to this virtual network must not use this range. Service address CIDR must be smaller than /12. You can reuse this range across different AKS clusters. | |
62 |
| -| Kubernetes DNS service IP address | IP address within the Kubernetes service address range that is used by cluster service discovery. Don't use the first IP address in your address range. The first address in your subnet range is used for the _kubernetes.default.svc.cluster.local_ address. | |
63 |
| - |
64 | 53 | ## Maximum pods per node
|
65 | 54 |
|
66 | 55 | The maximum number of pods per node in an AKS cluster is 250. The _default_ maximum number of pods per node varies between _kubenet_ and _Azure CNI_ networking, and the method of cluster deployment.
|
@@ -90,7 +79,7 @@ A minimum value for maximum pods per node is enforced to guarantee space for sys
|
90 | 79 |
|
91 | 80 | You can define maximum pods per node when you create a new cluster using one of the following methods:
|
92 | 81 |
|
93 |
| -* **Azure CLI**: Specify the `--max-pods` argument when you deploy a cluster with the [`az aks create`][az-aks-create] command. |
| 82 | +- **Azure CLI**: Specify the `--max-pods` argument when you deploy a cluster with the [`az aks create`][az-aks-create] command. |
94 | 83 | - **Azure Resource Manager template**: Specify the `maxPods` property in the [ManagedClusterAgentPoolProfile] object when you deploy a cluster with an Azure Resource Manager template.
|
95 | 84 | - **Azure portal**: Change the `Max pods per node` field in the node pool settings when creating a cluster or adding a new node pool.
|
96 | 85 |
|
|
0 commit comments