Reset (Uninstall)#
Resetting k0s nodes essentially reverts them to a pre-k0s state. This operation is particularly useful in scenarios where you need to cleanly remove k0s from nodes, either for troubleshooting purposes or as a precursor to a fresh installation. It is designed to remove all components, configurations, and data associated with k0s from a node. This includes, but is not limited to, the following:
- Processes and containers: Terminates all running k0s processes to ensure that there are no active components left. This includes all container processes managed by the Container Runtime.
- Mounts under k0s data directory: In order to prevent persistent data to be deleted, all mount points under k0s' data directory will be unmounted. If an unmount fails, it will be unmounted lazy.
- Data stored on the node: Deletes the whole k0s data directory, which includes
- all k0s-related configuration files, including those used for cluster setup and node-specific settings,
- all data stores managed by k0s, including etcd or kine data for cluster state and any temporary files created during operation,
- and all certificates and other key material generated by k0s for node authentication and communication within the cluster.
- Network settings: Reverts any network configurations made by k0s, such as network interfaces or iptables rules set up specifically for cluster communication. This is done on a best effort basis. It's recommended that you reboot the host after a reset to ensure that there are no k0s remnants in the host's network configuration.
- Registration with the host's init system: Reverts the registration done by
k0s install
. After a reset, k0s won't be automatically started when the host boots.
After a successful reset, the k0s binary itself remains. It can then be used to join another cluster or create a new one.
It's important to understand that performing a reset is a destructive operation that will result in the loss of all data and configurations related to k0s on the affected nodes. Therefore, it should be performed with care, ideally after ensuring that all necessary data has been backed up or that the cluster can be safely disassembled without data loss.
K0s can be reset locally on a host using the k0s reset
command. Whole clusters
can be reset remotely with the k0sctl reset
command.
Reset a k0s node locally#
To ensure operational safety, k0s reset
includes a safeguard that prevents it
from being executed while k0s is running, so it must be stopped first:
-
Stop the service:
sudo k0s stop
-
Invoke the
reset
command:$ sudo k0s reset WARN[2024-03-28 09:15:36] To ensure a full reset, a node reboot is recommended.
Reset a k0s cluster remotely using k0sctl#
K0sctl can be used to connect and reset all cluster nodes in a single command.
- Invoke
k0sctl reset
command:$ k0sctl reset --config k0sctl.yaml k0sctl v0.17.4 Copyright 2023, k0sctl authors. Anonymized telemetry of usage will be sent to the authors. By continuing to use k0sctl you agree to these terms: https://k0sproject.io/licenses/eula ? Going to reset all of the hosts, which will destroy all configuration and data, Are you sure? Yes INFO ==> Running phase: Connect to hosts INFO [ssh] 13.53.43.63:22: connected INFO [ssh] 13.53.218.149:22: connected INFO ==> Running phase: Detect host operating systems INFO [ssh] 13.53.43.63:22: is running Ubuntu 22.04.4 LTS INFO [ssh] 13.53.218.149:22: is running Ubuntu 22.04.4 LTS INFO ==> Running phase: Acquire exclusive host lock INFO ==> Running phase: Prepare hosts INFO ==> Running phase: Gather k0s facts INFO [ssh] 13.53.43.63:22: found existing configuration INFO [ssh] 13.53.43.63:22: is running k0s controller version v1.30.7+k0s.0 INFO [ssh] 13.53.218.149:22: is running k0s worker version v1.30.7+k0s.0 INFO [ssh] 13.53.43.63:22: checking if worker has joined INFO ==> Running phase: Reset workers INFO [ssh] 13.53.218.149:22: reset INFO ==> Running phase: Reset controllers INFO [ssh] 13.53.43.63:22: reset INFO ==> Running phase: Reset leader INFO [ssh] 13.53.43.63:22: reset INFO ==> Running phase: Release exclusive host lock INFO ==> Running phase: Disconnect from hosts INFO ==> Finished in 8s