Skip to content

Commit 6b8b558

Browse files
authored
Add note on node cordon and draining for upgrades
Signed-off-by: Faraz Khawaja <khwajafarazahmed@gmail.com>
1 parent 7f3667c commit 6b8b558

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

docs/upgrades/manual.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,10 @@ Running the install script will:
4242
2. Update the systemd unit or openrc init script to reflect the args passed to the install script
4343
3. Restart the k3s service
4444

45+
:::note
46+
Containers for Pods continue running even when K3s is stopped. The install script does not drain or cordon the node before restarting k3s. If your workload is sensitive to brief API server outages, you should manually [drain and cordon](https://kubernetes.io/docs/reference/kubectl/generated/kubectl_drain/) the node using `kubectl` before re-running the install script to upgrade k3s or modify the configuration, and uncordon it afterwards.
47+
:::
48+
4549
For example, to upgrade to the current stable release:
4650

4751
```sh
@@ -70,3 +74,7 @@ To upgrade K3s manually, you can download the desired version of the K3s binary
7074
1. Download the desired version of the K3s binary from [releases](https://github.com/k3s-io/k3s/releases)
7175
2. Copy the downloaded binary to `/usr/local/bin/k3s` (or your desired location)
7276
3. Restart the k3s or k3s-agent service or restart the k3s process (binary)
77+
78+
:::note
79+
Containers for Pods continue running even when K3s is stopped. It is generally safe to restart K3s without draining pods and cordoning the node. If your workload is sensitive to brief API server outages, you should manually [drain and cordon](https://kubernetes.io/docs/reference/kubectl/generated/kubectl_drain/) the node using `kubectl` before restarting K3s, and uncordon it afterwards.
80+
:::

0 commit comments

Comments
 (0)