Un PaaS minimalista para aplicaciones nativas GraalVM y Python

Gluonify es un PaaS minimalista. Despliega aplicaciones nativas GraalVM (Quarkus, Spring Boot, Micronaut, Helidon…) y aplicaciones Python (FastAPI) en nodos Debian 13 sin administración: un token, una zona DNS delegada y el clúster se pone en marcha solo. WebSocket es el transporte estándar entre componentes; el estado del clúster se replica con Raft. Los propios componentes de Gluonify son aplicaciones Quarkus 4 nativas.

Componentes

Cada componente tiene su propio repositorio; los nombres siguen las partículas del modelo estándar.

Higgs — Orquestador

Orquestador: API de despliegue, scheduler, ingress TLS, DNS autoritativo, ACME, estado Raft, arranque de la pila, bloqueos de archivos, tokens de aplicación a servicio.

El bosón de Higgs es la excitación del campo de Higgs, el campo que da masa a las demás partículas elementales. Se observó en el CERN en 2012.

Higgs, el orquestador, es el campo en el que se apoya todo lo demás: da a cada aplicación su lugar y su peso en el clúster.

Strange — Agente de nodo

Agente de nodo: ejecuta las aplicaciones como unidades systemd aisladas, red, pasarela /distributed/*, relé de bloqueos. Una aplicación puede ser un ejecutable solo o un archivo .tar.gz (ejecutable, bibliotecas, paquetes del sistema por distribución que el agente instala). Deposita en un archivo de solo lectura de cada instancia los tokens de aplicación a servicio y los renueva.

El quark extraño (s) es un quark de segunda generación, con carga eléctrica −1/3. El gluón es el bosón de la interacción fuerte: une los quarks entre sí.

El agente une cada aplicación a su nodo, como los gluones unen los quarks.

Rup — Almacenamiento

Nodos de almacenamiento: objetos direccionados por SHA-256, archivos replicados, cuotas.

El quark up (u) es el más ligero de los quarks, con carga +2/3. Un protón contiene dos; este es el rojo.

El almacenamiento es uno de los dos quarks up del protón: un cimiento sobre el que se apoyan los demás componentes.

Bottom — Demonio FUSE (C)

Demonio FUSE en C (libfuse3): bloqueos de archivos entre nodos.

El quark bottom (b) es un quark de tercera generación, con carga −1/3, primo más pesado del quark down (observado en 1977).

La capa baja del sistema de archivos: el demonio bajo los montajes /distributed/*.

gDown — Base de datos de grafos

Base de datos de grafos replicada (Raft): charm, top, metadatos; openCypher y Bolt; las aplicaciones acceden a su base por Bolt con TLS (Bolt + OGM compatibles).

El quark down (d) tiene carga −1/3. Un protón contiene uno, junto con dos quarks up; este es el verde.

La base de datos de grafos es el quark más grande del logotipo: la memoria sobre la que descansa la plataforma.

¿Quiere saber más?

Top — Config y secretos

Top: configuración y secretos por aplicación, interfaz web Vue.

El quark top (t) es la partícula elemental conocida más pesada (unos 173 GeV/c²), con carga +2/3.

Top guarda lo más pesado que contiene una plataforma: los secretos.

Charm — Proveedor de identidad

Emisor de tokens JWT de corta duración (ES256) y proveedor OIDC mínimo.

El quark charm (c) es un quark de segunda generación, con carga +2/3, observado en 1974.

El proveedor de identidad da a cada programa el «encanto» de corta duración que hace que lo reconozcan.

Bup — Constructor

Builder: clon de Git, compilación nativa, publicación, despliegue. Cuando la compilación nativa produce bibliotecas, la aplicación se publica como archivo .tar.gz (ejecutable, bibliotecas, dependencias del sistema por distribución). El repositorio Maven de Sea, donde se publica el SDK de la plataforma, se añade a sus compilaciones Maven y Gradle, además de Maven Central: una aplicación cliente que depende del SDK se compila sin ningún ajuste. Transmite al orquestador los servicios que declara la aplicación (uses, base gDown dedicada).

El segundo quark up del protón; este es el azul. Los tres quarks de un protón llevan tres colores distintos que se anulan.

El constructor convierte su código en el artefacto que se despliega.

Photon — Pasarela de API

Pasarela de API y procesamiento de mensajes. El enrutamiento por dominio y ruta, los certificados por dominio, las políticas (direcciones, CORS, token de charm, límites de tasa) y la exposición de gDown están en Higgs, el orquestador; este componente trata los webhooks firmados, las transformaciones JSON/XML/formulario/ProtoBuf, una cola persistente y la entrega con reintentos, en varias réplicas.

El fotón (γ) es el bosón sin masa del electromagnetismo: transporta la luz y, con ella, la información.

La pasarela de API es la puerta de entrada por la que la luz del mundo exterior, sus peticiones, entra en la nube.

Field — Servidor de contenido estático

Servidor de contenido estático: los sitios se depositan en un ZIP y se sirven desde /distributed/std/<uuid>/ ; el sitio lo elige una cabecera firmada que pone el ingress, nunca el cliente.

Un campo cuántico es una magnitud definida en cada punto del espacio; las partículas son sus excitaciones.

El contenido estático, la materia, se hace disponible en toda la red gracias a esta aplicación.

Gauge — Piloto para IA (MCP)

Servidor MCP: permite a un asistente de IA desplegar, configurar y leer los registros de las aplicaciones mediante la API de la plataforma. Tokens de charm por aplicación con roles limitados, reglas definidas por el cliente, aprobación humana para producción y auditoría de cada acción. Una herramienta usage de solo lectura informa de la memoria y la CPU de las aplicaciones y de los componentes de la plataforma (una instantánea, nunca una base de facturación).

Los bosones de gauge son las partículas mediadoras de las fuerzas fundamentales. Son la manifestación concreta de las simetrías de gauge, que definen cómo interactúan entre sí las partículas de materia.

La interfaz transporta una fuerza: permite a la IA actuar sobre el clúster, pero esa acción queda filtrada y autorizada por la «ley de gauge» que fija el cliente (la configuración MCP), igual que un bosón de gauge está sometido a la simetría que lo define.

Calorimeter — Observabilidad

Observabilidad: conserva los registros y las métricas de cada aplicación más allá de la vida de un nodo, con un panel por aplicación y alertas. Se apoya en lo que Higgs y Strange ya exponen: diarios, /q/metrics y descubrimiento de Prometheus en /metrics/sd.

Un calorímetro es un detector de partículas que mide la energía absorbiendo las partículas capa tras capa: la energía que depositan revela lo que ha pasado.

La actividad de cada aplicación deposita su energía en el calorímetro en forma de registros y medidas: los absorbe, los guarda y permite leer lo que ha pasado.

Synchrotron — Consola de administración

Consola de administración: un servicio Quarkus nativo que sirve una interfaz Vue 3. Valida el token de Charm y reenvía cada llamada a las API de la plataforma (Higgs, Top, Charm, Photon, Bup) con el token de quien llama, mediante una lista de permitidos: nunca eleva privilegios.

Un sincrotrón es un acelerador circular de partículas: unos imanes curvan el haz mientras un campo eléctrico le añade energía en cada vuelta, hasta alcanzar la energía deseada.

Como la sala de control de un acelerador, la consola permite al operador inyectar energía en la plataforma (desplegar, escalar, despertar) y observar el haz, sin superar nunca los derechos de quien la usa.

Sea — Almacén de releases

Almacén de releases (images.gluonify.io): sirve los binarios nativos firmados que descargan install.sh y Strange. Archivos direccionados por su contenido, releases inmutables; la firma Ed25519 del manifiesto, verificada por el cliente, es la raíz de confianza, y una versión nunca puede retroceder (número de secuencia). También sirve el repositorio Maven de la plataforma (/maven/): lectura pública, publicación reservada al editor de la plataforma, versiones publicadas inmutables. El SDK de Java para las aplicaciones de los clientes se publica allí, y el builder añade este repositorio a sus compilaciones.

Dentro de un protón, además de los tres quarks de valencia, un « mar » de pares virtuales quark–antiquark y de gluones aparece y desaparece sin cesar: es buena parte de lo que compone el protón.

El mar rodea a los quarks que forman el protón; aquí el almacén rodea la plataforma con los binarios de que está hecha, y cada nodo toma de él lo que instala.

Fermion — Motor de workflows y reglas

Motor de workflows y reglas: workflows BPMN 2 y tablas de decisión DMN, guardados en Git (Bitbucket, GitLab) y ejecutados en el servidor. Las aplicaciones se conectan como nodos por un WebSocket permanente (el protocolo y un cliente están en el SDK de plasma), anuncian sus competencias y solo ejecutan tareas atómicas; Fermion reparte los pasos, gestiona reintentos, temporizadores e interruptores, y reanuda una ejecución fallida en su último paso. El estado y el historial están en gDown; las llamadas se autentican con tokens de Charm; interfaz web Vue en cinco idiomas. Por ahora, una única réplica activa. El envío de mensajes (correo, Teams, correo postal) se delega en Interfero, un nodo como los demás.

Un fermión es una partícula de espín semientero que obedece al principio de exclusión de Pauli: dos fermiones idénticos no pueden ocupar el mismo estado cuántico. Los quarks y los electrones son fermiones.

Un motor de workflows y reglas vive bajo la misma restricción: en cada instante una instancia ocupa un solo paso, una tarea se confía a un solo nodo, una decisión devuelve una respuesta determinista para una carga útil dada. De ahí el rigor del motor.

Crystallon — Conversión y generación de documentos

Servicio de documentos: convierte un documento dinámico en uno fijo, autónomo y archivable, y genera documentos nuevos. Conversión: las imágenes (BMP, JPEG, PNG, TIFF, WebP) pasan a PNG; los PDF pasan a PDF/A-1B (fuentes y perfil de color incrustados, metadatos XMP) y varios PDF pueden fusionarse en uno; no se conserva nada. Generación: un PDF se produce a partir de una plantilla JSON y de datos JSON (plantillas predefinidas de factura, presupuesto y carta, QR-bill suizo con validación estricta, PDF/A-1B bajo petición). Las plantillas se conservan por organización en una base gDown dedicada, con versiones, historial y restauración, junto con sus logotipos e imágenes (las imágenes SVG se dibujan en vectorial); una aplicación genera una plantilla por su nombre, o en una versión concreta, y cada error de validación indica dónde está en la plantilla. Un editor gráfico en la interfaz web (inglés, francés, español, italiano y alemán, tema claro y oscuro) maqueta la página: bloques añadidos y movidos con arrastrar y soltar, texto en segmentos con estilo, columnas, fuentes Inter y Helvetica, vista previa PDF en directo con datos de ejemplo. Cada organización puede además subir sus propias fuentes TrueType (licencia comprobada, confirmación de derechos obligatoria, cuatro variantes por familia, cuotas): las plantillas las usan como las del motor y se incrustan en el PDF/A-1B. Su pestaña Código da a una aplicación lo que necesita: el esquema de los datos que lee la plantilla (JSON Schema) y código Java generado, records y una fachada basados en el SDK de Java, distribuido por el repositorio Maven de Sea. El acceso se hace con un token de Charm (audiencia gluonify-crystallon), con un rol por función: render para generar documentos, convert para convertirlos, templates para gestionarlos. Una aplicación que declara crystallon en uses recibe de la plataforma un token render de corta duración, renovado sin reinicio; una persona conectada también puede transmitir el suyo. Los secretos de los proveedores de pago se leen del almacén Top. La conversión de imágenes AVIF y HEIC se hace con herramientas externas (avifdec, heif-convert) que deben estar instaladas en el nodo; sin ellas el servicio responde 503. Se entrega como archivo de aplicación con sus bibliotecas.

Un cristal es un sólido cuyos átomos ocupan una red regular, repetida en todas las direcciones: un líquido que se enfría se fija en ese orden.

El servicio hace lo mismo con un documento: una foto, un PDF producido por cualquier herramienta o varios PDF por ensamblar se fijan en un formato estable que no depende de ningún lector.

Interfero — Envío de mensajes

Envío de mensajes: una API REST nativa (Quarkus, tokens de Charm, estado en gDown) que reúne el correo electrónico (SMTP), Teams (webhook de Workflows), seis mensajerías (WhatsApp Business mediante la API Cloud de Meta con plantillas aprobadas, Telegram, Slack, Discord, LINE, Viber; credenciales por organización en Top, solo hosts oficiales) y el correo postal (PDF generado por Crystallon y entregado a un proveedor postal; por ahora solo existe un proveedor de depósito, ningún transportista real) detrás de una sola interfaz. Es un nodo de Fermion que anuncia SEND_MSG_EMAIL, SEND_MSG_TEAMS y SEND_MSG_POST, y mantiene las plantillas de mensajes (versiones, vista previa, registro de envíos); la vista Templates está en Fermion. Sus llamadas a Crystallon y a Fermion usan los tokens de aplicación que proporciona la plataforma, sin configurar nada.

Un interferómetro superpone ondas procedentes de varias fuentes y lee la figura que forman juntas, algo que una sola onda no mostraría.

La API superpone varios canales (correo, Teams, mensajerías, correo postal) en una sola interfaz, como un interferómetro combina varias ondas en una sola lectura.

El clúster

Cómo encajan los componentes. Los números del esquema remiten a la lista de abajo.

  1. Los visitantes llegan a su aplicación a través de Higgs: HTTPS con certificados automáticos y los nombres DNS que sirve.
  2. Higgs y cada agente Strange mantienen un WebSocket abierto: Higgs envía el estado deseado y los secretos, el agente informa de la salud.
  3. Higgs reenvía cada petición a una instancia lista de su nodo (Photon, Field o su aplicación); para un sitio estático añade una cabecera firmada que nombra el sitio.
  4. Strange lanza cada aplicación como una unidad systemd aislada, en su propio espacio de red.
  5. Las aplicaciones, incluidos Photon y Field (Field lee allí los sitios), leen y escriben /distributed mediante Bottom (FUSE) y rclone.
  6. Los archivos se guardan en varias copias en los nodos de almacenamiento Rup.
  7. Las aplicaciones usan los servicios de la plataforma: gDown para los datos, Charm para los tokens de identidad, Top para la configuración y los secretos.
  8. Charm y Top guardan sus datos en gDown, con claves y secretos cifrados.
  9. Bup clona el repositorio Git donde está su código, escrito por usted o por un asistente de IA.
  10. Bup construye el ejecutable nativo y pide a Higgs que lo despliegue.
  11. Un asistente de IA maneja la plataforma mediante Gauge (MCP).
  12. Gauge actúa sobre Bup y Higgs con tokens de Charm limitados, dentro de las reglas fijadas por el cliente.
  13. El Calorímetro conserva los registros y las métricas que Strange recoge de cada aplicación y que Higgs expone, y los convierte en paneles y alertas.
  14. El Synchrotron es la consola de administración: llama a la API de Higgs (y a las de los demás servicios) con el token de la persona conectada.
  15. Sea, fuera del clúster, sirve los binarios firmados que install.sh y Strange descargan para instalar y actualizar los nodos.

Una sola dirección para todas las interfaces

Higgs puede servir toda la plataforma detrás de una única dirección, por ejemplo https://gluonify.lan: la consola, las herramientas y la página de inicio de sesión comparten un solo host, cada una bajo su prefijo de ruta.

  • Higgs es el proxy inverso de esa dirección: rutas por prefijo de ruta, gana el prefijo más largo, una ruta / sirve de valor por defecto y se puede fijar una política (auth, cors, limits, ips) por ruta.
  • El ápice de la zona es un dominio: solo se acepta el nombre exactamente igual a la zona, nombres como api.gluonify.lan o el de una aplicación bajo la zona siguen reservados a la API y a las aplicaciones. Su certificado es el de la zona (ápice y comodín), obtenido por ACME; nunca se pide un segundo certificado para el ápice.
  • Rutas de desarrollo de tipo upstream: Higgs llama directamente a una dirección de destino (http o https), sin aplicación de Higgs, ubicación ni nodo, para un clúster de desarrollo cuyas interfaces son JVM en la máquina. Se retransmiten HTTP, HTTPS y WebSocket, se fijan las cabeceras X-Forwarded-* y el prefijo, y un destino detenido da un 502 JSON. En un clúster real las herramientas son aplicaciones de Higgs.
  • Los destinos de las rutas upstream deben estar en una lista permitida (bucle local y redes privadas por defecto), comprobada al guardar la ruta y en cada llamada; las direcciones de metadatos de las nubes se rechazan siempre.
  • Inicio de sesión único: Charm está en la raíz de la dirección y su cookie de sesión es la sesión única. Cada interfaz hace un intercambio silencioso (OIDC prompt=none) y solo muestra la página de inicio de sesión de Charm si no hay sesión. El cierre de sesión también es único: Charm termina la sesión a partir de un id_token_hint y de una dirección de retorno registrada.
  • Menú de herramientas: el paquete compartido gluonify-ui aporta AppSwitcher, un menú desplegable para pasar de una interfaz a otra, junto a los controles de idioma y tema. Lee el catálogo público GET /portal/apps.json que sirve Synchrotron y solo muestra las herramientas cuyos roles requeridos coinciden con los de la persona conectada. Este filtro es una comodidad: cada servicio aplica sus propios derechos.

Descrito en los README de Higgs y Charm. Límites: un destino HTTPS de una ruta upstream se verifica contra las autoridades de la JVM (sin prueba automática); no hay sonda de salud periódica, el estado de un destino se ve en la llamada (502).