Skip to content

Commit 76c8e14

Browse files
ci: audit the fresh-host prerequisites the smoke campaign surfaced
audit-fedora-prereqs.sh checked tools and inotify limits but not the three prerequisites that actually blocked the 2026-07 fresh-host bring-up mid-bootstrap. Add read-only sections, each with the fix command on failure: legacy iptables kernel modules (CNI portmap inside the rootless node), podman pids_limit (CAP-040), the full Istio distribution at ~/.local/share/istio-current (tier 9 Kiali), and a minikube >= 1.36 gate (1.35's registry addon pins a dead image digest). Verified on the campaign host: all four sections report ✓.
1 parent bb111ce commit 76c8e14

1 file changed

Lines changed: 68 additions & 0 deletions

File tree

‎scripts/audit-fedora-prereqs.sh‎

Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,74 @@ else
8989
echo " sudo sysctl -p /etc/sysctl.d/99-kubernetes.conf"
9090
fi
9191

92+
section "kernel modules (CNI portmap in a rootless node needs legacy iptables NAT)"
93+
MISSING_MODS=""
94+
for m in ip_tables iptable_nat ip6_tables; do
95+
if [[ -d "/sys/module/${m}" ]]; then
96+
printf ' %-12s loaded\n' "$m"
97+
else
98+
printf ' %-12s NOT LOADED\n' "$m"
99+
MISSING_MODS="${MISSING_MODS} ${m}"
100+
fi
101+
done
102+
if [[ -z "$MISSING_MODS" ]]; then
103+
echo " STATUS: ✓ OK — hostPort pods (registry proxy) can start"
104+
else
105+
echo " STATUS: ⚠ the rootless minikube node cannot modprobe these itself;"
106+
echo " hostPort pods will fail sandbox creation. Fix:"
107+
echo ""
108+
echo " sudo sh -c 'printf \"ip_tables\\niptable_nat\\nip6_tables\\n\" > /etc/modules-load.d/99-kubernetes-iptables.conf'"
109+
echo " sudo systemctl restart systemd-modules-load"
110+
fi
111+
112+
section "podman pids_limit (capstone node runs ~2000+ tasks — CAP-040)"
113+
PIDS_LIMIT=$(
114+
grep -hsE '^[[:space:]]*pids_limit[[:space:]]*=' \
115+
"${HOME}/.config/containers/containers.conf" \
116+
/etc/containers/containers.conf 2>/dev/null \
117+
| tail -1 | grep -oE '[0-9]+' | tail -1 || true
118+
)
119+
PIDS_LIMIT="${PIDS_LIMIT:-2048}"
120+
echo " effective pids_limit = ${PIDS_LIMIT} (0 = unlimited)"
121+
if [[ "$PIDS_LIMIT" == "0" ]] || (( PIDS_LIMIT >= 8192 )); then
122+
echo " STATUS: ✓ OK for the full meshed capstone"
123+
else
124+
echo " STATUS: ⚠ the node would cap TOTAL processes across all pods at ${PIDS_LIMIT}"
125+
echo " and the last pods fail to fork (EAGAIN, runc exit 128). Fix"
126+
echo " BEFORE creating the node:"
127+
echo ""
128+
echo " mkdir -p ~/.config/containers"
129+
echo " printf '[containers]\\npids_limit = 0\\n' >> ~/.config/containers/containers.conf"
130+
fi
131+
132+
section "istio distribution (setup-kiali.sh needs samples/addons/kiali.yaml)"
133+
ISTIO_CURRENT="${HOME}/.local/share/istio-current"
134+
if [[ -f "${ISTIO_CURRENT}/samples/addons/kiali.yaml" ]]; then
135+
echo " ${ISTIO_CURRENT} → $(readlink -f "$ISTIO_CURRENT" 2>/dev/null || echo "$ISTIO_CURRENT")"
136+
echo " STATUS: ✓ full distribution present (istioctl alone is not enough)"
137+
else
138+
echo " STATUS: ⚠ ${ISTIO_CURRENT}/samples/addons/kiali.yaml not found —"
139+
echo " bootstrap tier 9 (Kiali) will fail. Fix:"
140+
echo ""
141+
echo " curl -fsSL https://github.com/istio/istio/releases/download/1.26.2/istio-1.26.2-linux-amd64.tar.gz | tar xz -C ~/.local/share"
142+
echo " ln -sfn ~/.local/share/istio-1.26.2 ~/.local/share/istio-current"
143+
fi
144+
145+
section "minikube minimum version (1.35's registry addon pins a dead image digest)"
146+
if command -v minikube >/dev/null 2>&1; then
147+
MK_VERSION="$(minikube version --short 2>/dev/null | grep -oE 'v[0-9]+\.[0-9]+\.[0-9]+' || echo v0.0.0)"
148+
echo " minikube ${MK_VERSION} at $(command -v minikube)"
149+
if [[ "$(printf '%s\n' "v1.36.0" "$MK_VERSION" | sort -V | head -1)" == "v1.36.0" ]]; then
150+
echo " STATUS: ✓ OK (>= 1.36)"
151+
else
152+
echo " STATUS: ⚠ too old — the registry addon can never come up on < 1.36."
153+
echo " Install a current minikube (e.g. to ~/.local/bin, which"
154+
echo " precedes /usr/local/bin on PATH)."
155+
fi
156+
else
157+
echo " (minikube not present)"
158+
fi
159+
92160
section "done"
93161
echo "Paste the entire output above (from === platform === down) into"
94162
echo "the iteration thread so version pins can be set from real data."

0 commit comments

Comments
 (0)