Frameworks construidos desde su repositorio
El constructor lee su pom.xml, reconoce el framework y lanza la compilación nativa adecuada en un contenedor que contiene GraalVM 25 y Maven. No tiene que indicar qué framework usa.
| Framework | Compilación nativa (Maven) | Variable del puerto | Ruta de salud | Dependencia exigida | Verificado 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 es el framework de la propia plataforma. Spring Boot requiere la versión 3 o posterior (procesamiento anticipado, AOT). Helidon 4.2.0 falla con GraalVM 25: use 4.5.5 o posterior. La ruta de salud de Helidon 3 es /health/ready.
Aportar su aplicación: desde Git
Desde Git: el constructor clona el repositorio, compila el ejecutable nativo, lo publica con su SHA-256 y lo despliega; después comprueba la ruta de salud (y el tiempo de despertar cuando el modo reposo está activo).
Lo que debe hacer su aplicación
- Ser un ejecutable nativo para Linux: glibc 2.34 o posterior por defecto, o musl estático para las imágenes más pequeñas. Un ejecutable por arquitectura (arm64 y x86_64).
- Escuchar en el puerto que le da la plataforma (la variable de arriba se proporciona) y responder 200 en la ruta de salud cuando está lista: una instancia que no responde no recibe tráfico.
- No necesitar ni una JVM ni memoria ejecutable escribible: las aplicaciones se ejecutan en un entorno aislado con su propia cuenta, carpeta y red, sin capacidades y con un filtro seccomp.
Detección y gluonify.json
El framework se lee en el pom.xml del módulo y de sus padres. El orden de prioridad es la petición, luego un gluonify.json opcional en la raíz del módulo y, por último, la detección. Si se encuentran varios frameworks, la compilación se detiene y le pide que elija.
{"framework": "spring-boot", "port": 8080, "health": "/actuator/health", "portEnv": "SERVER_PORT"}Bibliotecas para su aplicación: el repositorio Maven
La plataforma publica las bibliotecas Java que sus servicios ofrecen a las aplicaciones en un repositorio Maven servido por Sea: https://images.gluonify.io/maven. La lectura es pública y sin cuenta; solo el editor de la plataforma publica, y una versión publicada no cambia nunca. El builder añade este repositorio a las compilaciones Maven y Gradle que lanza, junto a Maven Central: no hay nada que configurar en la plataforma; en su equipo y en su integración continua, declárelo usted mismo. Las bibliotecas son el cliente Java de Crystallon (producir un PDF a partir de una plantilla conservada, designada por su nombre, con código generado para los datos que espera) y, desde la 0.6.1, el SDK sin configuración: para una aplicación Quarkus, gluonify-plasma-quarkus lo aporta todo, y gluonify-plasma-testing da servicios falsos a las pruebas.
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")
}El groupId es io.gluonify.plasma. La versión es la de la plataforma (0.7.2 en el momento de redactar). Solo las dependencias de su aplicación se resuelven en este repositorio, no los plugins de Maven o Gradle. Una aplicación con crystallon en "uses" (deducido por Bup del módulo del SDK, o declarado) recibe de la plataforma la dirección de Crystallon y un token de Charm de corta duración con el rol render: el agente del nodo lo deposita en un archivo de solo lectura, lo renueva antes de que caduque sin reiniciar la aplicación, y el SDK lo lee por sí solo en cada llamada (CrystallonTokens.platform() es su forma estricta, para un cliente construido a mano); una aplicación que actúa en nombre de una persona conectada transmite en su lugar el token de esa persona. El token de aplicación lleva la organización por defecto de Crystallon.
Sin configuración
Llegar a un servicio de la plataforma requiere 0 líneas de configuración: ni URL, ni token, ni propiedad. La aplicación inyecta el cliente (gluonify-plasma-quarkus) y el SDK (gluonify-plasma-services) encuentra la dirección y el token según dónde se ejecuta la aplicación. Hoy cubre Crystallon y Fermion. El orden es el mismo para cada servicio:
- Una sobrecarga explícita, para las pruebas: GLUONIFY_SERVICE_<APP>_URL y GLUONIFY_<APP>_TOKEN como propiedades del sistema.
- En la plataforma: la dirección y el token de aplicación que la plataforma proporciona para cada servicio de "uses". Desde el SDK 0.7.1, Bup deduce "uses" en el build: cada módulo cliente del SDK lleva un marcador (META-INF/gluonify/services/<servicio>) y Bup añade el servicio como opcional (?crystallon). Nada que escribir; gluonify.json solo añade lo que el SDK no detecta, como una llamada HTTP directa a otra aplicación o Charm para OIDC. Si falta el servicio, el mensaje dice por qué.
- En su equipo: tras gluonify login <zona> (gluonify.lan para el clúster de desarrollo), las direcciones públicas del documento https://<zona>/.well-known/gluonify y su token de desarrollador, renovado por sí solo. Este documento está desactivado en producción por defecto.
- Si no, un error claro que dice qué hacer: gluonify login, o servicios falsos en las pruebas.
En su equipo (desarrollo), una vez
gluonify login gluonify.lan # once, in your browser (PKCE): the SDK then finds the services of the zone
En la plataforma (producción): nada que declarar
# nothing to declare: Bup detects the SDK modules at build time # gluonify-plasma-crystallon-client -> "uses": ["?crystallon"] (optional service)
Solo para añadir: gluonify.json
{"uses": ["charm", "orders"]}En el código (Quarkus)
@Inject CrystallonClient crystallon; // no URL, no token, no property: 0 lines of configuration
RenderedPdf pdf = crystallon.byName("Gluonify invoice").render(payload);gluonify es la línea de comandos del SDK (jar gluonify-plasma-cli: login, logout, status, token). El inicio de sesión se hace en el navegador, en Charm, con PKCE: ninguna contraseña pasa por la línea de comandos. En las pruebas, GluonifyTestServices.start() (gluonify-plasma-testing) arranca un Crystallon falso en memoria, sin nada que configurar. La aplicación de partida gluonify-source hace exactamente esto.
Límites
Se construyen proyectos Maven y Gradle (DSL Groovy o Kotlin), framework por framework según la matriz de soporte del builder. Las bibliotecas con código nativo (AWT, RocksDB, GSSAPI, PKCS#11) no convienen al modo musl estático. Otro lenguaje que produzca un ejecutable nativo de Linux que cumpla el contrato puede desplegarse desde la dirección de un binario, pero el constructor no lo compila y no lo hemos probado.