Skip to content

Commit 8232eb3

Browse files
committed
reformat kubeadm upgrade page
1 parent 991aadb commit 8232eb3

File tree

1 file changed

+68
-68
lines changed

1 file changed

+68
-68
lines changed

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

Lines changed: 68 additions & 68 deletions
Original file line numberDiff line numberDiff line change
@@ -50,59 +50,59 @@ The upgrade workflow at high level is the following:
5050

5151
## Determine which version to upgrade to
5252

53-
1. Find the latest stable 1.18 version:
53+
Find the latest stable 1.18 version:
5454

55-
{{< tabs name="k8s_install_versions" >}}
56-
{{% tab name="Ubuntu, Debian or HypriotOS" %}}
55+
{{< tabs name="k8s_install_versions" >}}
56+
{{% tab name="Ubuntu, Debian or HypriotOS" %}}
5757
apt update
5858
apt-cache madison kubeadm
5959
# find the latest 1.18 version in the list
6060
# it should look like 1.18.x-00, where x is the latest patch
61-
{{% /tab %}}
62-
{{% tab name="CentOS, RHEL or Fedora" %}}
61+
{{% /tab %}}
62+
{{% tab name="CentOS, RHEL or Fedora" %}}
6363
yum list --showduplicates kubeadm --disableexcludes=kubernetes
6464
# find the latest 1.18 version in the list
6565
# it should look like 1.18.x-0, where x is the latest patch
66-
{{% /tab %}}
67-
{{< /tabs >}}
66+
{{% /tab %}}
67+
{{< /tabs >}}
6868

6969
## Upgrading control plane nodes
7070

7171
### Upgrade the first control plane node
7272

73-
1. On your first control plane node, upgrade kubeadm:
73+
- On your first control plane node, upgrade kubeadm:
7474

75-
{{< tabs name="k8s_install_kubeadm_first_cp" >}}
76-
{{% tab name="Ubuntu, Debian or HypriotOS" %}}
75+
{{< tabs name="k8s_install_kubeadm_first_cp" >}}
76+
{{% tab name="Ubuntu, Debian or HypriotOS" %}}
7777
# replace x in 1.18.x-00 with the latest patch version
7878
apt-mark unhold kubeadm && \
7979
apt-get update && apt-get install -y kubeadm=1.18.x-00 && \
8080
apt-mark hold kubeadm
81-
81+
-
8282
# since apt-get version 1.1 you can also use the following method
8383
apt-get update && \
8484
apt-get install -y --allow-change-held-packages kubeadm=1.18.x-00
85-
{{% /tab %}}
86-
{{% tab name="CentOS, RHEL or Fedora" %}}
85+
{{% /tab %}}
86+
{{% tab name="CentOS, RHEL or Fedora" %}}
8787
# replace x in 1.18.x-0 with the latest patch version
8888
yum install -y kubeadm-1.18.x-0 --disableexcludes=kubernetes
89-
{{% /tab %}}
90-
{{< /tabs >}}
89+
{{% /tab %}}
90+
{{< /tabs >}}
9191

92-
1. Verify that the download works and has the expected version:
92+
- Verify that the download works and has the expected version:
9393

9494
```shell
9595
kubeadm version
9696
```
9797

98-
1. Drain the control plane node:
98+
- Drain the control plane node:
9999

100100
```shell
101101
# replace <cp-node-name> with the name of your control plane node
102102
kubectl drain <cp-node-name> --ignore-daemonsets
103103
```
104104

105-
1. On the control plane node, run:
105+
- On the control plane node, run:
106106

