Servizio · Rust · un solo binario

City relay

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

Dalle fonti alla City

  1. 1

    L'hub

    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.

  2. 2

    Azure DevOps

    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.

  3. 3

    Uno stato

    Compone tutto in un solo stato della città, insieme ai pulse, gli eventi istantanei che la City racconta con un'animazione.

  4. 4

    Streaming

    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.

  5. 5

    La City

    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

Cosa legge, e ogni quanto

Fontefrequenza
Board dell'hub, dopo un evento0,5 s
Board dell'hub, senza eventi30 s
Metriche dell'hub5 s
Eventi di recall30 s
Code delle pipeline15 s
Run attive30 s
Push sui repository attivi30 s
Worktree git locali60 s

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.

Run e push

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

Solo dalla macchina locale

Solo loopback

Il relay ascolta solo sull'indirizzo locale della macchina e si rifiuta di partire su un indirizzo raggiungibile dalla rete.

Azioni con token

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.

Credenziali

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

Le parole del relay

Stato della città
Tutto ciò che la City disegna, composto dal relay a partire dalle fonti.
Pulse
Un evento istantaneo, come un messaggio inviato o un push; da solo non cambia lo stato.
Board
Lo stato vivo dell'hub: sessioni, lane, task, prenotazioni.
Spia
L'indicatore di salute di una fonte.
Land
Un push sul ramo principale fatto da una persona o da una sessione, mai da una pipeline.
SSE
Server-Sent Events: una connessione HTTP che resta aperta e porta gli eventi man mano.

Da sapere

Cosa non fa ancora

Avvio dalla City

Il modulo per avviare una sessione dalla City esiste, ma il relay non lo esegue ancora.

Una sola vista

Il relay serve la vista privata dell'azienda; quelle per i clienti e per il pubblico sono previste ma non ci sono.

Locale

Gira sulla macchina dell'hub e serve chi è lì; un modo sicuro per raggiungerlo da fuori non c'è ancora.