Aus Ihrem Repository gebaute Frameworks
Der Builder liest Ihre pom.xml, erkennt das Framework und startet den passenden nativen Build in einem Container mit GraalVM 25 und Maven. Sie müssen nicht angeben, welches Framework Sie verwenden.
| Framework | Nativer Build (Maven) | Port-Variable | Health-Pfad | Erforderliche Abhängigkeit | Geprüft mit |
|---|---|---|---|---|---|
| Quarkus | mvn package -Dnative -Dquarkus.native.container-build=true | QUARKUS_HTTP_PORT | /q/health/ready | quarkus-smallrye-health | Quarkus 4 |
| Spring Boot | mvn -Pnative native:compile | SERVER_PORT | /actuator/health | spring-boot-starter-actuator | Spring Boot 4.0.8 |
| Micronaut | mvn package -Dpackaging=native-image | MICRONAUT_SERVER_PORT | /health | micronaut-management | Micronaut 5.2.1 |
| Helidon | mvn package -Pnative-image | SERVER_PORT | /observe/health/ready | helidon-webserver-observe-health | Helidon 4.5.5 |
| Python (FastAPI) | pip install --require-hashes | PORT | /health/ready | gluonify[fastapi] | CPython 3.13.5 · FastAPI 0.115.12 |
Quarkus ist das Framework der Plattform selbst. Spring Boot braucht Version 3 oder neuer (Ahead-of-Time-Verarbeitung). Helidon 4.2.0 scheitert unter GraalVM 25: Verwenden Sie 4.5.5 oder neuer. Der Health-Pfad von Helidon 3 ist /health/ready.
Ihre Anwendung einbringen: aus Git
Aus Git: Der Builder klont das Repository, kompiliert das native Programm, veröffentlicht es mit seinem SHA-256 und stellt es bereit; danach prüft er den Health-Pfad (und die Weckzeit, wenn der Ruhemodus aktiv ist).
Was Ihre Anwendung leisten muss
- Ein natives Linux-Programm sein: standardmäßig glibc 2.34 oder neuer, oder statisches musl für die kleinsten Images. Ein Programm pro Architektur (arm64 und x86_64).
- Auf dem Port lauschen, den die Plattform vergibt (die Variable oben wird gesetzt), und auf dem Health-Pfad 200 antworten, wenn sie bereit ist: Eine Instanz, die nicht antwortet, erhält keinen Verkehr.
- Weder eine JVM noch beschreibbaren ausführbaren Speicher benötigen: Anwendungen laufen in einer Sandbox mit eigenem Konto, eigenem Ordner und eigenem Netz, ohne Capabilities und mit seccomp-Filter.
Erkennung und gluonify.json
Das Framework wird aus der pom.xml des Moduls und seiner Eltern gelesen. Die Rangfolge lautet: die Anfrage, dann eine optionale gluonify.json im Modulstamm, dann die Erkennung. Werden mehrere Frameworks gefunden, hält der Build an und bittet Sie zu wählen.
{"framework": "spring-boot", "port": 8080, "health": "/actuator/health", "portEnv": "SERVER_PORT"}Bibliotheken für Ihre Anwendung: das Maven-Repository
Die Plattform veröffentlicht die Java-Bibliotheken, die ihre Dienste den Anwendungen anbieten, in einem Maven-Repository, das Sea bereitstellt: https://images.gluonify.io/maven. Lesen ist öffentlich und ohne Konto; nur der Herausgeber der Plattform veröffentlicht, und eine veröffentlichte Version ändert sich nie. Der Builder fügt dieses Repository den Maven- und Gradle-Builds, die er startet, neben Maven Central hinzu: Auf der Plattform ist nichts einzustellen; auf Ihrem Rechner und in Ihrer kontinuierlichen Integration deklarieren Sie es selbst. Die Bibliotheken sind der Java-Client von Crystallon (ein PDF aus einer gespeicherten Vorlage erzeugen, über ihren Namen angesprochen, mit erzeugtem Code für die Daten, die sie erwartet) und seit 0.6.1 das SDK ohne Konfiguration: Für eine Quarkus-Anwendung bringt gluonify-plasma-quarkus alles mit, und gluonify-plasma-testing liefert den Tests falsche Dienste.
Maven
<repositories>
<repository>
<id>gluonify</id>
<url>https://images.gluonify.io/maven</url>
</repository>
</repositories>
<dependency>
<groupId>io.gluonify.plasma</groupId>
<artifactId>gluonify-plasma-quarkus</artifactId>
<version>0.7.2</version>
</dependency>
<dependency>
<groupId>io.gluonify.plasma</groupId>
<artifactId>gluonify-plasma-testing</artifactId>
<version>0.7.2</version>
<scope>test</scope>
</dependency>Gradle (Kotlin DSL)
repositories {
mavenCentral()
maven("https://images.gluonify.io/maven")
}
dependencies {
implementation("io.gluonify.plasma:gluonify-plasma-quarkus:0.7.2")
testImplementation("io.gluonify.plasma:gluonify-plasma-testing:0.7.2")
}Die groupId ist io.gluonify.plasma. Die Version ist die der Plattform (zum Zeitpunkt der Niederschrift 0.7.2). Aus diesem Repository werden nur die Abhängigkeiten Ihrer Anwendung aufgelöst, nicht die Maven- oder Gradle-Plugins. Eine Anwendung mit crystallon in "uses" (von Bup aus dem SDK-Modul abgeleitet oder deklariert) erhält von der Plattform die Adresse von Crystallon und ein kurzlebiges Charm-Token mit der Rolle render: Der Knoten-Agent legt es in einer schreibgeschützten Datei ab, erneuert es vor dem Ablauf ohne Neustart der Anwendung, und das SDK liest es bei jedem Aufruf von selbst (CrystallonTokens.platform() ist die strenge Form, für einen von Hand gebauten Client); eine Anwendung, die für eine angemeldete Person handelt, leitet stattdessen das Token dieser Person weiter. Das Anwendungstoken trägt die Standardorganisation von Crystallon.
Keine Konfiguration
Einen Dienst der Plattform zu erreichen braucht 0 Zeilen Konfiguration: keine URL, kein Token, keine Property. Die Anwendung injiziert den Client (gluonify-plasma-quarkus), und das SDK (gluonify-plasma-services) findet Adresse und Token je nachdem, wo die Anwendung läuft. Es deckt heute Crystallon und Fermion ab. Die Reihenfolge ist für jeden Dienst gleich:
- Eine ausdrückliche Überschreibung, für Tests: GLUONIFY_SERVICE_<APP>_URL und GLUONIFY_<APP>_TOKEN als Systemeigenschaften.
- Auf der Plattform: die Adresse und das Anwendungstoken, die die Plattform für jeden Dienst in "uses" bereitstellt. Seit SDK 0.7.1 leitet Bup "uses" beim Build ab: Jedes Client-Modul des SDK trägt eine Markierung (META-INF/gluonify/services/<Dienst>), und Bup fügt den Dienst als optional hinzu (?crystallon). Nichts zu schreiben; gluonify.json ergänzt nur, was das SDK nicht erkennt, etwa einen direkten HTTP-Aufruf einer anderen Anwendung oder Charm für OIDC. Fehlt der Dienst, sagt die Meldung, warum.
- Auf Ihrem Rechner: nach gluonify login <Zone> (gluonify.lan für den Entwicklungscluster) die öffentlichen Adressen des Dokuments https://<Zone>/.well-known/gluonify und Ihr Entwicklertoken, das sich selbst erneuert. Dieses Dokument ist in der Produktion standardmäßig abgeschaltet.
- Sonst ein klarer Fehler, der sagt, was zu tun ist: gluonify login, oder falsche Dienste in Tests.
Auf Ihrem Rechner (Entwicklung), einmal
gluonify login gluonify.lan # once, in your browser (PKCE): the SDK then finds the services of the zone
Auf der Plattform (Produktion): nichts zu deklarieren
# nothing to declare: Bup detects the SDK modules at build time # gluonify-plasma-crystallon-client -> "uses": ["?crystallon"] (optional service)
Nur für Ergänzungen: gluonify.json
{"uses": ["charm", "orders"]}Im Code (Quarkus)
@Inject CrystallonClient crystallon; // no URL, no token, no property: 0 lines of configuration
RenderedPdf pdf = crystallon.byName("Gluonify invoice").render(payload);gluonify ist die Befehlszeile des SDK (Jar gluonify-plasma-cli: login, logout, status, token). Die Anmeldung erfolgt im Browser, bei Charm, mit PKCE: Kein Passwort geht über die Befehlszeile. In Tests startet GluonifyTestServices.start() (gluonify-plasma-testing) ein falsches Crystallon im Speicher, ohne etwas zu konfigurieren. Die Startanwendung gluonify-source tut genau das.
Grenzen
Maven- und Gradle-Projekte (Groovy- oder Kotlin-DSL) werden beide gebaut, Framework für Framework, wie es die Unterstützungsmatrix des Builders aufführt. Bibliotheken mit nativem Code (AWT, RocksDB, GSSAPI, PKCS#11) passen nicht zum statischen musl-Modus. Eine andere Sprache, die ein natives Linux-Programm nach diesem Vertrag erzeugt, kann über eine Binary-Adresse bereitgestellt werden, doch der Builder kompiliert sie nicht, und wir haben sie nicht getestet.