219 lines
9.9 KiB
Bash
Executable file
219 lines
9.9 KiB
Bash
Executable file
#!/usr/bin/env bash
|
|
# demo-fleet.sh — one-command local mock of a vast.ai fleet, watchable live.
|
|
#
|
|
# Brings up, from a single command, a self-contained demo of the production
|
|
# topology with NO off-box collector: the orchestrator runs locally, hosts the
|
|
# FULL swactor dashboard, AND hosts the fleet view in-process. Each stage ships
|
|
# its telemetry over the datastream (identity + host.resource frames) to the
|
|
# orchestrator's in-process FleetView sink; the orchestrator's Fleet tab renders
|
|
# it beside its own live actor / topology / distribution views.
|
|
#
|
|
# - pp-orchestrator on the HOST in --seed mode (PP_DASHBOARD on), spawning N
|
|
# pp-worker containers (one per stage) via docker-gpu-node.sh, each on
|
|
# --network host, and serving the full dashboard at http://127.0.0.1:9095/.
|
|
# It binds a UDP datastream sink (PP_FLEET_SINK) and folds every stage's
|
|
# frames into the live Fleet table.
|
|
# - Each stage pp-worker emits its fleet frames (~every few seconds) to that
|
|
# sink, so the Fleet tab animates in real time.
|
|
# - PP_HOLD=1 keeps the cluster up after the first drive, so the stages keep
|
|
# streaming and the dashboard stays live for inspection.
|
|
#
|
|
# Ctrl+C (or any exit) tears everything down: stage containers, orchestrator,
|
|
# and all temp files.
|
|
#
|
|
# Usage:
|
|
# apps/pipeline-parallel-inference/scripts/demo-fleet.sh [N] # N stages, default 3, >= 2
|
|
#
|
|
# Environment overrides:
|
|
# PP_DIAG_IMAGE code image tag (default: swactor-pp-gpu:latest)
|
|
# PP_BASE_IMAGE base image tag (default: swactor-pp-base:cuda12.6)
|
|
# PP_SKIP_BUILD skip cargo build (reuse existing target/)
|
|
# PP_SKIP_IMAGE_BUILD skip docker image build (reuse existing tag)
|
|
# PP_GPUS attach GPUs to each stage (e.g. "all" or "device=0").
|
|
# Unset => CPU stub worker with real host metrics; the
|
|
# GPU gauges populate once a real GPU source is wired.
|
|
# PP_PROMPT inference prompt (default: "fleet demo")
|
|
# PP_MAX_TOKENS decode token cap (default: 4)
|
|
# PP_BIND_HOST dashboard + fleet-sink bind host (default: 127.0.0.1)
|
|
# PP_DASHBOARD_PORT orchestrator dashboard HTTP port (default: 9095)
|
|
# PP_FLEET_PORT orchestrator fleet UDP sink port (default: 9096)
|
|
# PP_NO_OPEN if set, don't try to open the dashboard in a browser
|
|
# PP_STAGE_NETWORK docker network for stages (default: host)
|
|
set -euo pipefail
|
|
|
|
NUM_STAGES="${1:-3}"
|
|
IMAGE="${PP_DIAG_IMAGE:-swactor-pp-gpu:latest}"
|
|
BASE_IMAGE="${PP_BASE_IMAGE:-swactor-pp-base:cuda12.6}"
|
|
PROMPT="${PP_PROMPT:-fleet demo}"
|
|
MAX_TOKENS="${PP_MAX_TOKENS:-4}"
|
|
BIND_HOST="${PP_BIND_HOST:-127.0.0.1}"
|
|
DASH_PORT="${PP_DASHBOARD_PORT:-9095}"
|
|
FLEET_PORT="${PP_FLEET_PORT:-9096}"
|
|
CONTAINER_PREFIX="demo-fleet-stage"
|
|
RUN_ID="demo-fleet-$(date +%s)"
|
|
# The full swactor dashboard — including the in-process Fleet tab — is served by
|
|
# the orchestrator at "/".
|
|
DASH_URL="http://${BIND_HOST}:${DASH_PORT}/"
|
|
|
|
if ! [[ "$NUM_STAGES" =~ ^[0-9]+$ ]] || [ "$NUM_STAGES" -lt 2 ]; then
|
|
echo "demo-fleet: N must be an integer >= 2 (seed mode needs >=2 stages), got '$NUM_STAGES'" >&2
|
|
exit 2
|
|
fi
|
|
if ! command -v docker >/dev/null 2>&1; then
|
|
echo "demo-fleet: docker not on PATH" >&2; exit 2
|
|
fi
|
|
if ! docker info >/dev/null 2>&1; then
|
|
echo "demo-fleet: docker daemon unreachable" >&2; exit 2
|
|
fi
|
|
# Fail loudly on a clash for the orchestrator dashboard port. Its HTTP server is
|
|
# spawned on the driver's tokio runtime and `.expect()`s its bind; a collision
|
|
# panics that task silently and the run carries on with no dashboard. Catch it
|
|
# here so the user can pick a free one.
|
|
if (exec 3<>"/dev/tcp/${BIND_HOST}/${DASH_PORT}") 2>/dev/null; then
|
|
exec 3>&- 3<&-
|
|
echo "demo-fleet: dashboard port ${DASH_PORT} is already in use." \
|
|
"Pick a free one: PP_DASHBOARD_PORT=9097 $0 ${NUM_STAGES}" >&2
|
|
exit 2
|
|
fi
|
|
|
|
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
|
CRATE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
|
|
WORKSPACE_DIR="$(cd "$CRATE_DIR/../.." && pwd)"
|
|
|
|
ORCHESTRATOR_BIN="$CRATE_DIR/target/release/pp-orchestrator"
|
|
WORKER_BIN="$CRATE_DIR/target/release/pp-worker"
|
|
WORKER_PY="$CRATE_DIR/pp_tinygrad_worker.py"
|
|
|
|
# ── Step 1: build release artifacts ───────────────────────────────────────
|
|
if [ -z "${PP_SKIP_BUILD:-}" ]; then
|
|
echo "demo-fleet: cargo build pp-orchestrator + pp-worker (release)"
|
|
cargo build --manifest-path "$CRATE_DIR/Cargo.toml" --release \
|
|
--bin pp-worker --bin pp-orchestrator
|
|
fi
|
|
for f in "$ORCHESTRATOR_BIN" "$WORKER_BIN" "$WORKER_PY"; do
|
|
[ -f "$f" ] || { echo "demo-fleet: missing $f (run without PP_SKIP_BUILD)" >&2; exit 1; }
|
|
done
|
|
|
|
# ── Step 2: build the layered image (heavy base, thin code layer) ──────────
|
|
if [ -z "${PP_SKIP_IMAGE_BUILD:-}" ]; then
|
|
echo "demo-fleet: docker build $BASE_IMAGE (base)"
|
|
docker build -f "$CRATE_DIR/Dockerfile.base" -t "$BASE_IMAGE" "$WORKSPACE_DIR"
|
|
echo "demo-fleet: docker build $IMAGE (code)"
|
|
docker build -f "$CRATE_DIR/Dockerfile" --build-arg "BASE_IMAGE=$BASE_IMAGE" \
|
|
-t "$IMAGE" "$WORKSPACE_DIR"
|
|
fi
|
|
|
|
# ── Working dirs + FIFO that keeps the orchestrator's stdin open ───────────
|
|
WORKDIR="$(mktemp -d -t demo-fleet.XXXXXX)"
|
|
ORCH_LOG="$WORKDIR/orch.log"
|
|
FIFO="$WORKDIR/orch.stdin"
|
|
mkfifo "$FIFO"
|
|
|
|
ORCH_PID=""
|
|
CLEANED=""
|
|
|
|
cleanup() {
|
|
[ -n "$CLEANED" ] && return 0
|
|
CLEANED=1
|
|
set +e
|
|
echo
|
|
echo "demo-fleet: tearing down…"
|
|
# Stage containers first so the orchestrator's iroh peers vanish cleanly.
|
|
local ids
|
|
ids=$(docker ps -aq --filter "name=^${CONTAINER_PREFIX}-[0-9]+$")
|
|
if [ -n "$ids" ]; then
|
|
# shellcheck disable=SC2086
|
|
docker rm -f $ids >/dev/null 2>&1
|
|
fi
|
|
[ -n "$ORCH_PID" ] && kill "$ORCH_PID" >/dev/null 2>&1
|
|
# Release the write end of the FIFO and remove the work tree.
|
|
exec 3>&- 2>/dev/null
|
|
[ -d "$WORKDIR" ] && rm -rf "$WORKDIR"
|
|
set -e
|
|
echo "demo-fleet: done."
|
|
}
|
|
# Cleanup runs once, on any exit. INT/TERM just trigger an exit so the single
|
|
# EXIT handler does the teardown (avoids double-running the logic).
|
|
trap cleanup EXIT
|
|
trap 'exit 130' INT TERM
|
|
|
|
# ── Step 3: orchestrator (hosts the full dashboard + fleet, holds cluster) ─
|
|
# stdin is the FIFO; we hold its write end open on fd 3 so hold_open() never
|
|
# sees EOF and the cluster stays up until we tear down.
|
|
exec 3<>"$FIFO"
|
|
echo "demo-fleet: launching orchestrator + ${NUM_STAGES} stage containers (run_id=$RUN_ID)"
|
|
# The orchestrator (and, via inheritance, docker-gpu-node.sh) read these from
|
|
# the environment. PP_HOLD keeps the cluster up; PP_DASHBOARD makes the
|
|
# orchestrator host the full swactor dashboard locally; PP_FLEET_SINK is the
|
|
# UDP address the orchestrator binds for its in-process FleetView and that each
|
|
# stage ships its datastream frames to (reachable from the --network host stage
|
|
# containers via the shared loopback).
|
|
export PP_HOLD=1
|
|
export PP_WORKER_STUB=1
|
|
export PP_DEV=CPU
|
|
export PP_IMAGE="$IMAGE"
|
|
export PP_CONTAINER_PREFIX="$CONTAINER_PREFIX"
|
|
export PP_DASHBOARD=1
|
|
export PP_DASHBOARD_PORT="$DASH_PORT"
|
|
export PP_FLEET_SINK="${BIND_HOST}:${FLEET_PORT}"
|
|
[ -n "${PP_GPUS:-}" ] && export PP_GPUS
|
|
[ -n "${PP_STAGE_NETWORK:-}" ] && export PP_STAGE_NETWORK
|
|
"$ORCHESTRATOR_BIN" \
|
|
--seed \
|
|
--num-stages "$NUM_STAGES" \
|
|
--gpu-node "$SCRIPT_DIR/docker-gpu-node.sh" \
|
|
--worker "$WORKER_PY" \
|
|
--prompt "$PROMPT" \
|
|
--max-tokens "$MAX_TOKENS" \
|
|
<"$FIFO" >"$ORCH_LOG" 2>&1 &
|
|
ORCH_PID=$!
|
|
|
|
# ── Step 4: wait for the orchestrator's dashboard to bind, then announce + open
|
|
WAITED=0
|
|
until (echo > "/dev/tcp/${BIND_HOST}/${DASH_PORT}") >/dev/null 2>&1; do
|
|
if ! kill -0 "$ORCH_PID" >/dev/null 2>&1; then
|
|
echo "demo-fleet: orchestrator exited before its dashboard came up." >&2
|
|
tail -n 40 "$ORCH_LOG" >&2 || true
|
|
exit 1
|
|
fi
|
|
WAITED=$((WAITED + 1))
|
|
[ "$WAITED" -ge 30 ] && { echo "demo-fleet: orchestrator dashboard did not bind :${DASH_PORT} in 30s" >&2; tail -n 40 "$ORCH_LOG" >&2; exit 1; }
|
|
sleep 1
|
|
done
|
|
echo
|
|
echo " ┌─────────────────────────────────────────────────────────────┐"
|
|
echo " │ Full swactor dashboard: $DASH_URL"
|
|
echo " │ (overview / actors / topology / distribution / netmap / fleet)"
|
|
echo " │ Fleet datastream sink: ${BIND_HOST}:${FLEET_PORT} (UDP, in-process)"
|
|
echo " └─────────────────────────────────────────────────────────────┘"
|
|
echo
|
|
if [ -z "${PP_NO_OPEN:-}" ]; then
|
|
if command -v xdg-open >/dev/null 2>&1; then (xdg-open "$DASH_URL" >/dev/null 2>&1 &) || true
|
|
elif command -v open >/dev/null 2>&1; then (open "$DASH_URL" >/dev/null 2>&1 &) || true
|
|
fi
|
|
fi
|
|
|
|
# ── Step 5: wait until the cluster is converged + held open ────────────────
|
|
echo "demo-fleet: waiting for the cluster to converge (first inference drive)…"
|
|
WAITED=0
|
|
until grep -q "holding cluster open" "$ORCH_LOG" 2>/dev/null; do
|
|
if ! kill -0 "$ORCH_PID" >/dev/null 2>&1; then
|
|
echo "demo-fleet: orchestrator exited before holding — drive failed." >&2
|
|
echo "----- orchestrator log (last 40) -----" >&2
|
|
tail -n 40 "$ORCH_LOG" >&2 || true
|
|
exit 1
|
|
fi
|
|
WAITED=$((WAITED + 1))
|
|
[ "$WAITED" -ge 180 ] && { echo "demo-fleet: cluster did not converge within 180s" >&2; tail -n 40 "$ORCH_LOG" >&2; exit 1; }
|
|
sleep 1
|
|
done
|
|
|
|
RUNNING=$(docker ps -q --filter "name=^${CONTAINER_PREFIX}-[0-9]+$" | wc -l | tr -d ' ')
|
|
echo
|
|
echo "demo-fleet: ✅ fleet up — ${RUNNING}/${NUM_STAGES} stage containers streaming real metrics."
|
|
echo "demo-fleet: watch live at $DASH_URL"
|
|
echo "demo-fleet: press Ctrl+C to tear everything down."
|
|
echo
|
|
|
|
# Block in the foreground until the orchestrator exits or Ctrl+C fires the trap.
|
|
wait "$ORCH_PID"
|