Installer la plateforme

D'un hôte Debian 13 nu à une plateforme en marche : d'abord un orchestrateur, puis autant de nœuds que vous voulez. Chaque téléchargement est contrôlé d'après un manifeste signé (Ed25519) et un SHA-256 avant que rien ne soit installé.

Avant de commencer

  • Un hôte Debian 13 (ou Ubuntu 22.04 et suivants) avec systemd, un accès root, une adresse IP publique et les ports 80, 443 et 53 (TCP et UDP) ouverts : il devient le premier orchestrateur.
  • Une zone DNS pour vos applications (par exemple apps.example.org), déléguée par des enregistrements NS à cette adresse publique : l'orchestrateur y répond et obtient les certificats TLS. D'autres modes laissent la zone chez vous (externe, Cloudflare).
  • Les trois exécutables de la pile (gdown, charm, top) sous forme d'adresses HTTPS avec leur SHA-256 : la plateforme exécute ses propres services comme des applications.
  • Facultatif : d'autres hôtes Debian, dont chacun devient un nœud en une commande.

La confiance repose sur le certificat TLS de ce site et sur l'empreinte ci-dessus : passez-la avec --key-sha256 pour que le script refuse toute autre clé.

1. Le premier orchestrateur

L'orchestrateur (Higgs) : API, ordonnanceur, ingress, DNS, ACME et état Raft. La commande télécharge et contrôle la version, puis lance l'installateur du rôl'orchestrateur ; tout ce qui suit le second -- est transmis à l'installateur. Avec gluonify.higgs.stack.enabled, elle déploie aussi la pile toute seule : gdown, puis l'identité, puis le top.

2. Vérifier qu'il est en marche

La pile démarre une étape à la fois et chaque étape est vérifiée sur l'état réel ; un redémarrage reprend là où il en était. Le jeton d'administration est dans un fichier lisible par root seul.

3. Ajouter des nœuds

Demandez à l'orchestrateur un jeton à usage unique ; la réponse contient la commande à lancer sur le nouvel hôte. L'hôte ouvre une connexion sortante vers l'orchestrateur, n'exécute qu'un catalogue fermé de tâches signées, puis s'enrôle : aucun port n'est ouvert sur lui.

4. Haute disponibilité

Ajoutez un deuxième et un troisième orchestrateur de la même façon (rôle orchestrateur) : l'orchestrateur qui crée la demande remet au nouveau membre un jeton de jonction étroit, valable une fois pendant 15 minutes, jamais le jeton d'administration. Trois orchestrateurs continuent de fonctionner quand l'un est perdu.

5. Déployer

À partir de là, la plateforme est vide et prête : déployez vos applications avec l'API, la console Synchrotron ou l'application de départ gluonify-source.

Ensuite : votre application, sans configuration

Une application joint les services de la plateforme avec 0 ligne de configuration. En production, rien à déclarer : Bup détecte les modules du SDK et remplit "uses" tout seul ; gluonify.json n'ajoute que les services joints hors du SDK. En développement, lancez une fois gluonify login sur votre poste (gluonify.lan pour le cluster de développement local, votre zone sinon). Le SDK trouve ensuite tout seul l'adresse et le jeton.

Sur votre poste, une fois

gluonify login gluonify.lan     # once, in your browser (PKCE): the SDK then finds the services of the zone

Dans le code

@Inject CrystallonClient crystallon;   // no URL, no token, no property: 0 lines of configuration

RenderedPdf pdf = crystallon.byName("Gluonify invoice").render(payload);

Ce qui n'est pas encore automatisé

Les exécutables de la pile ne sont pas encore sur le réservoir de versions : construisez-les (voir BOOTSTRAP.md) ou hébergez-les sur n'importe quel serveur HTTPS. gDown seul s'installe déjà avec gDown.sh (page gDown).