Ein minimalistisches PaaS für native GraalVM- und Python-Anwendungen

Gluonify ist ein minimalistisches PaaS. Es betreibt native GraalVM-Anwendungen (Quarkus, Spring Boot, Micronaut, Helidon …) und Python-Anwendungen (FastAPI) auf Debian-13-Knoten ohne Administration: ein Token, eine delegierte DNS-Zone, und der Cluster startet sich selbst. WebSocket ist der Standardtransport zwischen den Komponenten; der Clusterzustand wird mit Raft repliziert. Die Komponenten von Gluonify sind selbst native Quarkus-4-Anwendungen.

Komponenten

Jede Komponente hat ein eigenes Repository; die Namen folgen den Teilchen des Standardmodells.

Higgs — Orchestrator

Orchestrator: Deployment-API, Scheduler, TLS-Ingress, autoritatives DNS, ACME, Raft-Zustand, Start des Stacks, Dateisperren, Token von Anwendung zu Dienst.

Das Higgs-Boson ist die Anregung des Higgs-Feldes, des Feldes, das den anderen Elementarteilchen ihre Masse verleiht. Es wurde 2012 am CERN beobachtet.

Higgs, der Orchestrator, ist das Feld, auf dem alles andere beruht: Es gibt jeder Anwendung ihren Platz und ihr Gewicht im Cluster.

Strange — Knoten-Agent

