Instalar la plataforma

De un host Debian 13 vacío a una plataforma en marcha: primero un orquestador y luego tantos nodos como quiera. Cada descarga se comprueba con un manifiesto firmado (Ed25519) y un SHA-256 antes de instalar nada.

Antes de empezar

  • Un host Debian 13 (o Ubuntu 22.04 y posteriores) con systemd, acceso root, una dirección IP pública y los puertos 80, 443 y 53 (TCP y UDP) abiertos: será el primer orquestador.
  • Una zona DNS para sus aplicaciones (por ejemplo apps.example.org), delegada con registros NS a esa IP pública: el orquestador responde por ella y obtiene los certificados TLS. Otros modos dejan la zona con usted (externo, Cloudflare).
  • Los tres ejecutables de la pila (gdown, charm, top) como direcciones HTTPS con su SHA-256: la plataforma ejecuta sus propios servicios como aplicaciones.
  • Opcionalmente, más hosts Debian: cada uno se convierte en nodo con un comando.

La confianza descansa en el certificado TLS de este sitio y en la huella anterior: pásela con --key-sha256 para que el script rechace cualquier otra clave.

1. El primer orquestador

El orquestador (Higgs): API, planificador, ingress, DNS, ACME y estado Raft. El comando descarga y comprueba la versión y luego ejecuta el instalador del rol de orquestador; todo lo que sigue al segundo -- se pasa al instalador. Con gluonify.higgs.stack.enabled, también despliega la pila por sí solo: gdown, luego la identidad y luego el top.

2. Comprobar que funciona

La pila arranca paso a paso y cada paso se comprueba sobre el estado real; un reinicio continúa donde se quedó. El token de administración está en un archivo legible solo por root.

3. Añadir nodos

Pida al orquestador un token de un solo uso; la respuesta contiene el comando que ejecutar en el nuevo host. El host abre una conexión saliente hacia el orquestador, ejecuta solo un catálogo cerrado de tareas firmadas y después se inscribe: no se abre ningún puerto en él.

4. Alta disponibilidad

Añada un segundo y un tercer orquestador del mismo modo (rol de orquestador): el orquestador que crea la solicitud entrega al nuevo miembro un token de unión estrecho, válido una vez durante 15 minutos, nunca el token de administración. Tres orquestadores siguen funcionando cuando se pierde uno.

5. Desplegar

A partir de aquí la plataforma está vacía y lista: despliegue sus aplicaciones con la API, la consola Synchrotron o la aplicación de partida gluonify-source.

Después: su aplicación, sin configuración

Una aplicación llega a los servicios de la plataforma con 0 líneas de configuración. En producción, nada que declarar: Bup detecta los módulos del SDK y rellena "uses" por sí solo; gluonify.json solo añade los servicios alcanzados fuera del SDK. En desarrollo, ejecute una vez gluonify login en su equipo (gluonify.lan para el clúster de desarrollo local, su zona si no). El SDK encuentra luego por sí solo la dirección y el token.

En su equipo, una vez

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

En el código

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

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

Lo que todavía no está automatizado

Los ejecutables de la pila aún no están en el almacén de versiones: constrúyalos (véase BOOTSTRAP.md) o alójelos en cualquier servidor HTTPS. gDown solo ya se instala con gDown.sh (página gDown).