Un PaaS minimalista per applicazioni native GraalVM e Python

Gluonify è un PaaS minimalista. Distribuisce applicazioni native GraalVM (Quarkus, Spring Boot, Micronaut, Helidon…) e applicazioni Python (FastAPI) su nodi Debian 13 senza amministrazione: un token, una zona DNS delegata e il cluster si avvia da solo. WebSocket è il trasporto standard tra i componenti; lo stato del cluster è replicato con Raft. I componenti di Gluonify sono a loro volta applicazioni Quarkus 4 native.

Componenti

Ogni componente ha il proprio repository; i nomi seguono le particelle del modello standard.

Higgs — Orchestratore

Orchestratore: API di distribuzione, scheduler, ingress TLS, DNS autoritativo, ACME, stato Raft, avvio dello stack, lock dei file, token da applicazione a servizio.

Il bosone di Higgs è l'eccitazione del campo di Higgs, il campo che dà massa alle altre particelle elementari. È stato osservato al CERN nel 2012.

Higgs, l'orchestratore, è il campo su cui poggia tutto il resto: dà a ogni applicazione il suo posto e il suo peso nel cluster.

Strange — Agente di nodo

Agente di nodo: esegue le applicazioni come unità systemd isolate, rete, gateway /distributed/*, relay dei lock. Un'applicazione può essere un eseguibile semplice o un archivio .tar.gz (eseguibile, librerie, pacchetti di sistema per distribuzione che l'agente installa). Deposita in un file di sola lettura di ogni istanza i token da applicazione a servizio e li rinnova.

Il quark strange (s) è un quark di seconda generazione, con carica elettrica −1/3. Il gluone è il bosone dell'interazione forte: lega i quark tra loro.

L'agente lega ogni applicazione al suo nodo, come i gluoni legano i quark.

Rup — Storage

Nodi di storage: oggetti indirizzati per SHA-256, file replicati, quote.

Il quark up (u) è il più leggero dei quark, con carica +2/3. Un protone ne contiene due; questo è quello rosso.

Lo storage è uno dei due quark up del protone: una fondazione su cui poggiano gli altri componenti.

Bottom — Demone FUSE (C)

Demone FUSE in C (libfuse3): lock dei file tra nodi.

Il quark bottom (b) è un quark di terza generazione, con carica −1/3, cugino più pesante del quark down (osservato nel 1977).

Lo strato basso del file system: il demone sotto i mount /distributed/*.

gDown — Database a grafo

Database a grafo replicato (Raft): charm, top, metadati; openCypher e Bolt; le applicazioni raggiungono il proprio database via Bolt su TLS (Bolt + OGM supportati).

Il quark down (d) ha carica −1/3. Un protone ne contiene uno, insieme a due quark up; questo è quello verde.

Il database a grafo è il quark più grande del logo: la memoria su cui poggia la piattaforma.

Vuole saperne di più?

Top — Config e segreti

Top: configurazione e segreti per applicazione, interfaccia web Vue.

Il quark top (t) è la particella elementare conosciuta più pesante (circa 173 GeV/c²), con carica +2/3.

Top custodisce la cosa più pesante che una piattaforma contiene: i segreti.

Charm — Provider di identità

Emittente di token JWT di breve durata (ES256) e provider OIDC minimale.

Il quark charm (c) è un quark di seconda generazione, con carica +2/3, osservato nel 1974.

Il provider di identità dà a ogni programma il «fascino» di breve durata che lo fa riconoscere.

Bup — Builder

Builder: clone Git, build nativa, pubblicazione, distribuzione. Quando la build nativa produce librerie, l'applicazione viene pubblicata come archivio .tar.gz (eseguibile, librerie, dipendenze di sistema per distribuzione). Il repository Maven di Sea, dove è pubblicato l'SDK della piattaforma, è aggiunto alle sue compilazioni Maven e Gradle, oltre a Maven Central: un'applicazione cliente che dipende dall'SDK si compila senza alcuna impostazione. Trasmette all'orchestratore i servizi dichiarati dall'applicazione (uses, database gDown dedicato).

Il secondo quark up del protone; questo è quello blu. I tre quark di un protone portano tre colori diversi che si annullano.

Il builder trasforma il suo codice nell'artefatto che viene distribuito.

Photon — Gateway API

Gateway API ed elaborazione dei messaggi. Instradamento per dominio e percorso, certificati per dominio, politiche (indirizzi, CORS, token charm, limiti di frequenza) ed esposizione di gDown sono in Higgs, l'orchestratore; questo componente gestisce i webhook firmati, le trasformazioni JSON/XML/modulo/ProtoBuf, una coda persistente e la consegna con nuovi tentativi, su più repliche.

Il fotone (γ) è il bosone senza massa dell'elettromagnetismo: trasporta la luce e, con essa, l'informazione.

Il gateway API è la porta d'ingresso da cui la luce del mondo esterno, le sue richieste, entra nel cloud.

Field — Server di contenuti statici

Server di contenuti statici: i siti si depositano come ZIP e sono serviti da /distributed/std/<uuid>/ ; il sito è scelto da un'intestazione firmata impostata dall'ingress, mai dal client.

Un campo quantistico è una grandezza definita in ogni punto dello spazio; le particelle sono le sue eccitazioni.

Il contenuto statico, la materia, è reso disponibile ovunque nella rete da questa applicazione.

Gauge — Pilota per IA (MCP)

Server MCP: permette a un assistente IA di distribuire, configurare e leggere i log delle applicazioni tramite l'API della piattaforma. Token charm per applicazione con ruoli limitati, regole definite dal cliente, approvazione umana per la produzione, audit di ogni azione. Uno strumento usage di sola lettura riporta memoria e CPU delle applicazioni e dei componenti della piattaforma (un'istantanea, mai una base di fatturazione).

I bosoni di gauge sono le particelle mediatrici delle forze fondamentali. Sono la manifestazione concreta delle simmetrie di gauge, che definiscono come le particelle di materia interagiscono tra loro.

L'interfaccia porta una forza: permette all'IA di agire sul cluster, ma quell'azione è filtrata e autorizzata dalla «legge di gauge» stabilita dal cliente (la configurazione MCP), come un bosone di gauge è vincolato dalla simmetria che lo definisce.

Calorimeter — Osservabilità

Osservabilità: conserva i log e le metriche di ogni applicazione oltre la vita di un nodo, con una dashboard per applicazione e avvisi. Si appoggia su ciò che Higgs e Strange già espongono: journal, /q/metrics e scoperta Prometheus su /metrics/sd.

Un calorimetro è un rivelatore di particelle che misura l'energia assorbendo le particelle strato dopo strato: l'energia che vi depositano rivela ciò che è passato.

L'attività di ogni applicazione deposita la sua energia nel calorimetro sotto forma di log e misure: lo assorbe, lo registra e lascia leggere ciò che è successo.

Synchrotron — Console di amministrazione

Console di amministrazione: un servizio Quarkus nativo che serve un'interfaccia Vue 3. Convalida il token di Charm e inoltra ogni chiamata alle API della piattaforma (Higgs, Top, Charm, Photon, Bup) con il token di chi chiama, tramite una lista di consentiti: non eleva mai i privilegi.

Un sincrotrone è un acceleratore circolare di particelle: dei magneti curvano il fascio mentre un campo elettrico gli aggiunge energia a ogni giro, fino all'energia voluta.

Come la sala di controllo di un acceleratore, la console permette all'operatore di iniettare energia nella piattaforma (distribuire, scalare, risvegliare) e di osservare il fascio, senza mai superare i diritti di chi la usa.

Sea — Deposito delle release

Deposito delle release (images.gluonify.io): serve i binari nativi firmati che install.sh e Strange scaricano. File indirizzati dal contenuto, release immutabili; la firma Ed25519 del manifesto, verificata dal client, è la radice di fiducia, e una versione non può mai tornare indietro (numero di sequenza). Serve anche il repository Maven della piattaforma (/maven/): lettura pubblica, pubblicazione riservata all'editore della piattaforma, versioni pubblicate immutabili. L'SDK Java per le applicazioni dei clienti vi è pubblicato, e il builder aggiunge questo repository alle sue compilazioni.

In un protone, oltre ai tre quark di valenza, un « mare » di coppie virtuali quark–antiquark e di gluoni appare e scompare di continuo: è gran parte di ciò di cui il protone è fatto.

Il mare circonda i quark che formano il protone; qui il deposito circonda la piattaforma con i binari di cui è fatta, e ogni nodo vi attinge ciò che installa.

Fermion — Motore di workflow e regole

Motore di workflow e regole: workflow BPMN 2 e tabelle decisionali DMN, conservati in Git (Bitbucket, GitLab) ed eseguiti lato server. Le applicazioni si collegano come nodi con un WebSocket permanente (il protocollo e un client sono nell'SDK di plasma), annunciano le proprie competenze ed eseguono solo compiti atomici; Fermion distribuisce i passi, gestisce tentativi, timer e interruttori, e riprende un'esecuzione fallita dall'ultimo passo. Stato e storico sono in gDown; le chiamate sono autenticate con token Charm; interfaccia web Vue in cinque lingue. Per ora una sola replica attiva. L'invio dei messaggi (e-mail, Teams, posta) è affidato a Interfero, un nodo come gli altri.

Un fermione è una particella con spin semintero che obbedisce al principio di esclusione di Pauli: due fermioni identici non possono occupare lo stesso stato quantistico. I quark e gli elettroni sono fermioni.

Un motore di workflow e regole vive della stessa costrizione: in ogni istante un'istanza occupa un solo passo, un compito è affidato a un solo nodo, una decisione dà una risposta deterministica per un dato payload. Da qui il rigore del motore.

Crystallon — Conversione e generazione di documenti

Servizio di documenti: trasforma un documento dinamico in uno fisso, autonomo e archiviabile, e ne genera di nuovi. Conversione: le immagini (BMP, JPEG, PNG, TIFF, WebP) diventano PNG; i PDF diventano PDF/A-1B (font e profilo colore incorporati, metadati XMP) e più PDF possono essere uniti in uno; non si conserva nulla. Generazione: un PDF è prodotto a partire da un modello JSON e da dati JSON (modelli predefiniti fattura, preventivo e lettera, QR-bill svizzero con validazione rigorosa, PDF/A-1B su richiesta). I modelli sono conservati per organizzazione in un database gDown dedicato, con versioni, cronologia e ripristino, insieme ai loro loghi e alle loro immagini (le immagini SVG sono disegnate in vettoriale); un'applicazione genera un modello tramite il suo nome, o a una versione precisa, e ogni errore di validazione indica dove si trova nel modello. Un editor grafico nell'interfaccia web (inglese, francese, spagnolo, italiano e tedesco, tema chiaro e scuro) imposta la pagina: blocchi aggiunti e spostati con il trascinamento, testo in segmenti con stile, colonne, font Inter e Helvetica, anteprima PDF in tempo reale con dati di esempio. Ogni organizzazione può inoltre caricare i propri font TrueType (licenza verificata, conferma dei diritti obbligatoria, quattro varianti per famiglia, quote): i modelli li usano come quelli del motore e vengono incorporati nel PDF/A-1B. La sua scheda Codice dà a un'applicazione ciò che le serve: lo schema dei dati che il modello legge (JSON Schema) e codice Java generato, record e una facciata costruiti sull'SDK Java, distribuito dal repository Maven di Sea. L'accesso avviene con un token Charm (audience gluonify-crystallon), con un ruolo per compito: render per generare documenti, convert per convertirli, templates per gestirli. Un'applicazione che dichiara crystallon in uses riceve dalla piattaforma un token render di breve durata, rinnovato senza riavvio; anche una persona connessa può inoltrare il proprio. I segreti dei fornitori di pagamento sono letti dal deposito Top. La conversione delle immagini AVIF e HEIC usa strumenti esterni (avifdec, heif-convert) che devono essere installati sul nodo; senza di essi il servizio risponde 503. Viene consegnato come archivio di applicazione con le sue librerie.

Un cristallo è un solido i cui atomi occupano un reticolo regolare, ripetuto in ogni direzione: un liquido che si raffredda si fissa in quest'ordine.

Il servizio fa lo stesso con un documento: una foto, un PDF prodotto da qualsiasi strumento o più PDF da assemblare vengono fissati in un formato stabile che non dipende da alcun lettore.

Interfero — Invio di messaggi

Invio di messaggi: un'API REST nativa (Quarkus, token Charm, stato in gDown) che riunisce la posta elettronica (SMTP), Teams (webhook Workflows), sei app di messaggistica (WhatsApp Business tramite la Cloud API di Meta con modelli approvati, Telegram, Slack, Discord, LINE, Viber; credenziali per organizzazione in Top, solo host ufficiali) e la posta cartacea (PDF prodotto da Crystallon e consegnato a un fornitore postale; per ora esiste solo un fornitore di deposito, nessun corriere reale) dietro un'unica interfaccia. È un nodo di Fermion che annuncia SEND_MSG_EMAIL, SEND_MSG_TEAMS e SEND_MSG_POST, e conserva i modelli dei messaggi (versioni, anteprima, registro degli invii); la vista Templates è in Fermion. Le sue chiamate a Crystallon e a Fermion usano i token di applicazione forniti dalla piattaforma, senza configurare nulla.

Un interferometro sovrappone onde provenienti da più sorgenti e legge la figura che formano insieme, cosa che una sola onda non mostrerebbe.

L'API sovrappone più canali (e-mail, Teams, messaggistica, posta cartacea) in un'unica interfaccia, come un interferometro combina più onde in un'unica lettura.

Il cluster

Come si incastrano i componenti. I numeri nello schema rimandano all'elenco qui sotto.

  1. I visitatori raggiungono la sua applicazione tramite Higgs: HTTPS con certificati automatici e i nomi DNS che serve.
  2. Higgs e ogni agente Strange mantengono aperto un WebSocket: Higgs invia lo stato voluto e i segreti, l'agente riferisce lo stato di salute.
  3. Higgs inoltra ogni richiesta a un'istanza pronta sul suo nodo (Photon, Field o la sua applicazione); per un sito statico aggiunge un'intestazione firmata che indica il sito.
  4. Strange avvia ogni applicazione come unità systemd isolata, nel proprio spazio di rete.
  5. Le applicazioni, Photon e Field compresi (Field vi legge i siti), leggono e scrivono /distributed tramite Bottom (FUSE) e rclone.
  6. I file sono conservati in più copie sui nodi di storage Rup.
  7. Le applicazioni usano i servizi della piattaforma: gDown per i dati, Charm per i token di identità, Top per la configurazione e i segreti.
  8. Charm e Top conservano i propri dati in gDown, con chiavi e segreti cifrati.
  9. Bup clona il repository Git in cui è custodito il suo codice, scritto da lei o da un assistente IA.
  10. Bup costruisce l'eseguibile nativo e chiede a Higgs di distribuirlo.
  11. Un assistente IA guida la piattaforma tramite Gauge (MCP).
  12. Gauge agisce su Bup e Higgs con token Charm limitati, entro le regole fissate dal cliente.
  13. Il Calorimetro conserva i log e le metriche che Strange raccoglie da ogni applicazione e che Higgs espone, e ne ricava dashboard e avvisi.
  14. Il Synchrotron è la console di amministrazione: chiama l'API di Higgs (e quelle degli altri servizi) con il token della persona connessa.
  15. Sea, fuori dal cluster, serve i binari firmati che install.sh e Strange scaricano per installare e aggiornare i nodi.

Un solo indirizzo per tutte le interfacce

Higgs può servire l'intera piattaforma dietro un unico indirizzo, per esempio https://gluonify.lan: la console, gli strumenti e la pagina di accesso condividono un solo host, ciascuno sotto il proprio prefisso di percorso.

  • Higgs è il proxy inverso di quell'indirizzo: rotte per prefisso di percorso, vince il prefisso più lungo, una rotta / fa da predefinita e si può impostare una politica (auth, cors, limits, ips) per rotta.
  • L'apice della zona è un dominio: è accettato solo il nome esattamente uguale alla zona, nomi come api.gluonify.lan o quello di un'applicazione sotto la zona restano riservati all'API e alle applicazioni. Il suo certificato è quello della zona (apice e jolly), ottenuto tramite ACME; non viene mai richiesto un secondo certificato per l'apice.
  • Rotte di sviluppo di tipo upstream: Higgs chiama direttamente un indirizzo di destinazione (http o https), senza applicazione Higgs, posizionamento né nodo, per un cluster di sviluppo le cui interfacce sono JVM sulla macchina. HTTP, HTTPS e WebSocket sono inoltrati, le intestazioni X-Forwarded-* e il prefisso sono impostati e una destinazione ferma dà un 502 JSON. In un cluster reale gli strumenti sono applicazioni Higgs.
  • Le destinazioni delle rotte upstream devono trovarsi in un elenco consentito (loopback e reti private per impostazione predefinita), controllato al salvataggio della rotta e a ogni chiamata; gli indirizzi dei metadati dei cloud sono sempre rifiutati.
  • Accesso unico: Charm si trova alla radice dell'indirizzo e il suo cookie di sessione è la sessione unica. Ogni interfaccia fa uno scambio silenzioso (OIDC prompt=none) e mostra la pagina di accesso di Charm solo se non esiste una sessione. Anche l'uscita è unica: Charm termina la sessione a partire da un id_token_hint e da un indirizzo di ritorno registrato.
  • Menu degli strumenti: il pacchetto condiviso gluonify-ui fornisce AppSwitcher, un menu a discesa per passare da un'interfaccia all'altra, accanto ai controlli di lingua e tema. Legge il catalogo pubblico GET /portal/apps.json servito da Synchrotron e mostra solo gli strumenti i cui ruoli richiesti corrispondono ai ruoli della persona connessa. Questo filtro è una comodità: ogni servizio applica comunque i propri diritti.

Descritto nei README di Higgs e Charm. Limiti: una destinazione HTTPS di una rotta upstream è verificata rispetto alle autorità della JVM (non coperto da un test automatico); non c'è una sonda di salute periodica, lo stato di una destinazione si vede alla chiamata (502).