107107
```shell
108108
sudo kubeadm upgrade plan
@@ -145,13 +145,13 @@ The upgrade workflow at high level is the following:
145145

146146
This command checks that your cluster can be upgraded, and fetches the versions you can upgrade to.
147147

148-
{{< note >}}
149-
`kubeadm upgrade` also automatically renews the certificates that it manages on this node.
150-
To opt-out of certificate renewal the flag `--certificate-renewal=false` can be used.
151-
For more information see the [certificate management guide](/docs/tasks/administer-cluster/kubeadm/kubeadm-certs).
152-
{{</ note >}}
148+
{{< note >}}
149+
`kubeadm upgrade` also automatically renews the certificates that it manages on this node.
150+
To opt-out of certificate renewal the flag `--certificate-renewal=false` can be used.
151+
For more information see the [certificate management guide](/docs/tasks/administer-cluster/kubeadmkubeadm-certs).
152+
{{</ note >}}
153153

154-
1. Choose a version to upgrade to, and run the appropriate command. For example:
154+
- Choose a version to upgrade to, and run the appropriate command. For example:
155155

156156
```shell
157157
# replace x with the patch version you picked for this upgrade
@@ -240,15 +240,15 @@ The upgrade workflow at high level is the following:
240240
[upgrade/kubelet] Now that your control plane is upgraded, please proceed with upgrading your kubelets if you haven't already done so.
241241
```
242242

243-
1. Manually upgrade your CNI provider plugin.
243+
- Manually upgrade your CNI provider plugin.
244244

245245
Your Container Network Interface (CNI) provider may have its own upgrade instructions to follow.
246246
Check the [addons](/docs/concepts/cluster-administration/addons/) page to
247247
find your CNI provider and see whether additional upgrade steps are required.
248248

249249
This step is not required on additional control plane nodes if the CNI provider runs as a DaemonSet.
250250

251-
1. Uncordon the control plane node:
251+
- Uncordon the control plane node:
252252

253253
```shell
254254
# replace <cp-node-name> with the name of your control plane node
@@ -257,46 +257,46 @@ The upgrade workflow at high level is the following:
257257

258258
### Upgrade additional control plane nodes
259259

260-
1. Same as the first control plane node but use:
260+
Same as the first control plane node but use:
261261

262-
```
263-
sudo kubeadm upgrade node
264-
```
262+
```
263+
sudo kubeadm upgrade node
264+
```
265265

266-
instead of:
266+
instead of:
267267

268-
```
269-
sudo kubeadm upgrade apply
270-
```
268+
```
269+
sudo kubeadm upgrade apply
270+
```
271271

272-
Also `sudo kubeadm upgrade plan` is not needed.
272+
Also `sudo kubeadm upgrade plan` is not needed.
273273

274274
### Upgrade kubelet and kubectl
275275

276-
1. Upgrade the kubelet and kubectl on all control plane nodes:
276+
Upgrade the kubelet and kubectl on all control plane nodes:
277277

278-
{{< tabs name="k8s_install_kubelet" >}}
279-
{{% tab name="Ubuntu, Debian or HypriotOS" %}}
278+
{{< tabs name="k8s_install_kubelet" >}}
279+
{{% tab name="Ubuntu, Debian or HypriotOS" %}}
280280
# replace x in 1.18.x-00 with the latest patch version
281281
apt-mark unhold kubelet kubectl && \
282282
apt-get update && apt-get install -y kubelet=1.18.x-00 kubectl=1.18.x-00 && \
283283
apt-mark hold kubelet kubectl
284-
284+
-
285285
# since apt-get version 1.1 you can also use the following method
286286
apt-get update && \
287287
apt-get install -y --allow-change-held-packages kubelet=1.18.x-00 kubectl=1.18.x-00
288-
{{% /tab %}}
289-
{{% tab name="CentOS, RHEL or Fedora" %}}
288+
{{% /tab %}}
289+
{{% tab name="CentOS, RHEL or Fedora" %}}
290290
# replace x in 1.18.x-0 with the latest patch version
291291
yum install -y kubelet-1.18.x-0 kubectl-1.18.x-0 --disableexcludes=kubernetes
292-
{{% /tab %}}
293-
{{< /tabs >}}
292+
{{% /tab %}}
293+
{{< /tabs >}}
294294

295-
1. Restart the kubelet
295+
Restart the kubelet
296296

297-
```shell
298-
sudo systemctl restart kubelet
299-
```
297+
```shell
298+
sudo systemctl restart kubelet
299+
```
300300

301301
## Upgrade worker nodes
302302

@@ -305,28 +305,28 @@ without compromising the minimum required capacity for running your workloads.
305305

306306
### Upgrade kubeadm
307307

308-
1. Upgrade kubeadm on all worker nodes:
308+
- Upgrade kubeadm on all worker nodes:
309309

