2.0 KiB
| reviewers | title | content_type | weight | ||
|---|---|---|---|---|---|
|
kubeadm upgrade | concept | 40 |
kubeadm upgrade is a user-friendly command that wraps complex upgrading logic
behind one command, with support for both planning an upgrade and actually performing it.
kubeadm upgrade guidance
The steps for performing a upgrade using kubeadm are outlined in this document. For older versions of kubeadm, please refer to older documentation sets of the Kubernetes website.
You can use kubeadm upgrade diff to see the changes that would be applied to static pod manifests.
In Kubernetes v1.15.0 and later, kubeadm upgrade apply and kubeadm upgrade node will also
automatically renew the kubeadm managed certificates on this node, including those stored in kubeconfig files.
To opt-out, it is possible to pass the flag --certificate-renewal=false. For more details about certificate
renewal see the certificate management documentation.
{{< note >}}
The commands kubeadm upgrade apply and kubeadm upgrade plan have a legacy --config
flag which makes it possible to reconfigure the cluster, while performing planning or upgrade of that particular
control-plane node. Please be aware that the upgrade workflow was not designed for this scenario and there are
reports of unexpected results.
{{</ note >}}
kubeadm upgrade plan
{{< include "generated/kubeadm_upgrade_plan.md" >}}
kubeadm upgrade apply
{{< include "generated/kubeadm_upgrade_apply.md" >}}
kubeadm upgrade diff
{{< include "generated/kubeadm_upgrade_diff.md" >}}
kubeadm upgrade node
{{< include "generated/kubeadm_upgrade_node.md" >}}
{{% heading "whatsnext" %}}
- kubeadm config if you initialized your cluster using kubeadm v1.7.x or lower, to configure your cluster for
kubeadm upgrade