#!/usr/bin/env python3 """Реестр действий Hermes (V1, Фаза B). Каждое действие: идемпотентно, проверяет политику, умеет dry-run, пишет журнал. CLI: actions.py list — что умеем actions.py run [k=v ...] — выполнить (в dry-run только расскажет) actions.py plan — что агент сделал бы прямо сейчас по политике """ import json import os import subprocess import sys sys.path.insert(0, "/root/buryan-infra/ops/hermes") import guards REGISTRY = {} def action(aid, desc, level, idempotent=True): def deco(fn): REGISTRY[aid] = {"id": aid, "desc": desc, "level": level, "idempotent": idempotent, "fn": fn} return fn return deco def sh(cmd, timeout=60): try: r = subprocess.run(cmd, shell=True, capture_output=True, text=True, timeout=timeout) return r.returncode, (r.stdout or "").strip(), (r.stderr or "").strip() except Exception as e: return 1, "", str(e) # ──────────────────────────── действия ──────────────────────────── @action("pct_start", "запустить LXC, если он остановлен", "L2_safe_auto") def pct_start(ct): code, out, _ = sh("pct status %s" % ct, 20) if "running" in out: return {"skip": "CT%s уже запущен" % ct} code, out, err = sh("pct start %s" % ct, 120) return {"did": "pct start %s" % ct, "code": code, "err": err[:200]} @action("docker_start", "запустить контейнер в CT, если остановлен", "L2_safe_auto") def docker_start(ct, name): code, out, _ = sh("pct exec %s -- docker ps --format '{{.Names}}' 2>/dev/null" % ct, 30) if name in out.split(): return {"skip": "%s уже запущен" % name} code, out, err = sh("pct exec %s -- docker start %s" % (ct, name), 120) return {"did": "docker start %s@ct%s" % (name, ct), "code": code, "err": err[:200]} @action("restart_exporter", "перезапустить node-exporter на хосте", "L2_safe_auto") def restart_exporter(): code, _, err = sh("systemctl restart prometheus-node-exporter", 60) return {"did": "systemctl restart prometheus-node-exporter", "code": code, "err": err[:200]} @action("rotate_logs", "ротация журналов и очистка неиспользуемых образов", "L2_safe_auto") def rotate_logs(): code, out, _ = sh("logrotate -f /etc/logrotate.conf 2>&1 | tail -3", 120) code2, out2, _ = sh("docker image prune -f 2>&1 | tail -2", 180) return {"did": "logrotate + image prune", "logrotate": out[:200], "prune": out2[:200]} @action("rescan_movies", "пересканировать папку фильмов в Radarr", "L3_domain_auto") def rescan_movies(): key = open("/root/.radarr-key").read().strip() body = json.dumps({"name": "DownloadedMoviesScan"}) code, out, err = sh("curl -s -m 30 -X POST -H 'X-Api-Key: %s' -H 'Content-Type: application/json' " "-d '%s' http://192.168.1.118:7878/api/v3/command" % (key, body), 40) return {"did": "Radarr DownloadedMoviesScan", "code": code, "resp": out[:200]} @action("retry_search", "повторить поиск релизов для фильмов без файла", "L3_domain_auto") def retry_search(): key = open("/root/.radarr-key").read().strip() code, out, _ = sh("curl -s -m 20 -H 'X-Api-Key: %s' http://192.168.1.118:7878/api/v3/movie" % key, 30) try: movies = json.loads(out) except Exception: return {"error": "не удалось получить список фильмов"} ids = [m["id"] for m in movies if not m.get("hasFile")] if not ids: return {"skip": "все фильмы с файлами"} body = json.dumps({"name": "MoviesSearch", "movieIds": ids}) code, out, _ = sh("curl -s -m 30 -X POST -H 'X-Api-Key: %s' -H 'Content-Type: application/json' " "-d '%s' http://192.168.1.118:7878/api/v3/command" % (key, body), 40) return {"did": "MoviesSearch для %d фильмов" % len(ids), "code": code} @action("qb_resume", "возобновить загрузки qBittorrent", "L2_safe_auto") def qb_resume(): code, out, err = sh("curl -s -m 15 -X POST 'http://192.168.1.123:8085/api/v2/torrents/resume' " "-d 'hashes=all' -w '%{http_code}'", 25) return {"did": "qBittorrent resume all", "code": code, "resp": out[:100]} @action("ha_call_service", "вызвать службу Home Assistant", "L3_domain_auto") def ha_call_service(domain, service, entity_id): token = open("/root/.ha-token").read().strip() body = json.dumps({"entity_id": entity_id}) code, out, err = sh("curl -s -m 20 -X POST -H 'Authorization: Bearer %s' -H 'Content-Type: application/json' " "-d '%s' http://192.168.1.106:8123/api/services/%s/%s" % (token, body, domain, service), 30) return {"did": "%s.%s(%s)" % (domain, service, entity_id), "code": code} # ──────────────────────────── исполнитель ──────────────────────────── def run(aid, params): if aid not in REGISTRY: return {"error": "нет такого действия: " + aid} act = REGISTRY[aid] dry = (guards._defaults() or {}).get("dry_run", True) lock, why = guards.begin("action:" + aid) if lock is None: return {"blocked": why} try: if dry: res = {"dry_run": True, "action": aid, "params": params, "would": "%s %s" % (aid, params), "level": act["level"]} else: res = act["fn"](**params) res["dry_run"] = False guards.finish("action:" + aid, lock, True, json.dumps(res, ensure_ascii=False)[:300]) return res except Exception as e: guards.finish("action:" + aid, lock, False, str(e)[:200]) return {"error": str(e)[:300]} def plan(): """Что агент сделал бы по текущему состоянию (только предложения).""" proposals = [] # намеренно остановленное — не предлагаем запускать skip_ct = set() try: import yaml m = yaml.safe_load(open("/root/buryan-infra/ops/hermes/maintenance.yaml", encoding="utf-8")) or {} skip_ct = {str(k) for k in (m.get("ct") or {}).keys()} except Exception: pass # 1. упавшие контейнеры code, out, _ = sh("pct list", 30) for ln in out.splitlines()[1:]: p = ln.split() if len(p) >= 2 and p[1] != "running" and p[0] not in skip_ct: proposals.append({"action": "pct_start", "params": {"ct": p[0]}, "reason": "CT%s не запущен (%s)" % (p[0], p[2] if len(p) > 2 else ""), "level": "L2_safe_auto"}) # 2. фильмы без файла key = open("/root/.radarr-key").read().strip() code, out, _ = sh("curl -s -m 20 -H 'X-Api-Key: %s' http://192.168.1.118:7878/api/v3/movie" % key, 30) try: movies = json.loads(out) missing = [m for m in movies if not m.get("hasFile")] if missing: proposals.append({"action": "retry_search", "params": {}, "reason": "%d фильмов без файла" % len(missing), "level": "L3_domain_auto"}) except Exception: pass # 3. слепые зоны мониторинга code, out, _ = sh("curl -s -m 15 http://192.168.1.134:9090/api/v1/targets", 25) try: d = json.loads(out) down = [t for t in (d.get("data") or {}).get("activeTargets", []) if t.get("health") != "up"] for t in down: job = t.get("labels", {}).get("job") proposals.append({"action": "restart_exporter", "params": {}, "reason": "target down: %s" % job, "level": "L2_safe_auto"}) except Exception: pass return proposals def main(): cmd = sys.argv[1] if len(sys.argv) > 1 else "list" if cmd == "list": for a in REGISTRY.values(): print(" %-18s %-14s %s" % (a["id"], a["level"], a["desc"])) return 0 if cmd == "run": aid = sys.argv[2] params = {} for kv in sys.argv[3:]: k, _, v = kv.partition("=") params[k] = v print(json.dumps(run(aid, params), ensure_ascii=False, indent=1)) return 0 if cmd == "plan": p = plan() print("предложений:", len(p)) for x in p: print(" [%s] %-16s %s — %s" % (x["level"], x["action"], x["params"], x["reason"])) return 0 print(__doc__) return 1 if __name__ == "__main__": sys.exit(main())