310-
{{< tabs name="k8s_install_kubeadm_worker_nodes" >}}
311-
{{% tab name="Ubuntu, Debian or HypriotOS" %}}
310+
{{< tabs name="k8s_install_kubeadm_worker_nodes" >}}
311+
{{% tab name="Ubuntu, Debian or HypriotOS" %}}
312312
# replace x in 1.18.x-00 with the latest patch version
313313
apt-mark unhold kubeadm && \
314314
apt-get update && apt-get install -y kubeadm=1.18.x-00 && \
315315
apt-mark hold kubeadm
316-
316+
-
317317
# since apt-get version 1.1 you can also use the following method
318318
apt-get update && \
319319
apt-get install -y --allow-change-held-packages kubeadm=1.18.x-00
320-
{{% /tab %}}
321-
{{% tab name="CentOS, RHEL or Fedora" %}}
320+
{{% /tab %}}
321+
{{% tab name="CentOS, RHEL or Fedora" %}}
322322
# replace x in 1.18.x-0 with the latest patch version
323323
yum install -y kubeadm-1.18.x-0 --disableexcludes=kubernetes
324-
{{% /tab %}}
325-
{{< /tabs >}}
324+
{{% /tab %}}
325+
{{< /tabs >}}
326326

327327
### Drain the node
328328

329-
1. Prepare the node for maintenance by marking it unschedulable and evicting the workloads:
329+
- Prepare the node for maintenance by marking it unschedulable and evicting the workloads:
330330

331331
```shell
332332
# replace <node-to-drain> with the name of your node you are draining
@@ -343,42 +343,42 @@ without compromising the minimum required capacity for running your workloads.
343343

344344
### Upgrade the kubelet configuration
345345

346-
1. Call the following command:
346+
- Call the following command:
347347

348348
```shell
349349
sudo kubeadm upgrade node
350350
```
351351

352352
### Upgrade kubelet and kubectl
353353

354-
1. Upgrade the kubelet and kubectl on all worker nodes:
354+
- Upgrade the kubelet and kubectl on all worker nodes:
355355

356-
{{< tabs name="k8s_kubelet_and_kubectl" >}}
357-
{{% tab name="Ubuntu, Debian or HypriotOS" %}}
356+
{{< tabs name="k8s_kubelet_and_kubectl" >}}
357+
{{% tab name="Ubuntu, Debian or HypriotOS" %}}
358358
# replace x in 1.18.x-00 with the latest patch version
359359
apt-mark unhold kubelet kubectl && \
360360
apt-get update && apt-get install -y kubelet=1.18.x-00 kubectl=1.18.x-00 && \
361361
apt-mark hold kubelet kubectl
362-
362+
-
363363
# since apt-get version 1.1 you can also use the following method
364364
apt-get update && \
365365
apt-get install -y --allow-change-held-packages kubelet=1.18.x-00 kubectl=1.18.x-00
366-
{{% /tab %}}
367-
{{% tab name="CentOS, RHEL or Fedora" %}}
366+
{{% /tab %}}
367+
{{% tab name="CentOS, RHEL or Fedora" %}}
368368
# replace x in 1.18.x-0 with the latest patch version
369369
yum install -y kubelet-1.18.x-0 kubectl-1.18.x-0 --disableexcludes=kubernetes
370-
{{% /tab %}}
371-
{{< /tabs >}}
370+
{{% /tab %}}
371+
{{< /tabs >}}
372372

373-
1. Restart the kubelet
373+
- Restart the kubelet
374374

375375
```shell
376376
sudo systemctl restart kubelet
377377
```
378378

379379
### Uncordon the node
380380

381-
1. Bring the node back online by marking it schedulable:
381+
- Bring the node back online by marking it schedulable:
382382

383383
```shell
384384
# replace <node-to-drain> with the name of your node
@@ -441,4 +441,4 @@ and post-upgrade manifest file for a certain component, a backup file for it wil
441441
`kubeadm upgrade node` does the following on worker nodes:
442442
443443
- Fetches the kubeadm `ClusterConfiguration` from the cluster.
444-
- Upgrades the kubelet configuration for this node.
444+
- Upgrades the kubelet configuration for this node.

0 commit comments

Comments
 (0)