Skip to content

Commit 8523b39

Browse files
author
Will Daly
committed
Update Azure CNI Powered by Cilium to use --network-dataplane
In AKS API version 2023-02-02preview the ebpfDataplane field was replaced with networkDataplane as part of promoting Cilium dataplane to the stable API. Update the documentation to reflect the changes to the API and CLI from "ebpfDataplane" to "networkDataplane"
1 parent ce9dc40 commit 8523b39

File tree

1 file changed

+10
-4
lines changed

1 file changed

+10
-4
lines changed

articles/aks/azure-cni-powered-by-cilium.md

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -52,9 +52,12 @@ Azure CNI powered by Cilium currently has the following limitations:
5252
## Prerequisites
5353

5454
* Azure CLI version 2.41.0 or later. Run `az --version` to see the currently installed version. If you need to install or upgrade, see [Install Azure CLI][/cli/azure/install-azure-cli].
55-
* Azure CLI with aks-preview extension 0.5.109 or later.
55+
* Azure CLI with aks-preview extension 0.5.135 or later.
5656
* If using ARM templates or the REST API, the AKS API version must be 2022-09-02-preview or later.
5757

58+
> [!NOTE]
59+
> Previous AKS API versions (2022-09-02preview to 2023-01-02preview) used the field [`networkProfile.ebpfDataplane=cilium`](https://github.com/Azure/azure-rest-api-specs/blob/06dbe269f7d9c709cc225c92358b38c3c2b74d60/specification/containerservice/resource-manager/Microsoft.ContainerService/aks/preview/2022-09-02-preview/managedClusters.json#L6939-L6955). AKS API versions since 2023-02-02preview use the field [`networkProfile.networkDataplane=cilium`](https://github.com/Azure/azure-rest-api-specs/blob/06dbe269f7d9c709cc225c92358b38c3c2b74d60/specification/containerservice/resource-manager/Microsoft.ContainerService/aks/preview/2023-02-02-preview/managedClusters.json#L7152-L7173) to enable Azure CNI Powered by Cilium.
60+
5861
## Install the aks-preview Azure CLI extension
5962

6063
[!INCLUDE [preview features callout](includes/preview/preview-callout.md)]
@@ -109,17 +112,20 @@ az network vnet subnet create -g <resourceGroupName> --vnet-name <vnetName> --na
109112
az network vnet subnet create -g <resourceGroupName> --vnet-name <vnetName> --name podsubnet --address-prefixes <address prefix, example: 10.241.0.0/16> -o none
110113
```
111114

112-
Create the cluster using `--enable-cilium-dataplane`:
115+
Create the cluster using `--network-dataplane=cilium`:
113116

114117
```azurecli-interactive
115118
az aks create -n <clusterName> -g <resourceGroupName> -l <location> \
116119
--max-pods 250 \
117120
--network-plugin azure \
118121
--vnet-subnet-id /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/virtualNetworks/<vnetName>/subnets/nodesubnet \
119122
--pod-subnet-id /subscriptions/<subscriptionId>/resourceGroups/<resourceGroupName>/providers/Microsoft.Network/virtualNetworks/<vnetName>/subnets/podsubnet \
120-
--enable-cilium-dataplane
123+
--network-dataplane=cilium
121124
```
122125

126+
> [!NOTE]
127+
> The `--network-dataplane=cilium` flag replaces the deprecated `--enable-ebpf-dataplane` flag used in earlier versions of the aks-preview CLI extension.
128+
123129
### Option 2: Assign IP addresses from an overlay network
124130

125131
Run this commands to create a cluster with an overlay network and Cilium. Replace the values for `<clusterName>`, `<resourceGroupName>`, and `<location>`:
@@ -129,7 +135,7 @@ az aks create -n <clusterName> -g <resourceGroupName> -l <location> \
129135
--network-plugin azure \
130136
--network-plugin-mode overlay \
131137
--pod-cidr 192.168.0.0/16 \
132-
--enable-cilium-dataplane
138+
--network-dataplane=cilium
133139
```
134140

135141
## Frequently asked questions

0 commit comments

Comments
 (0)