OpsCanary
Back to daily brief
kubernetesupgradesPractitioner

Mastering kubeadm Upgrades: What You Need to Know

5 min read Kubernetes DocsApr 23, 2026
PractitionerHands-on experience recommended

Upgrading kubeadm clusters is essential for keeping your Kubernetes environment secure and efficient. It addresses vulnerabilities and ensures compatibility with new features. However, this process is not just a simple command; it requires careful planning and execution to avoid downtime and data loss.

The upgrade workflow is straightforward: start with the primary control plane node, then upgrade additional control plane nodes, and finally, upgrade the worker nodes. Use the command kubeadm upgrade to initiate the process. Be aware that when you upgrade etcd, in-flight requests will stall while the new etcd static pod restarts. Always back up your etcd data before an upgrade, as kubeadm does not touch your workloads directly but manages critical components within Kubernetes. You can also configure the upgrade process using the --config parameter, although it’s not mandatory.

In production, you must consider the implications of upgrading. For instance, kubeadm automatically renews certificates during the upgrade, which can be a double-edged sword if you haven't planned for it. Also, remember that skipping minor versions is unsupported, so always upgrade sequentially. The legacy package repositories have been deprecated, so ensure you’re using the latest sources for your upgrades. Finally, your Container Network Interface (CNI) provider may have its own upgrade instructions, which you should follow to avoid network issues post-upgrade.

Key takeaways

  • Start the upgrade with the primary control plane node before proceeding to others.
  • Always back up etcd data before executing `kubeadm upgrade` to prevent data loss.
  • Use `--config` to customize the upgrade process if needed.
  • Avoid skipping minor versions during upgrades as it is unsupported.
  • Check your CNI provider's upgrade instructions to ensure network stability.

Why it matters

In production, maintaining an up-to-date Kubernetes cluster is critical for security and performance. An upgrade can prevent vulnerabilities and ensure you have access to the latest features and fixes.

Code examples

Bash
```
kubeadm upgrade
```
Bash
```
sudo kubeadm upgrade apply v1.36.x
```
Bash
```
sudo kubeadm upgrade plan
```

When NOT to use this

Skipping MINOR versions when upgrading is unsupported. If your cluster relies on specific features from a minor version, ensure you upgrade sequentially to avoid compatibility issues.

Want the complete reference?

Read official docs

Test what you just learned

Quiz questions written from this article

Take the quiz →

Get the daily digest

One email. 5 articles. Every morning.

No spam. Unsubscribe anytime.