From 5d9b3ca24b073ee1da6f3c6e3d777198a11617be Mon Sep 17 00:00:00 2001 From: Matthew Long <61910737+thatmattlong@users.noreply.github.com> Date: Fri, 28 Oct 2022 15:01:59 -0700 Subject: [PATCH 1/3] docs: add cilium and overlay docs --- README.md | 2 ++ docs/README.md | 2 ++ docs/cilium.md | 7 +++++++ docs/overlay-for-aks.md | 6 ++++++ 4 files changed, 17 insertions(+) create mode 100644 docs/cilium.md create mode 100644 docs/overlay-for-aks.md diff --git a/README.md b/README.md index 31954481d4..4cc814b4a7 100644 --- a/README.md +++ b/README.md @@ -23,6 +23,8 @@ The following environments are supported: Plugins are offered as part of [Azure Kubernetes Service (AKS)](https://docs.microsoft.com/en-us/azure/aks/), as well as for individual Azure IaaS VMs. For Kubernetes clusters created by [aks-engine](https://github.com/Azure/aks-engine), the deployment and configuration of both plugins on both Linux and Windows nodes is automatic and default. +The next generation of Azure CNI Plugin is powered by [Cilium](https://cilium.io/). Learn more at [Azure CNI Powered By Cilium](docs/cilium.md) + ## Documentation See [Documentation](docs/) for more information and examples. diff --git a/docs/README.md b/docs/README.md index 3aced3c3d2..1cb377b490 100644 --- a/docs/README.md +++ b/docs/README.md @@ -2,6 +2,8 @@ ## Table of Contents * [CNI plugin](cni.md) - describes how to setup Azure CNI plugins. +* [Azure CNI Powered By Cilium](cilium.md) - describes the next generation of Azure CNI Plugin powered by Cilium dataplane. +* [Azure CNI Overlay Mode for AKS](overlay-for-aks.md) - describes a mode of the Azure CNI Plugin to provide a Pod network from an overlay address space with no encapsulation. * [CNM (libnetwork) plugin](cnm.md) - describes how to setup Azure CNM plugins. * [ACS](acs.md) - describes how to use the plugins with Azure Container Service. * [Network](network.md) - describes container networks created by plugins. diff --git a/docs/cilium.md b/docs/cilium.md new file mode 100644 index 0000000000..14b233ff7e --- /dev/null +++ b/docs/cilium.md @@ -0,0 +1,7 @@ +# Azure CNI Powered By Cilium + +Azure CNI powered by [Cilium](https://cilium.io/) provides native support for the next generation Cilium eBPF dataplane in AKS clusters running Azure CNI. It offers Pod networking, basic [Kubernetes Network Policies](https://kubernetes.io/docs/concepts/services-networking/network-policies/), and high-performance service load balancing. The eBPF dataplane is available in both [VNet mode](https://learn.microsoft.com/en-us/azure/aks/configure-azure-cni#dynamic-allocation-of-ips-and-enhanced-subnet-support) and [Overlay mode](https://learn.microsoft.com/en-us/azure/aks/azure-cni-overlay) of Azure CNI. + +## Learn More +[Blog Post: Azure CNI Powered by Cilium for Azure Kubernetes Service (AKS)](https://techcommunity.microsoft.com/t5/azure-networking-blog/azure-cni-powered-by-cilium-for-azure-kubernetes-service-aks/ba-p/3662341) + diff --git a/docs/overlay-for-aks.md b/docs/overlay-for-aks.md new file mode 100644 index 0000000000..1d89756183 --- /dev/null +++ b/docs/overlay-for-aks.md @@ -0,0 +1,6 @@ +# Azure CNI Overlay Mode for AKS + +Azure CNI Overlay mode is a new CNI network plugin that allocates pod IPs from an overlay network space, rather than from the virtual network IP space. This greatly reduces the IP utilization of Azure CNI as compared to the default mode. This CNI plugin functions like “kubenet” mode, but does not utilize route tables and thus is simpler to set up and much more scalable. + +## Learn More +[Azure Documentation: ](https://aka.ms/aks/azure-cni-overlay) \ No newline at end of file From 6cd680bf0c008e5468969b6684af0d7cb1c4816d Mon Sep 17 00:00:00 2001 From: Matthew Long <61910737+thatmattlong@users.noreply.github.com> Date: Fri, 28 Oct 2022 15:04:51 -0700 Subject: [PATCH 2/3] docs: fix missing link title --- docs/overlay-for-aks.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/overlay-for-aks.md b/docs/overlay-for-aks.md index 1d89756183..f76a05bb8d 100644 --- a/docs/overlay-for-aks.md +++ b/docs/overlay-for-aks.md @@ -3,4 +3,4 @@ Azure CNI Overlay mode is a new CNI network plugin that allocates pod IPs from an overlay network space, rather than from the virtual network IP space. This greatly reduces the IP utilization of Azure CNI as compared to the default mode. This CNI plugin functions like “kubenet” mode, but does not utilize route tables and thus is simpler to set up and much more scalable. ## Learn More -[Azure Documentation: ](https://aka.ms/aks/azure-cni-overlay) \ No newline at end of file +[Azure Documentation: Configure Azure CNI Overlay networking in Azure Kubernetes Service (AKS)](https://aka.ms/aks/azure-cni-overlay) \ No newline at end of file From 0544b75f60421e65db7e9de604fe73790687e4b7 Mon Sep 17 00:00:00 2001 From: Matthew Long <61910737+thatmattlong@users.noreply.github.com> Date: Fri, 28 Oct 2022 15:21:31 -0700 Subject: [PATCH 3/3] docs: update wording on cilium --- docs/cilium.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/cilium.md b/docs/cilium.md index 14b233ff7e..ac00ae5500 100644 --- a/docs/cilium.md +++ b/docs/cilium.md @@ -1,6 +1,6 @@ # Azure CNI Powered By Cilium -Azure CNI powered by [Cilium](https://cilium.io/) provides native support for the next generation Cilium eBPF dataplane in AKS clusters running Azure CNI. It offers Pod networking, basic [Kubernetes Network Policies](https://kubernetes.io/docs/concepts/services-networking/network-policies/), and high-performance service load balancing. The eBPF dataplane is available in both [VNet mode](https://learn.microsoft.com/en-us/azure/aks/configure-azure-cni#dynamic-allocation-of-ips-and-enhanced-subnet-support) and [Overlay mode](https://learn.microsoft.com/en-us/azure/aks/azure-cni-overlay) of Azure CNI. +Azure CNI powered by [Cilium](https://cilium.io/) provides native support for the next generation Cilium eBPF dataplane in AKS clusters running Azure CNI. It offers Pod networking, highly scalable [Kubernetes Network Policies](https://kubernetes.io/docs/concepts/services-networking/network-policies/), and high performance service load balancing with eBPF. The eBPF dataplane is available in both [VNet mode](https://learn.microsoft.com/en-us/azure/aks/configure-azure-cni#dynamic-allocation-of-ips-and-enhanced-subnet-support) and [Overlay mode](https://learn.microsoft.com/en-us/azure/aks/azure-cni-overlay) of Azure CNI. ## Learn More [Blog Post: Azure CNI Powered by Cilium for Azure Kubernetes Service (AKS)](https://techcommunity.microsoft.com/t5/azure-networking-blog/azure-cni-powered-by-cilium-for-azure-kubernetes-service-aks/ba-p/3662341)