@@ -49,9 +49,10 @@ The upgrade workflow at high level is the following:
49
49
- All containers are restarted after upgrade, because the container spec hash value is changed.
50
50
- To verify that the kubelet service has successfully restarted after the kubelet has been upgraded,
51
51
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
55
56
[ Reconfiguring a kubeadm cluster] ( /docs/tasks/administer-cluster/kubeadm/kubeadm-reconfigure ) instead.
56
57
57
58
### Considerations when upgrading etcd
@@ -161,13 +162,7 @@ Pick a control plane node that you wish to upgrade first. It must have the `/etc
161
162
For more information see the [ certificate management guide] ( /docs/tasks/administer-cluster/kubeadm/kubeadm-certs ) .
162
163
{{</ note >}}
163
164
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:
171
166
172
167
``` shell
173
168
# 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
309
304
and post-upgrade manifest file for a certain component, a backup file for it will not be written.
310
305
311
306
{{< 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
313
308
these backup files will need to be cleared manually.
314
309
{{</ note >}}
315
310
0 commit comments