Skip to content

Commit 45aa96c

Browse files
committed
kubeadm: update notes about upgrade and --config
1 parent 58c8f40 commit 45aa96c

File tree

1 file changed

+6
-11
lines changed

1 file changed

+6
-11
lines changed

content/en/docs/tasks/administer-cluster/kubeadm/kubeadm-upgrade.md

Lines changed: 6 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -49,9 +49,10 @@ The upgrade workflow at high level is the following:
4949
- All containers are restarted after upgrade, because the container spec hash value is changed.
5050
- To verify that the kubelet service has successfully restarted after the kubelet has been upgraded,
5151
you can execute `systemctl status kubelet` or view the service logs with `journalctl -xeu kubelet`.
52-
- Usage of the `--config` flag of `kubeadm upgrade` with
53-
[kubeadm configuration API types](/docs/reference/config-api/kubeadm-config.v1beta3)
54-
with the purpose of reconfiguring the cluster is not recommended and can have unexpected results. Follow the steps in
52+
- `kubeadm upgrade` supports `--config` with a
53+
[`UpgradeConfiguration` API type](/docs/reference/config-api/kubeadm-config.v1beta4) which can
54+
be used to configure the upgrade process.
55+
- `kubeadm upgrade` does not support reconfiguration of an existing cluster. Follow the steps in
5556
[Reconfiguring a kubeadm cluster](/docs/tasks/administer-cluster/kubeadm/kubeadm-reconfigure) instead.
5657

5758
### Considerations when upgrading etcd
@@ -161,13 +162,7 @@ Pick a control plane node that you wish to upgrade first. It must have the `/etc
161162
For more information see the [certificate management guide](/docs/tasks/administer-cluster/kubeadm/kubeadm-certs).
162163
{{</ note >}}
163164

164-
{{< note >}}
165-
If `kubeadm upgrade plan` shows any component configs that require manual upgrade, users must provide
166-
a config file with replacement configs to `kubeadm upgrade apply` via the `--config` command line flag.
167-
Failing to do so will cause `kubeadm upgrade apply` to exit with an error and not perform an upgrade.
168-
{{</ note >}}
169-
170-
1. Choose a version to upgrade to, and run the appropriate command. For example:
165+
1. Choose a version to upgrade to, and run the appropriate command. For example:
171166

172167
```shell
173168
# replace x with the patch version you picked for this upgrade
@@ -309,7 +304,7 @@ manually restored in `/etc/kubernetes/manifests`. If for some reason there is no
309304
and post-upgrade manifest file for a certain component, a backup file for it will not be written.
310305

311306
{{< note >}}
312-
After the cluster upgrade using kubeadm, the backup directory `/etc/kubernetes/tmp` will remain and
307+
After the cluster upgrade using kubeadm, the backup directory `/etc/kubernetes/tmp` will remain and
313308
these backup files will need to be cleared manually.
314309
{{</ note >}}
315310

0 commit comments

Comments
 (0)