Some checks failed
CI Pipeline / Rust Format Check (push) Failing after 6s
CI Pipeline / Clippy Lints (push) Successful in 1m13s
CI Pipeline / Rust Unit Tests (push) Successful in 1m17s
CI Pipeline / Security Audit (push) Successful in 32s
CI Pipeline / Frontend Lint & Type Check (push) Successful in 59s
CI Pipeline / Build .deb & Release (push) Has been skipped
1.9 KiB
1.9 KiB
WebSocket + Polling Fallback Implementation Plan
Problem
The linux-patch-api agent's /api/v1/ws/jobs endpoint was a stub that returned HTTP 101
with a JSON body but didn't compute the required Sec-WebSocket-Accept header. This
caused the pm-worker WS relay to fail with "Key mismatch in Sec-WebSocket-Accept header".
Additionally, the pm-worker WS relay's rustls ClientConfig didn't set ALPN to http/1.1, causing HTTP/2 negotiation which also breaks WebSocket upgrades.
Root Causes
- Agent WS handler was a stub — didn't implement RFC 6455 WebSocket handshake
- WS relay missing ALPN — rustls ClientConfig didn't set
alpn_protocolstohttp/1.1 - No fallback — WS relay had no fallback if WebSocket connection failed
Completed
- ALPN fix in pm-worker ws_relay.rs (forces HTTP/1.1 for WebSocket)
- Error chain logging in pm-worker ws_relay.rs (for future debugging)
- Job-level WS event_type fix (frontend + backend)
- Implement proper WebSocket in linux-patch-api using actix-web-actors
- Add WsJobActor with broadcast channel for real-time status updates
- Add HTTP polling fallback in pm-worker WS relay
- Deploy both binaries to dev LXC
- Push both projects to Gitea
- Fix config file (ws_relay_poll_interval_secs in [worker] section)
Deployment Notes
- linux-patch-api binary deployed to /usr/bin/linux-patch-api on dev LXC (VMID 131)
- pm-worker binary deployed to /usr/local/bin/pm-worker on dev LXC (VMID 131)
- Config file: /etc/patch-manager/config.toml (added ws_relay_poll_interval_secs = 10)
- Both services running: patch-manager-web, patch-manager-worker, linux-patch-api
Verified Working
- WebSocket connections to linux-patch-manager-dev (agent with proper WS handler)
- HTTP polling fallback to gitea-runner-u2404 (agent with stub WS)
- Job completion status updates via pg_notify
- Frontend real-time updates via WebSocket events