feat(prereq): add toggle to disable swap on all cluster nodes (#698)

k3s recommends swap be disabled on every node. Add a disable_swap toggle
(default true) to the prereq role that turns swap off now and comments out the
swap entries in /etc/fstab so swap stays off across reboots. The change is
applied uniformly across all k3s_cluster hosts (all-or-nothing) since leaving
swap on for some nodes but not others creates uneven scheduling and latency.

- roles/prereq/defaults/main.yml: add disable_swap: true default
- roles/prereq/tasks/main.yml: idempotent swapoff -a and fstab comment-out block
  gated on disable_swap
- inventory/sample/group_vars/all.yml: document the new sample variable
- README.md: document the disable_swap option
- .github/scripts/test-disable-swap.sh: regression test
- .pre-commit-config.yaml: wire the test into pre-commit

Closes #670

This commit is contained in:

Techno Tim

2026-08-05 07:39:00 -05:00

committed by

GitHub

parent cf76292169

commit 56bb912bd3

6 changed files with 72 additions and 0 deletions

									
										roles/prereq/defaults/main.yml
									
		+2
		
												View File
												
				@@ -1,4 +1,6 @@

				---

				disable_swap: true

				secure_path:

				  RedHat: /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin

				  Suse: /usr/sbin:/usr/bin:/sbin:/bin:/usr/local/bin