deytenit
6463bad5ee
- Purge misplaced RFCs, scratch tokens, and node-proprietary assets - Decouple remote provisioning to ci/scripts/init-node.py - Add targeted composition orchestration in actions/compose.py - Add host-side Xray stale socket cleanup in /dev/shm - Add actions/env.py for shell exports and .env synchronization - Harden UFW, backup retention, host tempfiles, and notify dispatcher - Add pyproject.toml and Makefile with 78 passing unit tests
107 lines
4.6 KiB
Python
107 lines
4.6 KiB
Python
# engine/lib/ufw.py
|
|
"""ctx.ufw — ufw + ufw-docker rule application with self-healing marker migration.
|
|
|
|
Injects the APEX marker block into before/after.rules, deleting BOTH the old ROOT
|
|
and the new APEX blocks first (so re-running after cutover migrates the marker in
|
|
place — SP2 §6). Docker rules go through ufw-docker; host rules through plain ufw.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import os
|
|
import shlex
|
|
import shutil
|
|
|
|
APEX_START = "# START APEX.ERMNVLDMR.COM RULES"
|
|
APEX_END = "# END APEX.ERMNVLDMR.COM RULES"
|
|
OLD_PAIRS = [("# START ROOT.ERMNVLDMR.COM RULES", "# END ROOT.ERMNVLDMR.COM RULES")]
|
|
|
|
|
|
def resolve_ufw_docker_bin() -> str:
|
|
"""Find ufw-docker in PATH, /usr/local/bin, or fallback to ~/.local/bin/ufw-docker."""
|
|
found = shutil.which("ufw-docker")
|
|
if found:
|
|
return found
|
|
if os.path.isfile("/usr/local/bin/ufw-docker") and os.access("/usr/local/bin/ufw-docker", os.X_OK):
|
|
return "/usr/local/bin/ufw-docker"
|
|
return os.path.expanduser("~/.local/bin/ufw-docker")
|
|
|
|
|
|
UFW_DOCKER_BIN = resolve_ufw_docker_bin()
|
|
|
|
|
|
def clean_rules(text: str):
|
|
"""Strip whitespace, drop blank + comment lines (matches the bash awk filter)."""
|
|
return [s for s in (ln.strip() for ln in text.splitlines()) if s and not s.startswith("#")]
|
|
|
|
|
|
class Ufw:
|
|
def __init__(self, log, sys_, host):
|
|
self.log, self.sys, self.host = log, sys_, host
|
|
|
|
def _inject_file(self, target: str, source_file: str, dry_run: bool):
|
|
if not os.path.isfile(source_file):
|
|
return
|
|
if not self.sys.ok(["sudo", "test", "-f", target]):
|
|
self.log.error(f"Target file does not exist: {target}")
|
|
raise SystemExit(1)
|
|
with open(source_file, encoding="utf-8") as f:
|
|
content = "\n".join(clean_rules(f.read()))
|
|
self.host.inject_block(
|
|
target,
|
|
content,
|
|
APEX_START,
|
|
APEX_END,
|
|
anchor="# End required lines",
|
|
old_pairs=OLD_PAIRS,
|
|
dry_run=dry_run,
|
|
sudo=True,
|
|
)
|
|
|
|
def apply(self, rules_dir: str | None = None, config_dir: str | None = None, dry_run: bool = False) -> None:
|
|
if rules_dir and not os.path.isdir(rules_dir):
|
|
self.log.error(f"Rules directory does not exist: {rules_dir}")
|
|
raise SystemExit(66)
|
|
if config_dir and not os.path.isdir(config_dir):
|
|
self.log.error(f"Config directory does not exist: {config_dir}")
|
|
raise SystemExit(66)
|
|
if not rules_dir and not config_dir:
|
|
self.log.warn("Neither docker nor host ufw rules directory found; nothing to apply.")
|
|
return
|
|
if not self.sys.ok(["sudo", "ufw", "--version"]):
|
|
self.log.error("ufw not installed/working via sudo. Run configure/base first.")
|
|
raise SystemExit(1)
|
|
if not (os.path.isfile(UFW_DOCKER_BIN) and os.access(UFW_DOCKER_BIN, os.X_OK)):
|
|
self.log.error(f"ufw-docker not found at {UFW_DOCKER_BIN}. Run configure/base first.")
|
|
raise SystemExit(1)
|
|
|
|
if config_dir:
|
|
host_rules = os.path.join(config_dir, "host.rules")
|
|
if os.path.isfile(host_rules):
|
|
with open(host_rules, encoding="utf-8") as f:
|
|
rules = clean_rules(f.read())
|
|
for rule in rules:
|
|
self.log.info(f"Applying host ufw rule: {rule}")
|
|
if dry_run:
|
|
self.log.info(f"[DRY-RUN] sudo ufw {rule}")
|
|
else:
|
|
self.sys.sudo(["ufw", *shlex.split(rule)], check=True)
|
|
self._inject_file("/etc/ufw/before.rules", os.path.join(config_dir, "before.rules"), dry_run)
|
|
self._inject_file("/etc/ufw/after.rules", os.path.join(config_dir, "after.rules"), dry_run)
|
|
|
|
if rules_dir:
|
|
rule_files = [fn for fn in sorted(os.listdir(rules_dir)) if fn.endswith(".rules") and not fn.startswith(".")]
|
|
if not rule_files:
|
|
self.log.warn(f"No .rules files found in {rules_dir}, nothing to apply.")
|
|
for fn in rule_files:
|
|
with open(os.path.join(rules_dir, fn), encoding="utf-8") as f:
|
|
rules = clean_rules(f.read())
|
|
for rule in rules:
|
|
self.log.info(f"Applying ufw-docker rule ({fn}): {rule}")
|
|
if dry_run:
|
|
self.log.info(f"[DRY-RUN] sudo {UFW_DOCKER_BIN} {rule}")
|
|
else:
|
|
self.sys.sudo([UFW_DOCKER_BIN, *shlex.split(rule)], check=True)
|
|
|
|
self.log.success("All ufw rules applied.")
|
|
self.log.warn("Run `sudo systemctl restart ufw` to apply. Ensure ssh is allowed via plain ufw!")
|