Installare la piattaforma

Da un host Debian 13 vuoto a una piattaforma funzionante: prima un orchestratore, poi tutti i nodi che volete. Ogni download viene controllato con un manifesto firmato (Ed25519) e uno SHA-256 prima di installare qualsiasi cosa.

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).