Framework costruiti dal suo repository
Il builder legge il suo pom.xml, riconosce il framework e avvia la giusta compilazione nativa in un container che contiene GraalVM 25 e Maven. Non deve indicare quale framework usa.
| Framework | Compilazione nativa (Maven) | Variabile della porta | Percorso di salute | Dipendenza richiesta | Verificato con |
|---|---|---|---|---|---|
| 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 è il framework della piattaforma stessa. Spring Boot richiede la versione 3 o successiva (elaborazione anticipata, AOT). Helidon 4.2.0 fallisce con GraalVM 25: usi 4.5.5 o successiva. Il percorso di salute di Helidon 3 è /health/ready.
Portare la sua applicazione: da Git
Da Git: il builder clona il repository, compila l'eseguibile nativo, lo pubblica con il suo SHA-256 e lo distribuisce, poi controlla il percorso di salute (e il tempo di risveglio quando la modalità riposo è attiva).
Ciò che la sua applicazione deve fare
- Essere un eseguibile nativo per Linux: glibc 2.34 o successiva per impostazione predefinita, o musl statico per le immagini più piccole. Un eseguibile per architettura (arm64 e x86_64).
- Ascoltare sulla porta che la piattaforma le assegna (la variabile qui sopra è fornita) e rispondere 200 sul percorso di salute quando è pronta: un'istanza che non risponde non riceve traffico.
- Non richiedere né una JVM né memoria eseguibile scrivibile: le applicazioni girano in un ambiente isolato con account, cartella e rete propri, senza capability e con un filtro seccomp.
Rilevamento e gluonify.json
Il framework è letto dal pom.xml del modulo e dei suoi genitori. L'ordine di priorità è la richiesta, poi un gluonify.json facoltativo alla radice del modulo, poi il rilevamento. Se sono trovati più framework, la build si ferma e le chiede di scegliere.
{"framework": "spring-boot", "port": 8080, "health": "/actuator/health", "portEnv": "SERVER_PORT"}Librerie per la vostra applicazione: il repository Maven
La piattaforma pubblica le librerie Java che i suoi servizi offrono alle applicazioni in un repository Maven servito da Sea: https://images.gluonify.io/maven. La lettura è pubblica e senza account; solo l'editore della piattaforma pubblica, e una versione pubblicata non cambia mai. Il builder aggiunge questo repository alle compilazioni Maven e Gradle che avvia, accanto a Maven Central: nulla da configurare sulla piattaforma; sulla vostra macchina e nella vostra integrazione continua, dichiaratelo voi. Le librerie sono il client Java di Crystallon (produrre un PDF da un modello conservato, indicato per nome, con codice generato per i dati che si aspetta) e, dalla 0.6.1, l'SDK senza configurazione: per un'applicazione Quarkus, gluonify-plasma-quarkus porta tutto, e gluonify-plasma-testing dà servizi finti ai test.
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")
}Il groupId è io.gluonify.plasma. La versione è quella della piattaforma (0.7.2 al momento della stesura). Solo le dipendenze della vostra applicazione sono risolte da questo repository, non i plugin Maven o Gradle. Un'applicazione con crystallon in "uses" (dedotto da Bup dal modulo dell'SDK, o dichiarato) riceve dalla piattaforma l'indirizzo di Crystallon e un token Charm di breve durata con il ruolo render: l'agente del nodo lo deposita in un file di sola lettura, lo rinnova prima della scadenza senza riavviare l'applicazione, e l'SDK lo legge da solo a ogni chiamata (CrystallonTokens.platform() ne è la forma rigorosa, per un client costruito a mano); un'applicazione che agisce per conto di una persona connessa inoltra invece il token di quella persona. Il token di applicazione porta l'organizzazione predefinita di Crystallon.
Nessuna configurazione
Raggiungere un servizio della piattaforma richiede 0 righe di configurazione: né URL, né token, né proprietà. L'applicazione inietta il client (gluonify-plasma-quarkus) e l'SDK (gluonify-plasma-services) trova l'indirizzo e il token secondo il luogo in cui gira l'applicazione. Oggi copre Crystallon e Fermion. L'ordine è lo stesso per ogni servizio:
- Una sovrascrittura esplicita, per i test: GLUONIFY_SERVICE_<APP>_URL e GLUONIFY_<APP>_TOKEN come proprietà di sistema.
- Sulla piattaforma: l'indirizzo e il token di applicazione che la piattaforma fornisce per ogni servizio di "uses". Dall'SDK 0.7.1, Bup deduce "uses" al build: ogni modulo client dell'SDK porta un marcatore (META-INF/gluonify/services/<servizio>) e Bup aggiunge il servizio come facoltativo (?crystallon). Nulla da scrivere; gluonify.json aggiunge solo ciò che l'SDK non rileva, come una chiamata HTTP diretta a un'altra applicazione o Charm per OIDC. Se il servizio manca, il messaggio dice perché.
- Sulla vostra macchina: dopo gluonify login <zona> (gluonify.lan per il cluster di sviluppo), gli indirizzi pubblici del documento https://<zona>/.well-known/gluonify e il vostro token di sviluppatore, rinnovato da solo. Questo documento è disattivato in produzione per impostazione predefinita.
- Altrimenti, un errore chiaro che dice cosa fare: gluonify login, o servizi finti nei test.
Sulla vostra macchina (sviluppo), una volta
gluonify login gluonify.lan # once, in your browser (PKCE): the SDK then finds the services of the zone
Sulla piattaforma (produzione): nulla da dichiarare
# nothing to declare: Bup detects the SDK modules at build time # gluonify-plasma-crystallon-client -> "uses": ["?crystallon"] (optional service)
Solo per le aggiunte: gluonify.json
{"uses": ["charm", "orders"]}Nel codice (Quarkus)
@Inject CrystallonClient crystallon; // no URL, no token, no property: 0 lines of configuration
RenderedPdf pdf = crystallon.byName("Gluonify invoice").render(payload);gluonify è la riga di comando dell'SDK (jar gluonify-plasma-cli: login, logout, status, token). L'accesso avviene nel browser, presso Charm, con PKCE: nessuna password passa dalla riga di comando. Nei test, GluonifyTestServices.start() (gluonify-plasma-testing) avvia un Crystallon finto in memoria, senza nulla da configurare. L'applicazione di partenza gluonify-source fa esattamente questo.
Limiti
Vengono compilati progetti Maven e Gradle (DSL Groovy o Kotlin), framework per framework come indica la matrice di supporto del builder. Le librerie con codice nativo (AWT, RocksDB, GSSAPI, PKCS#11) non si adattano alla modalità musl statica. Un altro linguaggio che produce un eseguibile nativo Linux conforme al contratto può essere distribuito dall'indirizzo di un binario, ma il builder non lo compila e non l'abbiamo testato.