Knoten-Agent: führt Anwendungen als isolierte systemd-Units aus, Netzwerk, Gateway /distributed/*, Sperren-Relay. Eine Anwendung kann eine einfache ausführbare Datei oder ein .tar.gz-Archiv sein (ausführbare Datei, Bibliotheken, Systempakete je Distribution, die der Agent installiert). Er legt die Token von Anwendung zu Dienst in einer schreibgeschützten Datei jeder Instanz ab und erneuert sie.

Das Strange-Quark (s) ist ein Quark der zweiten Generation mit der elektrischen Ladung −1/3. Das Gluon ist das Boson der starken Wechselwirkung: Es bindet Quarks aneinander.

Der Agent bindet jede Anwendung an ihren Knoten, so wie Gluonen Quarks aneinander binden.

Rup — Speicher

Speicherknoten: SHA-256-adressierte Objekte, replizierte Dateien, Quoten.

Das Up-Quark (u) ist das leichteste Quark mit der Ladung +2/3. Ein Proton enthält zwei davon; dies ist das rote.

Der Speicher ist eines der beiden Up-Quarks des Protons: ein Fundament, auf dem die anderen Komponenten aufbauen.

Bottom — FUSE-Daemon (C)

FUSE-Daemon in C (libfuse3): Dateisperren zwischen Knoten.

Das Bottom-Quark (b) ist ein Quark der dritten Generation mit der Ladung −1/3, ein schwererer Vetter des Down-Quarks (1977 beobachtet).

Die unterste Schicht des Dateisystems: der Daemon unter den Mounts /distributed/*.

gDown — Graphdatenbank

Replizierte Graphdatenbank (Raft): Charm, Top, Metadaten; openCypher und Bolt; Anwendungen erreichen ihre Datenbank über Bolt mit TLS (Bolt + OGM unterstützt).

Das Down-Quark (d) hat die Ladung −1/3. Ein Proton enthält eines, zusammen mit zwei Up-Quarks; dies ist das grüne.

Die Graphdatenbank ist das größte Quark des Logos: das Gedächtnis, auf dem die Plattform ruht.

Möchten Sie mehr erfahren?

Top — Konfiguration & Secrets

Top: Konfiguration und Secrets pro Anwendung, Vue-Weboberfläche.

Das Top-Quark (t) ist das schwerste bekannte Elementarteilchen (etwa 173 GeV/c²) mit der Ladung +2/3.

Top bewahrt das Schwerste auf, was eine Plattform enthält: Secrets.

Charm — Identitätsanbieter

Aussteller kurzlebiger JWT (ES256) und minimaler OIDC-Provider.

Das Charm-Quark (c) ist ein Quark der zweiten Generation mit der Ladung +2/3, 1974 beobachtet.

Der Identitätsanbieter gibt jedem Programm den kurzlebigen „Charme“, durch den es erkannt wird.

Bup — Builder

Builder: Git-Clone, nativer Build, Veröffentlichung, Deployment. Erzeugt der native Build Bibliotheken, wird die Anwendung als .tar.gz-Archiv veröffentlicht (ausführbare Datei, Bibliotheken, Systemabhängigkeiten je Distribution). Das Maven-Repository von Sea, in dem das SDK der Plattform veröffentlicht wird, wird seinen Maven- und Gradle-Builds zusätzlich zu Maven Central hinzugefügt: Eine Kundenanwendung, die vom SDK abhängt, wird ohne jede Einstellung gebaut. Er reicht die von der Anwendung deklarierten Dienste (uses, eigene gDown-Datenbank) an den Orchestrator weiter.

Das zweite Up-Quark des Protons; dies ist das blaue. Die drei Quarks eines Protons tragen drei verschiedene Farben, die sich aufheben.

Der Builder macht aus Ihrem Code das Artefakt, das ausgeliefert wird.

Photon — API-Gateway

API-Gateway und Nachrichtenverarbeitung. Routing nach Domain und Pfad, Zertifikate je Domain, Richtlinien (Adressen, CORS, Charm-Token, Ratenbegrenzung) und die Bereitstellung von gDown liegen in Higgs, dem Orchestrator; diese Komponente verarbeitet signierte Webhooks, JSON-/XML-/Formular-/ProtoBuf-Transformationen, eine persistente Warteschlange und die Zustellung mit Wiederholungen, auf mehreren Replikaten.

Das Photon (γ) ist das masselose Boson des Elektromagnetismus: Es trägt Licht und damit Information.

Das API-Gateway ist die Haustür, durch die das Licht der Außenwelt, ihre Anfragen, in die Cloud gelangt.

Field — Server für statische Inhalte

Server für statische Inhalte: Websites werden als ZIP hinterlegt und aus /distributed/std/<uuid>/ ausgeliefert; die Website wird durch einen vom Ingress gesetzten, signierten Header gewählt, nie vom Client.

Ein Quantenfeld ist eine Größe, die an jedem Punkt des Raums definiert ist; Teilchen sind seine Anregungen.

Statische Inhalte, die Materie, werden von dieser Anwendung überall im Netz verfügbar gemacht.

Gauge — KI-Steuerung (MCP)

MCP-Server: ermöglicht einem KI-Assistenten, Anwendungen über die Plattform-API bereitzustellen, zu konfigurieren und deren Protokolle zu lesen. Charm-Token pro Anwendung mit begrenzten Rollen, vom Kunden festgelegte Regeln, menschliche Freigabe für die Produktion, Audit jeder Aktion. Ein schreibgeschütztes Werkzeug usage meldet Speicher und CPU der Anwendungen und der Komponenten der Plattform (eine Momentaufnahme, nie eine Abrechnungsgrundlage).

Eichbosonen sind die Austauschteilchen der fundamentalen Kräfte. Sie sind die konkrete Erscheinung der Eichsymmetrien, die festlegen, wie Materieteilchen miteinander wechselwirken.

Die Schnittstelle trägt eine Kraft: Sie erlaubt der KI, auf den Cluster einzuwirken, doch diese Einwirkung wird durch das vom Kunden festgelegte „Eichgesetz“ (die MCP-Konfiguration) gefiltert und genehmigt, so wie ein Eichboson an die Symmetrie gebunden ist, die es definiert.

Calorimeter — Beobachtbarkeit

Beobachtbarkeit: bewahrt die Protokolle und Metriken jeder Anwendung über die Lebensdauer eines Knotens hinaus auf, mit einem Dashboard pro Anwendung und Alarmen. Sie baut auf dem auf, was Higgs und Strange schon bereitstellen: Journale, /q/metrics und Prometheus-Erkennung unter /metrics/sd.

Ein Kalorimeter ist ein Teilchendetektor, der Energie misst, indem er Teilchen Schicht für Schicht absorbiert: Die abgegebene Energie verrät, was hindurchgegangen ist.

Die Aktivität jeder Anwendung gibt ihre Energie als Protokolle und Messwerte im Kalorimeter ab: Es nimmt sie auf, zeichnet sie auf und lässt lesen, was geschehen ist.

Synchrotron — Verwaltungskonsole

Verwaltungskonsole: ein nativer Quarkus-Dienst, der eine Vue-3-Oberfläche ausliefert. Er prüft das Charm-Token und leitet jeden Aufruf mit dem Token des Aufrufers über eine Positivliste an die Plattform-APIs (Higgs, Top, Charm, Photon, Bup) weiter: Er erhöht nie Rechte.

Ein Synchrotron ist ein kreisförmiger Teilchenbeschleuniger: Magnete lenken den Strahl ab, während ein elektrisches Feld ihm bei jedem Umlauf Energie hinzufügt, bis die gewünschte Energie erreicht ist.

Wie der Kontrollraum eines Beschleunigers lässt die Konsole den Betreiber Energie in die Plattform einspeisen (bereitstellen, skalieren, aufwecken) und den Strahl beobachten, nie über die Rechte der Person hinaus, die sie benutzt.

Sea — Release-Speicher

Release-Speicher (images.gluonify.io): liefert die signierten nativen Binärdateien, die install.sh und Strange herunterladen. Inhaltsadressierte Dateien, unveränderliche Releases; die vom Client geprüfte Ed25519-Signatur des Manifests ist der Vertrauensanker, und eine Version kann nie zurückgehen (Sequenznummer). Er stellt auch das Maven-Repository der Plattform bereit (/maven/): öffentlich lesbar, Veröffentlichung dem Herausgeber der Plattform vorbehalten, veröffentlichte Versionen unveränderlich. Das Java-SDK für die Anwendungen der Kunden wird dort veröffentlicht, und der Builder fügt dieses Repository seinen Builds hinzu.

In einem Proton entsteht und vergeht neben den drei Valenzquarks ständig ein „Meer“ aus virtuellen Quark-Antiquark-Paaren und Gluonen: Es macht einen großen Teil dessen aus, woraus das Proton besteht.

Das Meer umgibt die Quarks, die das Proton bilden; hier umgibt der Speicher die Plattform mit den Binärdateien, aus denen sie besteht, und jeder Knoten holt sich daraus, was er installiert.

Fermion — Workflow- und Regel-Engine

Workflow- und Regel-Engine: BPMN-2-Workflows und DMN-Entscheidungstabellen, in Git (Bitbucket, GitLab) verwaltet und serverseitig ausgeführt. Anwendungen verbinden sich als Knoten über einen dauerhaften WebSocket (Protokoll und Client liegen im plasma-SDK), melden ihre Fähigkeiten und führen nur atomare Aufgaben aus; Fermion verteilt die Schritte, verwaltet Wiederholungen, Timer und Schutzschalter und setzt eine fehlgeschlagene Ausführung am letzten Schritt fort. Zustand und Verlauf liegen in gDown; Aufrufe werden mit Charm-Tokens authentifiziert; Vue-Weboberfläche in fünf Sprachen. Vorerst ein einziges aktives Replikat. Der Nachrichtenversand (E-Mail, Teams, Post) liegt bei Interfero, einem Knoten wie jeder andere.

Ein Fermion ist ein Teilchen mit halbzahligem Spin, das dem Pauli-Prinzip gehorcht: Zwei identische Fermionen können nicht denselben Quantenzustand besetzen. Quarks und Elektronen sind Fermionen.

Eine Workflow- und Regel-Engine lebt von derselben Einschränkung: Zu jedem Zeitpunkt belegt eine Instanz nur einen Schritt, eine Aufgabe geht nur an einen Knoten, eine Entscheidung liefert für eine gegebene Nutzlast eine deterministische Antwort. Daher die Strenge der Engine.

Crystallon — Dokumentkonvertierung und -erzeugung

Dokumentdienst: Er macht aus einem dynamischen Dokument ein festes, eigenständiges, archivierbares und erzeugt neue Dokumente. Konvertierung: Bilder (BMP, JPEG, PNG, TIFF, WebP) werden zu PNG; PDFs werden zu PDF/A-1B (Schriften und Farbprofil eingebettet, XMP-Metadaten), und mehrere PDFs lassen sich zu einem zusammenführen; nichts wird aufbewahrt. Erzeugung: Ein PDF entsteht aus einer JSON-Vorlage und JSON-Daten (Vorlagen für Rechnung, Angebot und Brief, Schweizer QR-Rechnung mit strenger Prüfung, PDF/A-1B auf Wunsch). Die Vorlagen werden je Organisation in einer eigenen gDown-Datenbank aufbewahrt, mit Versionen, Verlauf und Wiederherstellung, samt ihren Logos und Bildern (SVG-Bilder werden als Vektoren gezeichnet); eine Anwendung rendert eine Vorlage über ihren Namen oder in einer bestimmten Version, und jeder Prüffehler sagt, wo er in der Vorlage liegt. Ein grafischer Editor in der Weboberfläche (Englisch, Französisch, Spanisch, Italienisch und Deutsch, helles und dunkles Design) gestaltet die Seite: Blöcke per Drag-and-drop hinzugefügt und verschoben, Text in formatierten Segmenten, Spalten, die Schriften Inter und Helvetica, PDF-Vorschau in Echtzeit mit Beispieldaten. Jede Organisation kann außerdem eigene TrueType-Schriften hochladen (Lizenz geprüft, Bestätigung der Rechte verpflichtend, vier Varianten je Familie, Kontingente): Die Vorlagen verwenden sie wie die des Motors, und sie werden in das PDF/A-1B eingebettet. Sein Reiter Code gibt einer Anwendung, was sie braucht: das Schema der Daten, die die Vorlage liest (JSON Schema), und erzeugten Java-Code, Records und eine Fassade auf dem Java-SDK, das über das Maven-Repository von Sea bereitgestellt wird. Der Zugriff erfolgt per Charm-Token (Audience gluonify-crystallon) mit einer Rolle je Aufgabe: render zum Erzeugen von Dokumenten, convert zum Konvertieren, templates zum Verwalten. Eine Anwendung, die crystallon in uses deklariert, erhält von der Plattform ein kurzlebiges render-Token, das ohne Neustart erneuert wird; auch eine angemeldete Person kann ihr eigenes weiterreichen. Die Geheimnisse der Zahlungsanbieter werden aus dem Top-Tresor gelesen. Die Umwandlung von AVIF- und HEIC-Bildern erfolgt mit externen Werkzeugen (avifdec, heif-convert), die auf dem Knoten installiert sein müssen; ohne sie antwortet der Dienst mit 503. Er wird als Anwendungsarchiv mit seinen Bibliotheken ausgeliefert.

Ein Kristall ist ein Festkörper, dessen Atome ein regelmäßiges, in alle Richtungen wiederholtes Gitter besetzen: Eine abkühlende Flüssigkeit erstarrt in dieser Ordnung.

Der Dienst tut dasselbe mit einem Dokument: Ein Foto, ein mit beliebigem Werkzeug erzeugtes PDF oder mehrere zusammenzufügende PDFs werden in ein stabiles Format gebracht, das von keinem Viewer abhängt.

Interfero — Nachrichtenversand

Nachrichtenversand: eine native REST-API (Quarkus, Charm-Tokens, Zustand in gDown), die E-Mail (SMTP), Teams (Workflows-Webhook), sechs Messenger (WhatsApp Business über die Cloud API von Meta mit genehmigten Vorlagen, Telegram, Slack, Discord, LINE, Viber; Zugangsdaten pro Organisation in Top, nur offizielle Hosts) und Briefpost (PDF von Crystallon, dann an einen Postdienstleister übergeben; bisher gibt es nur einen Ablage-Dienstleister, keinen echten Zusteller) hinter einer einzigen Schnittstelle vereint. Sie ist ein Fermion-Knoten, der SEND_MSG_EMAIL, SEND_MSG_TEAMS und SEND_MSG_POST ankündigt, und verwaltet die Nachrichtenvorlagen (Versionen, Vorschau, Versandprotokoll); die Ansicht Templates befindet sich in Fermion. Seine Aufrufe an Crystallon und Fermion verwenden die Anwendungstoken, die die Plattform bereitstellt, ohne jede Konfiguration.

Ein Interferometer überlagert Wellen aus mehreren Quellen und liest das Muster, das sie gemeinsam bilden, was eine einzelne Welle nicht zeigen würde.

Die API überlagert mehrere Kanäle (E-Mail, Teams, Messenger, Briefpost) zu einer einzigen Schnittstelle, wie ein Interferometer mehrere Wellen zu einer Messung vereint.

Der Cluster

Wie die Komponenten zusammenspielen. Die Nummern im Schaubild verweisen auf die Liste darunter.

  1. Besucher erreichen Ihre Anwendung über Higgs: HTTPS mit automatischen Zertifikaten und den DNS-Namen, die es bedient.
  2. Higgs und jeder Strange-Agent halten einen WebSocket offen: Higgs sendet den Sollzustand und die Secrets, der Agent meldet den Zustand.
  3. Higgs leitet jede Anfrage an eine bereite Instanz auf ihrem Knoten weiter (Photon, Field oder Ihre Anwendung); bei einer statischen Website fügt es einen signierten Header mit dem Namen der Website hinzu.
  4. Strange startet jede Anwendung als isolierte systemd-Unit in einem eigenen Netzwerkraum.
  5. Anwendungen, einschließlich Photon und Field (Field liest dort die Websites), lesen und schreiben /distributed über Bottom (FUSE) und rclone.
  6. Dateien werden in mehreren Kopien auf den Rup-Speicherknoten abgelegt.
  7. Anwendungen nutzen die Plattformdienste: gDown für Daten, Charm für Identitäts-Token, Top für Konfiguration und Secrets.
  8. Charm und Top speichern ihre Daten in gDown, Schlüssel und Secrets verschlüsselt.
  9. Bup klont das Git-Repository, in dem Ihr Code liegt, geschrieben von Ihnen oder einem KI-Assistenten.
  10. Bup baut die native Programmdatei und bittet Higgs, sie bereitzustellen.
  11. Ein KI-Assistent steuert die Plattform über Gauge (MCP).
  12. Gauge wirkt auf Bup und Higgs mit eingeschränkten Charm-Token, innerhalb der vom Kunden gesetzten Regeln.
  13. Das Kalorimeter bewahrt die Protokolle und Metriken auf, die Strange von jeder Anwendung sammelt und Higgs bereitstellt, und macht daraus Dashboards und Alarme.
  14. Das Synchrotron ist die Verwaltungskonsole: Sie ruft die API von Higgs (und die der anderen Dienste) mit dem Token der angemeldeten Person auf.
  15. Sea, außerhalb des Clusters, liefert die signierten Binärdateien, die install.sh und Strange zum Installieren und Aktualisieren der Knoten herunterladen.

Eine einzige Adresse für alle Oberflächen

Higgs kann die ganze Plattform hinter einer einzigen Adresse anbieten, zum Beispiel https://gluonify.lan: Konsole, Werkzeuge und Anmeldeseite teilen sich einen Host, jedes unter seinem eigenen Pfadpräfix.

  • Higgs ist der Reverse-Proxy dieser Adresse: Routen nach Pfadpräfix, das längste Präfix gewinnt, eine Route / dient als Standard, und eine Richtlinie (auth, cors, limits, ips) lässt sich pro Route festlegen.
  • Der Apex der Zone ist eine Domain: Nur der Name, der genau der Zone entspricht, wird akzeptiert, Namen wie api.gluonify.lan oder der einer Anwendung unter der Zone bleiben der API und den Anwendungen vorbehalten. Sein Zertifikat ist das der Zone (Apex und Wildcard), per ACME bezogen; für den Apex wird nie ein zweites Zertifikat angefordert.
  • Entwicklungsrouten vom Typ upstream: Higgs ruft eine Zieladresse (http oder https) direkt auf, ohne Higgs-Anwendung, Platzierung oder Knoten, für einen Entwicklungscluster, dessen Oberflächen JVMs auf dem Rechner sind. HTTP, HTTPS und WebSocket werden weitergeleitet, die Header X-Forwarded-* und das Präfix gesetzt, und ein angehaltenes Ziel ergibt ein JSON-502. In einem echten Cluster sind die Werkzeuge Higgs-Anwendungen.
  • Die Ziele von upstream-Routen müssen in einer Erlaubnisliste stehen (standardmässig Loopback und private Netze), geprüft beim Speichern der Route und bei jedem Aufruf; Metadatenadressen der Clouds werden immer abgelehnt.
  • Einmalanmeldung: Charm liegt an der Wurzel der Adresse, und sein Sitzungscookie ist die einzige Sitzung. Jede Oberfläche führt einen stillen Austausch durch (OIDC prompt=none) und zeigt die Anmeldeseite von Charm nur, wenn keine Sitzung besteht. Auch die Abmeldung ist einmalig: Charm beendet die Sitzung anhand eines id_token_hint und einer registrierten Rücksprungadresse.
  • Werkzeugmenü: Das gemeinsame Paket gluonify-ui liefert AppSwitcher, ein Aufklappmenü zum Wechsel zwischen den Oberflächen, neben den Einstellungen für Sprache und Design. Es liest den öffentlichen Katalog GET /portal/apps.json, den Synchrotron bereitstellt, und zeigt nur die Werkzeuge, deren erforderliche Rollen zu den Rollen der angemeldeten Person passen. Dieser Filter ist eine Bequemlichkeit: Jeder Dienst setzt seine eigenen Rechte durch.

Beschrieben in den README von Higgs und Charm. Grenzen: Ein HTTPS-Ziel einer upstream-Route wird gegen die Autoritäten der JVM geprüft (nicht durch einen automatischen Test abgedeckt); es gibt keine periodische Gesundheitsprüfung, der Zustand eines Ziels zeigt sich beim Aufruf (502).