Prima di iniziare
- Un host Debian 13 (o Ubuntu 22.04 e successivi) con systemd, accesso root, un indirizzo IP pubblico e le porte 80, 443 e 53 (TCP e UDP) aperte: diventa il primo orchestratore.
- Una zona DNS per le vostre applicazioni (per esempio apps.example.org), delegata con record NS a quell'IP pubblico: l'orchestratore risponde per essa e ottiene i certificati TLS. Altre modalità lasciano la zona a voi (esterna, Cloudflare).
- I tre eseguibili dello stack (gdown, charm, top) come indirizzi HTTPS con il loro SHA-256: la piattaforma esegue i propri servizi come applicazioni.
- Facoltativo: altri host Debian, ciascuno dei quali diventa un nodo con un comando.
La fiducia poggia sul certificato TLS di questo sito e sull'impronta qui sopra: passatela con --key-sha256 perché lo script rifiuti qualsiasi altra chiave.
1. Il primo orchestratore
L'orchestratore (Higgs): API, scheduler, ingress, DNS, ACME e stato Raft. Il comando scarica e controlla la versione, poi esegue l'installatore del ruolo orchestratore; tutto ciò che segue il secondo -- viene passato all'installatore. Con gluonify.higgs.stack.enabled distribuisce anche lo stack da solo: gdown, poi l'identità, poi il top.
2. Verificare che funzioni
Lo stack parte un passo alla volta e ogni passo viene controllato sullo stato reale; un riavvio riprende da dove era. Il token di amministrazione è in un file leggibile solo da root.
3. Aggiungere nodi
Chiedete all'orchestratore un token monouso; la risposta contiene il comando da eseguire sul nuovo host. L'host apre una connessione in uscita verso l'orchestratore, esegue solo un catalogo chiuso di attività firmate, poi si iscrive: nessuna porta viene aperta su di esso.
4. Alta disponibilità
Aggiungete un secondo e un terzo orchestratore allo stesso modo (ruolo orchestratore): l'orchestratore che crea la richiesta consegna al nuovo membro un token di adesione ristretto, valido una volta per 15 minuti, mai il token di amministrazione. Tre orchestratori continuano a funzionare quando uno va perso.
5. Distribuire
Da qui la piattaforma è vuota e pronta: distribuite le vostre applicazioni con l'API, la console Synchrotron o l'applicazione di partenza gluonify-source.
Poi: la vostra applicazione, senza configurazione
Un'applicazione raggiunge i servizi della piattaforma con 0 righe di configurazione. In produzione, nulla da dichiarare: Bup rileva i moduli dell'SDK e compila "uses" da solo; gluonify.json aggiunge solo i servizi raggiunti fuori dall'SDK. In sviluppo, eseguite una volta gluonify login sulla vostra macchina (gluonify.lan per il cluster di sviluppo locale, altrimenti la vostra zona). L'SDK trova poi da solo l'indirizzo e il token.
Sulla vostra macchina, una volta
gluonify login gluonify.lan # once, in your browser (PKCE): the SDK then finds the services of the zone
Nel codice
@Inject CrystallonClient crystallon; // no URL, no token, no property: 0 lines of configuration
RenderedPdf pdf = crystallon.byName("Gluonify invoice").render(payload);Ciò che non è ancora automatizzato
Gli eseguibili dello stack non sono ancora sul deposito delle versioni: costruiteli (vedi BOOTSTRAP.md) o ospitateli su un qualsiasi server HTTPS. gDown da solo si installa già con gDown.sh (pagina gDown).