Die Plattform installieren

Vom leeren Debian-13-Host zur laufenden Plattform: zuerst ein Orchestrator, dann so viele Knoten, wie Sie wollen. Jeder Download wird anhand eines signierten Manifests (Ed25519) und einer SHA-256-Prüfsumme kontrolliert, bevor etwas installiert wird.

Bevor Sie anfangen

  • Ein Debian-13-Host (oder Ubuntu 22.04 und neuer) mit systemd, Root-Zugriff, einer öffentlichen IP-Adresse und offenen Ports 80, 443 und 53 (TCP und UDP): Er wird der erste Orchestrator.
  • Eine DNS-Zone für Ihre Anwendungen (zum Beispiel apps.example.org), per NS-Einträgen an diese öffentliche IP delegiert: Der Orchestrator antwortet für sie und holt die TLS-Zertifikate. Andere Modi lassen die Zone bei Ihnen (extern, Cloudflare).
  • Die drei Programme des Stacks (gdown, Charm, Top) als HTTPS-Adressen mit ihrer SHA-256-Prüfsumme: Die Plattform führt ihre eigenen Dienste als Anwendungen aus.
  • Optional weitere Debian-Hosts: Jeder wird mit einem Befehl zu einem Knoten.

Das Vertrauen beruht auf dem TLS-Zertifikat dieser Website und dem Fingerabdruck oben: Übergeben Sie ihn mit --key-sha256, damit das Skript jeden anderen Schlüssel ablehnt.

1. Der erste Orchestrator

Der Orchestrator (Higgs): API, Scheduler, Ingress, DNS, ACME und Raft-Zustand. Der Befehl lädt die Version herunter und prüft sie, dann führt er den Installer für die Rolle Orchestrator aus; alles nach dem zweiten -- geht an den Installer. Mit gluonify.higgs.stack.enabled stellt er auch den Stack selbst bereit: gdown, dann die Identität, dann den Top.

2. Prüfen, dass er läuft

Der Stack startet Schritt für Schritt, und jeder Schritt wird am realen Zustand geprüft; ein Neustart macht dort weiter, wo er war. Das Administrator-Token liegt in einer nur für root lesbaren Datei.

3. Knoten hinzufügen

Fordern Sie beim Orchestrator ein Einmal-Token an; die Antwort enthält den Befehl für den neuen Host. Der Host öffnet eine ausgehende Verbindung zum Orchestrator, führt nur einen geschlossenen Katalog signierter Aufgaben aus und meldet sich dann an: Auf ihm wird kein Port geöffnet.

4. Hochverfügbarkeit

Fügen Sie auf dieselbe Weise einen zweiten und dritten Orchestrator hinzu (Rolle Orchestrator): Der Orchestrator, der die Anfrage anlegt, gibt dem neuen Mitglied ein schmales Beitritts-Token, einmal gültig für 15 Minuten, nie das Administrator-Token. Drei Orchestratoren arbeiten weiter, wenn einer ausfällt.

5. Bereitstellen

Ab hier ist die Plattform leer und bereit: Stellen Sie Ihre Anwendungen mit der API, der Synchrotron-Konsole oder der Startanwendung gluonify-source bereit.

Danach: Ihre Anwendung, ohne Konfiguration

Eine Anwendung erreicht die Dienste der Plattform mit 0 Zeilen Konfiguration. Für die Produktion ist nichts zu deklarieren: Bup erkennt die SDK-Module und füllt "uses" selbst; gluonify.json ergänzt nur die Dienste, die außerhalb des SDK erreicht werden. Für die Entwicklung führen Sie einmal gluonify login auf Ihrem Rechner aus (gluonify.lan für den lokalen Entwicklungscluster, sonst Ihre Zone). Das SDK findet dann Adresse und Token von selbst.

Auf Ihrem Rechner, einmal

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

Im Code

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

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

Was noch nicht automatisiert ist

Die Programme des Stacks liegen noch nicht im Release-Speicher: Bauen Sie sie (siehe BOOTSTRAP.md) oder hosten Sie sie auf einem beliebigen HTTPS-Server. gDown allein lässt sich schon mit gDown.sh installieren (Seite gDown).