#!/bin/bash # ============================================================================= # Engineering-hardened startup sequence for Headless Container Orchestration. # # Solves three classes of platform-induced failures: # 1. Startup Timeout -> Health-check fast-ack via socat on :7860 # 2. CPU Throttling -> nice -n 19 on all GUI processes # 3. OOM Kill Pressure -> oom_score_adj = -1000 on supervisor # ============================================================================= set -u # ----------------------------------------------------------------------------- # Kernel scheduling priority for the supervisor itself. # Lower priority = less likely to be flagged by the scheduler's throttling # heuristics in shared-tenant environments. # ----------------------------------------------------------------------------- renice -n 19 -p $$ >/dev/null 2>&1 || true # ----------------------------------------------------------------------------- # OOM hardening — if the host kernel allows it, mark the supervisor as # "do-not-kill" so transient memory pressure triggers reclaim rather than an # instant SIGKILL of our PID 1. # ----------------------------------------------------------------------------- echo -1000 > /proc/$$/oom_score_adj 2>/dev/null || true export DISPLAY=:99 export HOME=/home/user export USER=user cd "$HOME" echo "[boot] $(date -u +%FT%TZ) supervisor pid=$$" # ----------------------------------------------------------------------------- # (1) Health-Check Bypass Layer. # # HF Spaces' scheduler probes :7860 very early. If Xvnc + websockify haven't # finished initializing, the probe fails and the container is recycled. # # We satisfy the probe immediately with a socat-backed HTTP responder that # answers any TCP connect with a valid `HTTP/1.1 200 OK` payload. As soon as # the real graphics stack is up, we kill socat and hand the port over to # websockify. # ----------------------------------------------------------------------------- socat TCP-LISTEN:7860,fork,reuseaddr,bind=0.0.0.0 \ SYSTEM:'printf "HTTP/1.1 200 OK\r\nContent-Length: 2\r\nConnection: close\r\n\r\nOK"' \ >/dev/null 2>&1 & SOCAT_PID=$! echo "[boot] socat health-ack listening on :7860 (pid=$SOCAT_PID)" # ----------------------------------------------------------------------------- # (2) Graphics core — TigerVNC's Xvnc. # # Xvnc IS the X server AND the VNC server in one process. This removes the # Xvfb + x11vnc double-buffer pipeline (~50% fewer context switches, less RAM). # # Re-exec'd as `xcore` for clean log identification. # ----------------------------------------------------------------------------- rm -f /tmp/.X99-lock /tmp/.X11-unix/X99 2>/dev/null || true ( exec -a xcore nice -n 19 \ Xvnc :99 \ -geometry 1280x800 \ -depth 24 \ -SecurityTypes None \ -localhost=0 \ -rfbport 5900 \ -AlwaysShared \ -AcceptKeyEvents \ -AcceptPointerEvents \ -DisconnectClients=0 \ -NeverShared=0 \ ) >/tmp/xcore.log 2>&1 & XCORE_PID=$! echo "[boot] xcore (Xvnc) starting pid=$XCORE_PID" # Wait for the X server to publish its socket — bounded busy-wait, not a blind sleep. for i in $(seq 1 30); do if [ -e /tmp/.X11-unix/X99 ]; then echo "[boot] X11 socket ready after ${i}s" break fi sleep 1 done # ----------------------------------------------------------------------------- # (3) Window manager — fluxbox under low scheduling priority. # ----------------------------------------------------------------------------- nice -n 19 fluxbox >/tmp/fluxbox.log 2>&1 & FLUX_PID=$! echo "[boot] fluxbox started pid=$FLUX_PID" sleep 1 # Give the graphics stack a brief settle window before we flip the port over. sleep 2 # ----------------------------------------------------------------------------- # (4) Hand over port 7860 from the socat fast-ack to the real service. # ----------------------------------------------------------------------------- kill "$SOCAT_PID" 2>/dev/null || true # Wait for the kernel to actually release the listening socket. for i in $(seq 1 10); do if ! ss -ltn 2>/dev/null | grep -q ':7860 '; then break fi sleep 0.3 done echo "[boot] socat handed off; launching websocket bridge" # ----------------------------------------------------------------------------- # (5) websockify — final user-facing service on :7860. # # Serves the noVNC web client and tunnels WebSocket frames into VNC TCP frames # against the local Xvnc. Re-exec'd as `wproxy` for log clarity, slightly # higher CPU priority (nice -n 10) since it sits on the hot path. # ----------------------------------------------------------------------------- ( exec -a wproxy nice -n 10 \ websockify \ --web=/novnc \ --heartbeat=30 \ 0.0.0.0:7860 localhost:5900 \ ) >/tmp/wproxy.log 2>&1 & WPROXY_PID=$! echo "[boot] wproxy (websockify) pid=$WPROXY_PID" # ----------------------------------------------------------------------------- # Supervisor loop — keep PID 1 alive while any critical child is running. # If xcore or wproxy dies, exit so the platform can recycle the container. # ----------------------------------------------------------------------------- echo "[boot] all services up — entering supervisor loop" while true; do if ! kill -0 "$XCORE_PID" 2>/dev/null; then echo "[boot] xcore exited — tearing down" exit 1 fi if ! kill -0 "$WPROXY_PID" 2>/dev/null; then echo "[boot] wproxy exited — tearing down" exit 1 fi sleep 5 done