Skip to main content
Welcome to this comprehensive guide on the Kube Controller Manager, a vital component in Kubernetes responsible for managing a variety of controllers within your cluster. Understanding its role and configuration is crucial for ensuring a resilient and well-orchestrated Kubernetes environment.

​
Overview

In Kubernetes, a controller acts like a department in an organization—each controller is tasked with handling a specific responsibility. For instance, one controller might monitor the health of nodes, while another ensures that the desired number of pods is always running. These controllers constantly observe system changes to drive the cluster toward its intended state. The Node Controller, for example, checks node statuses every five seconds through the Kube API Server. If a node stops sending heartbeats, it is not immediately marked as unreachable; instead, there is a grace period of 40 seconds followed by an additional five minutes for potential recovery before its pods are rescheduled onto a healthy node.

​
Example: Checking Node Statuses

In the case where a node fails to recover, the output might look like this:
Another essential controller is the Replication Controller, which ensures that the specified number of pods is maintained by creating new pods when needed. This mechanism reinforces the resilience and reliability of your Kubernetes cluster.
The image illustrates a Kubernetes architecture with master and worker nodes, showing components like ETCD cluster, controller-manager, and kube-scheduler, alongside container ships.
All core Kubernetes constructs—such as Deployments, Services, Namespaces, and Persistent Volumes—rely on these controllers. Essentially, controllers serve as the “brains” behind many operations in a Kubernetes cluster.

​
How Controllers Are Packaged

All individual controllers are bundled into a single process known as the Kubernetes Controller Manager. When you deploy the Controller Manager, every associated controller is started together. This unified deployment simplifies management and configuration.

​
Installing and Configuring the Kube Controller Manager

To install and view the Kube Controller Manager, follow these steps:
  1. Download the Kube Controller Manager from the Kubernetes release page.
  2. Extract the binary and run it as a service.
  3. Review the configurable options provided, which allow you to tailor its behavior.

​
Downloading the Controller Manager

​
Sample Service Configuration

Below is an example of a service file (kube-controller-manager.service) used to run the Controller Manager:
This configuration includes additional options for the Node Controller, such as node monitor period, grace period, and eviction timeout. Additionally, you can control which controllers are enabled through the --controllers flag.
By default, all controllers are enabled. You can selectively enable or disable controllers by using the syntax foo to enable and -foo to disable. For example, --controllers=*,-tokencleaner will disable the tokencleaner controller.

​
Example of Specifying Controllers

​
Viewing the Controller Manager in Action

Depending on your cluster setup, the Controller Manager may run as a pod in the kube-system namespace (if set up using kubeadm) or as a system service. In kubeadm-based clusters, you can inspect the pod definition located in the /etc/kubernetes/manifests directory.

​
Service Configuration Example (Non-Kubeadm Environments)

​
Checking the Running Process

To verify that the Kube Controller Manager is running and to inspect its active options, execute the following command on the master node:
An example output might be:
The image illustrates a Kubernetes controller architecture, showing various controllers like Deployment, Namespace, and Node, with monitoring and timeout settings.

​
Conclusion

This guide has provided an in-depth look at the Kube Controller Manager, detailing its critical functions in managing controllers, monitoring system changes, and ensuring the desired state within your Kubernetes cluster. By understanding and properly configuring the Controller Manager, you play a key role in maintaining a robust and scalable environment. Stay tuned for more lessons to further enhance your Kubernetes expertise! For additional details, you might find these resources useful:

Watch Video