Spie delle fonti
Ogni fonte ha una spia, ricalcolata ogni secondo: è verde se l'ultima lettura buona è più recente di tre volte la sua frequenza.
Servizio · Rust · un solo binario
Il servizio che sta tra Stratum Hub, Azure DevOps e il browser della City. Legge le fonti, compone un solo stato e lo manda in streaming. Non conserva dati propri.
Scorri
Il browser non parla mai direttamente con l'hub né con Azure DevOps: ogni fonte passa dal relay, che tiene in memoria solo l'ultima lettura di ciascuna.
Flusso
Il relay segue gli eventi dell'hub con
stratum-edge subscribe. Dopo un evento che tocca il board lo rilegge entro mezzo secondo, e
comunque ogni 30 secondi.
Legge code, run, timeline e push solo in lettura, mai i log. Le frequenze sono tarate sui limiti di Azure DevOps: a riposo circa 2-3 unità di costo ogni 5 minuti, su 200 disponibili.
Compone tutto in un solo stato della città, insieme ai pulse, gli eventi istantanei che la City racconta con un'animazione.
Lo stato parte al massimo due volte al secondo per client, i pulse subito, un battito ogni 15 secondi. Un client lento può perdere un pulse, mai lo stato.
Il browser riceve lo stream e disegna la città. Se lo stream tace per 45 secondi si ricollega, aspettando da 1 a 30 secondi tra un tentativo e l'altro.
Fonti
| Fonte | frequenza |
|---|---|
| Board dell'hub, dopo un evento | 0,5 s |
| Board dell'hub, senza eventi | 30 s |
| Metriche dell'hub | 5 s |
| Eventi di recall | 30 s |
| Code delle pipeline | 15 s |
| Run attive | 30 s |
| Push sui repository attivi | 30 s |
| Worktree git locali | 60 s |
Ogni fonte ha una spia, ricalcolata ogni secondo: è verde se l'ultima lettura buona è più recente di tre volte la sua frequenza.
La timeline di una run finita si legge una volta sola. Le run finite restano visibili 30 minuti, con il primo errore in chiaro.
Sicurezza
Il relay ascolta solo sull'indirizzo locale della macchina e si rifiuta di partire su un indirizzo raggiungibile dalla rete.
Rispondere a una domanda o mettere a dormire una sessione richiede Host e Origin locali e un token da 128 bit, nuovo a ogni avvio del relay.
Per Azure DevOps usa un file di credenziali accanto alla
configurazione, oppure il login della CLI az. Se il file è leggibile da altri utenti, lo
segnala.
Glossario
Da sapere
Il modulo per avviare una sessione dalla City esiste, ma il relay non lo esegue ancora.
Il relay serve la vista privata dell'azienda; quelle per i clienti e per il pubblico sono previste ma non ci sono.
Gira sulla macchina dell'hub e serve chi è lì; un modo sicuro per raggiungerlo da fuori non c'è ancora.