Technologies prises en charge

Gluonify exécute des exécutables natifs, sans JVM à l'exécution : toute application compilée en image native GraalVM. Les technologies prises en charge ne se limitent plus à Quarkus : Spring Boot, Micronaut et Helidon sont eux aussi construits depuis votre dépôt Git. Les applications Python (FastAPI) tournent sur le CPython 3.13 des nœuds.

Frameworks construits depuis votre dépôt

Le builder lit votre pom.xml, reconnaît le framework et lance la bonne compilation native dans un conteneur qui contient GraalVM 25 et Maven. Vous n'avez pas à dire quel framework vous utilisez.

FrameworkCompilation native (Maven)Variable du portChemin de santéDépendance exigéeVérifié avec
Quarkusmvn package -Dnative -Dquarkus.native.container-build=trueQUARKUS_HTTP_PORT/q/health/readyquarkus-smallrye-healthQuarkus 4
Spring Bootmvn -Pnative native:compileSERVER_PORT/actuator/healthspring-boot-starter-actuatorSpring Boot 4.0.8
Micronautmvn package -Dpackaging=native-imageMICRONAUT_SERVER_PORT/healthmicronaut-managementMicronaut 5.2.1
Helidonmvn package -Pnative-imageSERVER_PORT/observe/health/readyhelidon-webserver-observe-healthHelidon 4.5.5
Python (FastAPI)pip install --require-hashesPORT/health/readygluonify[fastapi]CPython 3.13.5 · FastAPI 0.115.12

Quarkus est le framework de la plateforme elle-même. Spring Boot demande la version 3 ou plus (traitement anticipé, AOT). Helidon 4.2.0 échoue sous GraalVM 25 : utilisez 4.5.5 ou plus. Le chemin de santé de Helidon 3 est /health/ready.

Apporter votre application : depuis Git

Depuis Git : le builder clone le dépôt, compile l'exécutable natif, le publie avec son SHA-256 et le déploie, puis contrôle le chemin de santé (et le temps de réveil quand le mode endormi est actif).

Ce que votre application doit faire

  • Être un exécutable natif pour Linux : glibc 2.34 ou plus par défaut, ou musl statique pour les images les plus petites. Un exécutable par architecture (arm64 et x86_64).
  • Écouter sur le port que la plateforme lui donne (la variable ci-dessus est fournie) et répondre 200 sur le chemin de santé quand elle est prête : une instance qui ne répond pas ne reçoit aucun trafic.
  • Ne nécessiter ni JVM ni mémoire exécutable inscriptible : les applications tournent dans un bac à sable avec leur propre compte, dossier et réseau, sans capacité et avec un filtre seccomp.

Détection et gluonify.json

Le framework est lu dans le pom.xml du module et de ses parents. L'ordre de priorité est la requête, puis un gluonify.json facultatif à la racine du module, puis la détection. Si plusieurs frameworks sont trouvés, le build s'arrête et vous demande de choisir.

{"framework": "spring-boot", "port": 8080, "health": "/actuator/health", "portEnv": "SERVER_PORT"}

Bibliothèques pour votre application : le dépôt Maven

La plateforme publie les bibliothèques Java que ses services offrent aux applications dans un dépôt Maven servi par Sea : https://images.gluonify.io/maven. La lecture est publique et sans compte ; seul l'éditeur de la plateforme publie, et une version publiée ne change jamais. Le builder ajoute ce dépôt aux builds Maven et Gradle qu'il lance, à côté de Maven Central : rien à configurer sur la plateforme ; sur votre poste et dans votre intégration continue, déclarez-le vous-même. Les bibliothèques sont le client Java de Crystallon (produire un PDF à partir d'un modèle conservé, désigné par son nom, avec du code généré pour les données qu'il attend) et, depuis la 0.6.1, le SDK sans configuration : pour une application Quarkus, gluonify-plasma-quarkus apporte tout, et gluonify-plasma-testing donne des faux services aux tests.

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")
}

Le groupId est io.gluonify.plasma. La version est celle de la plateforme (0.7.2 à la rédaction). Seules les dépendances de votre application sont résolues dans ce dépôt, pas les greffons Maven ou Gradle. Une application qui a crystallon dans "uses" (déduit par Bup du module du SDK, ou déclaré) reçoit de la plateforme l'adresse de Crystallon et un jeton Charm à courte durée avec le rôle render : l'agent du nœud le dépose dans un fichier en lecture seule, le renouvelle avant son expiration sans redémarrer l'application, et le SDK le lit tout seul à chaque appel (CrystallonTokens.platform() en est la forme stricte, pour un client construit à la main) ; une application qui agit pour une personne connectée transmet plutôt le jeton de cette personne. Le jeton d'application porte l'organisation par défaut de Crystallon.

Aucune configuration

Joindre un service de la plateforme demande 0 ligne de configuration : ni URL, ni jeton, ni propriété. L'application injecte le client (gluonify-plasma-quarkus) et le SDK (gluonify-plasma-services) trouve l'adresse et le jeton selon l'endroit où tourne l'application. Il couvre aujourd'hui Crystallon et Fermion. L'ordre est le même pour chaque service :

  1. Une surcharge explicite, pour les tests : GLUONIFY_SERVICE_<APP>_URL et GLUONIFY_<APP>_TOKEN en propriétés système.
  2. Sur la plateforme : l'adresse et le jeton d'application que la plateforme fournit pour chaque service de "uses". Depuis le SDK 0.7.1, Bup déduit "uses" au build : chaque module client du SDK porte un marqueur (META-INF/gluonify/services/<service>) et Bup ajoute le service en facultatif (?crystallon). Rien à écrire ; gluonify.json n'ajoute que ce que le SDK ne détecte pas, comme un appel HTTP direct à une autre application ou Charm pour OIDC. Si le service manque, le message dit pourquoi.
  3. Sur votre poste : après gluonify login <zone> (gluonify.lan pour le cluster de développement), les adresses publiques du document https://<zone>/.well-known/gluonify et votre jeton de développeur, renouvelé tout seul. Ce document est désactivé en production par défaut.
  4. Sinon, une erreur claire qui dit quoi faire : gluonify login, ou des faux services en test.

Sur votre poste (développement), une fois

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

Sur la plateforme (production) : rien à déclarer

# nothing to declare: Bup detects the SDK modules at build time
# gluonify-plasma-crystallon-client  ->  "uses": ["?crystallon"] (optional service)

Seulement pour les ajouts : gluonify.json

{"uses": ["charm", "orders"]}

Dans le code (Quarkus)

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

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

gluonify est la ligne de commande du SDK (jar gluonify-plasma-cli : login, logout, status, token). La connexion se fait dans le navigateur, chez Charm, par PKCE : aucun mot de passe ne passe par la ligne de commande. En test, GluonifyTestServices.start() (gluonify-plasma-testing) démarre un faux Crystallon en mémoire, sans rien à configurer. L'application de départ gluonify-source fait exactement cela.

Limites

Les projets Maven et Gradle (DSL Groovy ou Kotlin) sont tous deux construits, framework par framework comme le dit la matrice de prise en charge du builder. Les bibliothèques à code natif (AWT, RocksDB, GSSAPI, PKCS#11) ne conviennent pas au mode musl statique. Un autre langage qui produit un exécutable natif Linux respectant le contrat peut être déployé depuis l'adresse d'un binaire, mais le builder ne le compile pas et nous ne l'avons pas testé.