canasta uninstall

canasta > uninstall

canasta uninstall

Uninstall dependencies from the target host

Synopsis

Uninstall dependencies from the target host. Supported packages: k8s (removes k3s, kubectl, helm, and cleans up iptables rules; NFS exports that canasta storage setup nfs --install-server scoped to the cluster are withdrawn, their contents left on disk; the NFS server it started is stopped once nothing else is exported).

When uninstalling k8s from a worker, pass --cp-host <name> to also delete the worker's Node entry from the control plane. Without it, the Node lingers in kubectl get nodes until manually removed (and a worker rejoining with the same hostname will reclaim it, masking the uninstall).

canasta uninstall [flags] PACKAGES...

Examples

canasta uninstall k8s
canasta uninstall k8s --host worker1 --cp-host cp

Arguments

Argument	Description	Default	Required	Orchestrator
PACKAGES	Dependencies to uninstall (k8s)		✓	Both

Flags

Flag	Shorthand	Description	Default	Required	Orchestrator
--cp-host		For k8s worker uninstalls, name of the registered control-plane host. Canasta SSHs there after stopping the agent and runs 'kubectl delete node <hostname>' so the Node entry is cleaned up. On a host whose k3s is already gone, only that Node removal runs. Ignored on control-plane uninstalls.			Both
--docker-host		Docker API socket on the target. Set this when the target uses rootless podman or rootless Docker. Defaults to system Docker's /var/run/docker.sock.			Both
--force	-f	Proceed even when the target node holds PersistentVolumes whose data the uninstall would destroy, or when the control plane cannot be reached to check them or to remove the worker's Node.			Both
--host	-H	Target host (default: localhost)			Both
--yes	-y	Skip confirmation prompt			Both

Global flags

Flag	Shorthand	Description	Default	Required	Orchestrator
--help	-h	Show help message and exit			Both
--verbose	-v	Enable verbose output			Both