rpotter6298
512ebd13b2
- Introduced `protocol.py` for shared data models used in server/client communication, including request and response schemas for registration, job submission, and status updates. - Implemented `server.py` to manage a SQLite job queue and client registry, handling job polling, status updates, and job completion. - Created a cheat sheet for server usage, detailing commands for starting the server, submitting jobs, and monitoring clients. - Added several experiment configuration files for various training setups, including geometry vector injections and baseline ensembles.
408 lines
16 KiB
Python
408 lines
16 KiB
Python
"""
|
|
HyperTower distributed job client daemon.
|
|
|
|
Registers with the server, polls for jobs, syncs code, runs training,
|
|
uploads results, and loops. Parses stdout to stream live status.
|
|
|
|
Usage:
|
|
python -m v4.distributed.client \\
|
|
--server http://apollo:8765 \\
|
|
--token <secret> \\
|
|
--server-ssh rpotter@apollo \\
|
|
--server-path /home/rpotter/hypertower \\
|
|
[--local-path ~/hypertower] \\
|
|
[--poll-interval 15]
|
|
|
|
Compatibility test (verify GPU env, 1-fold dry-run):
|
|
python -m v4.distributed.client ... --test --config v4/configs/ensemble_fused.json
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
import os
|
|
import re
|
|
import shutil
|
|
import signal
|
|
import socket
|
|
import subprocess
|
|
import sys
|
|
import threading
|
|
import time
|
|
from pathlib import Path
|
|
from typing import Optional
|
|
|
|
import requests
|
|
|
|
from .protocol import (
|
|
JobResult,
|
|
JobSpec,
|
|
PollResponse,
|
|
RegisterRequest,
|
|
RegisterResponse,
|
|
StatusPush,
|
|
)
|
|
|
|
# ──────────────────────────────────────────────────────────────
|
|
# Server HTTP wrapper
|
|
# ──────────────────────────────────────────────────────────────
|
|
|
|
class _Server:
|
|
def __init__(self, base_url: str, token: str):
|
|
self.base_url = base_url.rstrip("/")
|
|
self._h = {"x-token": token}
|
|
self.client_id: str = ""
|
|
|
|
def _post(self, path: str, **kw) -> dict:
|
|
r = requests.post(f"{self.base_url}{path}", headers=self._h, timeout=15, **kw)
|
|
r.raise_for_status()
|
|
return r.json()
|
|
|
|
def register(self, hostname: str, gpu_info: str) -> str:
|
|
data = self._post("/register",
|
|
json={"hostname": hostname, "gpu_info": gpu_info})
|
|
self.client_id = data["client_id"]
|
|
self.hostname = hostname
|
|
self.gpu_info = gpu_info
|
|
return self.client_id
|
|
|
|
def _reregister(self):
|
|
try:
|
|
self._post("/register",
|
|
json={"hostname": self.hostname, "gpu_info": self.gpu_info},
|
|
params={"reuse_id": self.client_id})
|
|
except Exception:
|
|
pass
|
|
|
|
def poll(self) -> Optional[JobSpec]:
|
|
data = self._post("/poll", params={"client_id": self.client_id})
|
|
if data.get("please_reregister"):
|
|
self._reregister()
|
|
return JobSpec(**data["job"]) if data.get("job") else None
|
|
|
|
def push_status(self, status: StatusPush):
|
|
try:
|
|
r = requests.post(
|
|
f"{self.base_url}/status/{self.client_id}",
|
|
json=status.model_dump(),
|
|
headers=self._h,
|
|
timeout=5,
|
|
)
|
|
if r.ok and r.json().get("please_reregister"):
|
|
self._reregister()
|
|
except Exception:
|
|
pass # don't crash job on status push failure
|
|
|
|
def complete(self, job_id: str, success: bool, error_msg: Optional[str] = None):
|
|
self._post("/complete",
|
|
json={"job_id": job_id, "success": success, "error_msg": error_msg})
|
|
|
|
|
|
# ──────────────────────────────────────────────────────────────
|
|
# GPU info
|
|
# ──────────────────────────────────────────────────────────────
|
|
|
|
def _gpu_info() -> str:
|
|
# NVIDIA
|
|
try:
|
|
out = subprocess.check_output(
|
|
["nvidia-smi", "--query-gpu=name,memory.total", "--format=csv,noheader"],
|
|
text=True, stderr=subprocess.DEVNULL,
|
|
).strip()
|
|
if out:
|
|
return " | ".join(out.splitlines())
|
|
except Exception:
|
|
pass
|
|
# AMD
|
|
try:
|
|
out = subprocess.check_output(
|
|
["rocm-smi", "--showproductname", "--csv"],
|
|
text=True, stderr=subprocess.DEVNULL,
|
|
).strip().splitlines()
|
|
names = [l for l in out if l and not l.startswith("device")]
|
|
if names:
|
|
return "AMD: " + " | ".join(names)
|
|
except Exception:
|
|
pass
|
|
# AMD fallback
|
|
try:
|
|
out = subprocess.check_output(
|
|
["rocminfo"],
|
|
text=True, stderr=subprocess.DEVNULL,
|
|
)
|
|
names = [l.split(":", 1)[1].strip() for l in out.splitlines()
|
|
if "Marketing Name:" in l]
|
|
if names:
|
|
return "AMD: " + " | ".join(names)
|
|
except Exception:
|
|
pass
|
|
return "no-gpu"
|
|
|
|
|
|
# ──────────────────────────────────────────────────────────────
|
|
# rsync helpers
|
|
# ──────────────────────────────────────────────────────────────
|
|
|
|
def _rsync(src: str, dst: str, delete: bool = False):
|
|
cmd = ["rsync", "-az", "--info=progress2"]
|
|
if delete:
|
|
cmd.append("--delete")
|
|
cmd += [src, dst]
|
|
subprocess.run(cmd, check=True)
|
|
|
|
|
|
def _sync_code(server_ssh: str, server_path: str, local_path: str):
|
|
"""Pull v4/ source from server → local (overwrites local changes)."""
|
|
src = f"{server_ssh}:{server_path}/v4/"
|
|
dst = f"{local_path}/v4/"
|
|
Path(dst).mkdir(parents=True, exist_ok=True)
|
|
_rsync(src, dst, delete=True)
|
|
|
|
|
|
def _upload_results(server_ssh: str, server_path: str, local_path: str,
|
|
run_name: str, output_dir: str):
|
|
src = f"{local_path}/{output_dir}/{run_name}/"
|
|
dst = f"{server_ssh}:{server_path}/{output_dir}/{run_name}/"
|
|
remote_parent = f"{server_path}/{output_dir}/{Path(run_name).parent}"
|
|
subprocess.run(["ssh", server_ssh, f"mkdir -p '{remote_parent}'"], check=True)
|
|
_rsync(src, dst)
|
|
|
|
|
|
def _clean_local(local_path: str, run_name: str, output_dir: str):
|
|
target = Path(local_path) / output_dir / run_name
|
|
if target.exists():
|
|
shutil.rmtree(target)
|
|
print(f"[client] cleaned {target}", flush=True)
|
|
|
|
|
|
# ──────────────────────────────────────────────────────────────
|
|
# Stdout parsers (match v4_hypertower.py / fusion.py print format)
|
|
# ──────────────────────────────────────────────────────────────
|
|
|
|
# " fold2 [nt] ep004/036 [fused_warmup ] loss=0.4321 acc=0.876 val_auc=0.7654"
|
|
_EP_RE = re.compile(
|
|
r"fold(\d+)\s+\[([^\]]+)\]\s+ep(\d+)/(\d+).*?val_auc=([0-9.nan]+)",
|
|
re.IGNORECASE,
|
|
)
|
|
# "── fold 2/5 train_groups=..."
|
|
_FOLD_RE = re.compile(r"fold\s+(\d+)/\d+", re.IGNORECASE)
|
|
|
|
|
|
def _parse_line(line: str) -> dict:
|
|
"""Return any structured fields found in a stdout line."""
|
|
out = {}
|
|
m = _FOLD_RE.search(line)
|
|
if m:
|
|
out["fold"] = int(m.group(1))
|
|
m = _EP_RE.search(line)
|
|
if m:
|
|
out["fold"] = int(m.group(1))
|
|
out["stage"] = m.group(2)
|
|
out["epoch"] = int(m.group(3))
|
|
out["total_epochs"] = int(m.group(4))
|
|
try:
|
|
out["last_val_auc"] = float(m.group(5))
|
|
except ValueError:
|
|
pass
|
|
return out
|
|
|
|
|
|
# ──────────────────────────────────────────────────────────────
|
|
# Core job runner
|
|
# ──────────────────────────────────────────────────────────────
|
|
|
|
def _run_job(job: JobSpec, server: _Server,
|
|
server_ssh: str, server_path: str, local_path: str,
|
|
no_sync: bool = False,
|
|
extra_args: list[str] | None = None) -> bool:
|
|
extra_args = extra_args or []
|
|
# 1. Sync code
|
|
if no_sync:
|
|
print(f"[client] skipping sync (--no-sync)", flush=True)
|
|
else:
|
|
print(f"[client] syncing v4/ from server...", flush=True)
|
|
server.push_status(StatusPush(state="syncing", job_id=job.job_id, run_name=job.run_name))
|
|
_sync_code(server_ssh, server_path, local_path)
|
|
|
|
# 2. Launch training subprocess
|
|
cmd = [sys.executable, "-m", job.module] + job.args + extra_args
|
|
print(f"[client] running: {' '.join(cmd)}", flush=True)
|
|
server.push_status(StatusPush(state="running", job_id=job.job_id, run_name=job.run_name))
|
|
|
|
log_dir = Path(local_path) / "v4" / "distributed" / "logs"
|
|
log_dir.mkdir(parents=True, exist_ok=True)
|
|
log_file = log_dir / f"job_{job.job_id}.log"
|
|
ctx: dict = {}
|
|
|
|
def _tail(path: Path):
|
|
with open(path, "r") as f:
|
|
while True:
|
|
raw = f.readline()
|
|
if raw:
|
|
print(raw, end="", flush=True)
|
|
info = _parse_line(raw)
|
|
ctx.update(info)
|
|
if "epoch" in info:
|
|
server.push_status(StatusPush(
|
|
state="running",
|
|
job_id=job.job_id,
|
|
run_name=job.run_name,
|
|
fold=ctx.get("fold"),
|
|
stage=ctx.get("stage"),
|
|
epoch=ctx.get("epoch"),
|
|
total_epochs=ctx.get("total_epochs"),
|
|
last_val_auc=ctx.get("last_val_auc"),
|
|
))
|
|
elif proc.poll() is not None:
|
|
for raw in f:
|
|
print(raw, end="", flush=True)
|
|
break
|
|
else:
|
|
time.sleep(0.05)
|
|
|
|
with open(log_file, "w") as logf:
|
|
proc = subprocess.Popen(
|
|
cmd,
|
|
stdout=logf,
|
|
stderr=logf,
|
|
cwd=local_path,
|
|
start_new_session=True,
|
|
)
|
|
|
|
tailer = threading.Thread(target=_tail, args=(log_file,), daemon=True)
|
|
tailer.start()
|
|
proc.wait()
|
|
tailer.join(timeout=5)
|
|
log_file.unlink(missing_ok=True)
|
|
|
|
success = proc.returncode == 0
|
|
|
|
if not success:
|
|
try:
|
|
os.killpg(os.getpgid(proc.pid), signal.SIGKILL)
|
|
except ProcessLookupError:
|
|
pass
|
|
|
|
if not success:
|
|
print(f"[client] job FAILED (rc={proc.returncode})", flush=True)
|
|
return False
|
|
|
|
# 3. Upload results
|
|
if no_sync:
|
|
print(f"[client] skipping upload (--no-sync, results already local)", flush=True)
|
|
else:
|
|
print(f"[client] uploading results...", flush=True)
|
|
server.push_status(StatusPush(state="uploading", job_id=job.job_id, run_name=job.run_name))
|
|
_upload_results(server_ssh, server_path, local_path, job.run_name, job.output_dir)
|
|
_clean_local(local_path, job.run_name, job.output_dir)
|
|
|
|
print(f"[client] job {job.job_id} complete.", flush=True)
|
|
return True
|
|
|
|
|
|
# ──────────────────────────────────────────────────────────────
|
|
# Compatibility test
|
|
# ──────────────────────────────────────────────────────────────
|
|
|
|
def _compat_test(server: _Server, server_ssh: str, server_path: str,
|
|
local_path: str, config: str, extra_args: list[str],
|
|
no_sync: bool = False):
|
|
"""Run 1 fold to verify the env works end-to-end."""
|
|
print("[client] === compatibility test ===", flush=True)
|
|
job = JobSpec(
|
|
job_id="compat-test",
|
|
run_name="_compat_test",
|
|
module="v4.classes.v4_hypertower",
|
|
args=["--config", config, "--device", "cpu"] + extra_args,
|
|
output_dir="v4/results",
|
|
)
|
|
ok = _run_job(job, server, server_ssh, server_path, local_path,
|
|
no_sync=no_sync)
|
|
_clean_local(local_path, "_compat_test", "v4/results")
|
|
if ok:
|
|
print("[client] compatibility test PASSED ✓", flush=True)
|
|
else:
|
|
print("[client] compatibility test FAILED ✗", flush=True)
|
|
return ok
|
|
|
|
|
|
# ──────────────────────────────────────────────────────────────
|
|
# Main daemon
|
|
# ──────────────────────────────────────────────────────────────
|
|
|
|
def main():
|
|
ap = argparse.ArgumentParser(
|
|
description=__doc__,
|
|
formatter_class=argparse.RawDescriptionHelpFormatter,
|
|
)
|
|
ap.add_argument("--server", required=True,
|
|
help="Server URL, e.g. http://apollo:8765")
|
|
ap.add_argument("--token", default=os.environ.get("HT_TOKEN", ""),
|
|
help="Shared secret (or set HT_TOKEN env var)")
|
|
ap.add_argument("--server-ssh", required=True,
|
|
help="SSH target for rsync, e.g. rpotter@apollo")
|
|
ap.add_argument("--server-path", required=True,
|
|
help="Absolute path to hypertower root on server")
|
|
ap.add_argument("--local-path",
|
|
default=str(Path.home() / "hypertower"),
|
|
help="Absolute path to hypertower root on this machine")
|
|
ap.add_argument("--poll-interval", type=int, default=15,
|
|
help="Seconds to wait between polls when idle")
|
|
ap.add_argument("--extra-args", nargs=argparse.REMAINDER, default=[],
|
|
help="Extra args appended to every job on this client. "
|
|
"Use -- to separate: --extra-args -- --device cpu")
|
|
ap.add_argument("--no-sync", action="store_true",
|
|
help="Skip rsync of v4/ before each job (use when client IS the server)")
|
|
ap.add_argument("--test", action="store_true",
|
|
help="Run 1-fold compatibility test and exit")
|
|
ap.add_argument("--config", default="v4/configs/ensemble_fused.json",
|
|
help="Config path for --test mode")
|
|
args = ap.parse_args()
|
|
|
|
if not args.token:
|
|
ap.error("--token is required (or set HT_TOKEN)")
|
|
|
|
hostname = socket.gethostname()
|
|
gpu_info = _gpu_info()
|
|
server = _Server(args.server, args.token)
|
|
|
|
client_id = server.register(hostname, gpu_info)
|
|
print(f"[client] registered as {client_id} ({hostname} | {gpu_info})", flush=True)
|
|
|
|
if args.test:
|
|
extra = [a for a in args.extra_args if a != "--"]
|
|
sys.exit(0 if _compat_test(
|
|
server, args.server_ssh, args.server_path,
|
|
args.local_path, args.config, extra,
|
|
no_sync=args.no_sync,
|
|
) else 1)
|
|
|
|
print(f"[client] polling every {args.poll_interval}s...", flush=True)
|
|
while True:
|
|
try:
|
|
job = server.poll()
|
|
if job is None:
|
|
server.push_status(StatusPush(state="idle"))
|
|
time.sleep(args.poll_interval)
|
|
continue
|
|
|
|
success = _run_job(
|
|
job, server,
|
|
args.server_ssh, args.server_path, args.local_path,
|
|
no_sync=args.no_sync,
|
|
extra_args=[a for a in args.extra_args if a != "--"],
|
|
)
|
|
server.complete(job.job_id, success,
|
|
error_msg=None if success else "non-zero exit code")
|
|
server.push_status(StatusPush(state="idle"))
|
|
|
|
except KeyboardInterrupt:
|
|
print("\n[client] shutting down", flush=True)
|
|
break
|
|
except Exception as exc:
|
|
print(f"[client] error: {exc}", flush=True)
|
|
time.sleep(args.poll_interval)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|