Skip to content

Files

Latest commit

olsenmeolsenme
removing preview content from ccm doc
Apr 13, 2022
c9ee307 · Apr 13, 2022

History

History
98 lines (66 loc) · 4.37 KB

out-of-tree.md

File metadata and controls

98 lines (66 loc) · 4.37 KB
title description services ms.topic ms.date ms.author
Enable Cloud Controller Manager
Learn how to enable the Out of Tree cloud provider
container-service
article
04/08/2022
juda

Enable Cloud Controller Manager

As a Cloud Provider, Microsoft Azure works closely with the Kubernetes community to support our infrastructure on behalf of users.

Previously, Cloud provider integration with Kubernetes was "in-tree", where any changes to Cloud specific features would follow the standard Kubernetes release cycle. When issues were fixed or enhancements were rolled out, they would need to be within the Kubernetes community's release cycle.

The Kubernetes community is now adopting an "out-of-tree" model where the Cloud providers will control their releases independently of the core Kubernetes release schedule through the cloud-provider-azure component. As part of this cloud-provider-azure component, we are also introducing a cloud-node-manager component, which is a component of the Kubernetes node lifecycle controller. This component is deployed by a DaemonSet in the kube-system namespace. To view this component, use

kubectl get po -n kube-system | grep cloud-node-manager

We recently rolled out the Cloud Storage Interface (CSI) drivers to be the default in Kubernetes version 1.21 and above.

Note

When enabling Cloud Controller Manager on your AKS cluster, this will also enable the out of tree CSI drivers.

The Cloud Controller Manager is the default controller from Kubernetes 1.22, supported by AKS. If running < v1.22, follow instructions below.

Prerequisites

You must have the following resource installed:

  • The Azure CLI
  • Kubernetes version 1.20.x or above
  • The aks-preview extension version 0.5.5 or later

Register the EnableCloudControllerManager feature flag

To use the Cloud Controller Manager feature, you must enable the EnableCloudControllerManager feature flag on your subscription.

az feature register --name EnableCloudControllerManager --namespace Microsoft.ContainerService

You can check on the registration status by using the az feature list command:

az feature list -o table --query "[?contains(name, 'Microsoft.ContainerService/EnableCloudControllerManager')].{Name:name,State:properties.state}"

When ready, refresh the registration of the Microsoft.ContainerService resource provider by using the az provider register command:

az provider register --namespace Microsoft.ContainerService

Install the aks-preview CLI extension

# Install the aks-preview extension
az extension add --name aks-preview

# Update the extension to make sure you have the latest version installed
az extension update --name aks-preview

Create a new AKS cluster with Cloud Controller Manager with version <1.22

To create a cluster using the Cloud Controller Manager, pass EnableCloudControllerManager=True as a customer header to the Azure API using the Azure CLI.

az group create --name myResourceGroup --location eastus
az aks create -n aks -g myResourceGroup --aks-custom-headers EnableCloudControllerManager=True

Upgrade an AKS cluster to Cloud Controller Manager on an existing cluster with version <1.22

To upgrade a cluster to use the Cloud Controller Manager, pass EnableCloudControllerManager=True as a customer header to the Azure API using the Azure CLI.

az aks upgrade -n aks -g myResourceGroup -k <version> --aks-custom-headers EnableCloudControllerManager=True

Next steps

  • For more information on CSI drivers, and the default behavior for Kubernetes versions above 1.21, please see our documentation.

  • You can find more information about the Kubernetes community direction regarding Out of Tree providers on the community blog post.