Python (FastAPI) en Gluonify

Gluonify también ejecuta aplicaciones Python: un servicio FastAPI se construye desde su repositorio Git, se firma como un ejecutable nativo y se ejecuta en el CPython 3.13 que Debian instala en los nodos, en el mismo sandbox que todas las demás aplicaciones.

Qué es compatible

  • CPython 3.13 de Debian 13, instalado en los nodos por la plataforma y mantenido al día con las actualizaciones de seguridad. Una aplicación solo se coloca en un nodo cuyo python3 tiene la misma versión menor.
  • FastAPI y uvicorn, incluidas ruedas compiladas como pydantic-core. El punto de entrada es [tool.gluonify] entry en pyproject.toml (ejecutado con python3 -m), o la única entrada de [project.scripts].
  • El SDK gluonify[fastapi]: tokens de Charm (verificación de los tokens recibidos, tokens de aplicación hacia los servicios), configuración y secretos de Top, y gDown mediante el driver neo4j sobre Bolt+TLS (bolt+s://, autoridad interna proporcionada; bolt:// sin cifrar rechazado).
  • "uses" deducido en el build: Bup lee las distribuciones instaladas sin importar nada (gluonify da charm, neo4j da gdown); gluonify.json sigue siendo opcional.
  • El puerto se da en la variable indicada en gluonify.json (PORT en la aplicación inicial) y la ruta de salud es la suya (/health/ready, /health/live en la aplicación inicial).

pyproject.toml: el punto de entrada

[project]
name = "my-service"
requires-python = "==3.13.*"
dependencies = ["gluonify[fastapi]"]

[tool.gluonify]
entry = "my_service.main"

Qué comprueba Bup

  • Un archivo de bloqueo: requirements.lock fijado con hashes (o exportado por uv export --frozen), instalado con pip --require-hashes, solo ruedas, solo desde el índice de la plataforma. Se rechazan las líneas editables, por ruta o por URL.
  • Un análisis Sonar de su código y reglas de llamadas peligrosas (eval, exec, pickle, shell=True, os.system, yaml.load sin SafeLoader): un repositorio que las infringe se rechaza antes de cualquier build.
  • pip-audit sobre las dependencias, con la misma política de organización que Maven y npm: una vulnerabilidad sin gravedad asignada cuenta como crítica.
  • Un archivo gzip firmado: un lanzador, su código compilado en .pyc y el site-packages del venv, sin pip; publicado, almacenado y firmado (procedencia Ed25519) exactamente como un ejecutable nativo.

El sandbox

Una aplicación Python se ejecuta en el mismo sandbox de systemd que una nativa: su propia cuenta, carpeta y red, ProtectSystem=strict, NoNewPrivileges, ninguna capacidad, un filtro seccomp y MemoryDenyWriteExecute=yes. CPython sin JIT nunca necesita memoria a la vez escribible y ejecutable, y las devoluciones de llamada de ctypes funcionan con esta protección. El intérprete arranca aislado (python3 -I -S -B): solo su código y el venv están en sys.path.

Reposo y despertar

El modo reposo funciona como para las aplicaciones nativas: una aplicación Python inactiva se detiene, y la siguiente petición por el ingress la despierta; la petición se retiene, no se pierde.

Cifras medidas

FastAPI y uvicorn sobre el CPython 3.13.5 del nodo, medidos el 2026-10-14 con un agente y un orquestador reales, en un contenedor Debian 13 con un systemd real.

  • arm64 (Apple M4 Max, Docker Desktop) — Archivo (gzip) 4.9 MB, Memoria (RSS) 48.6–48.7 MB, Despertar por petición 0.61 s

Medido en arm64 (Apple M4 Max), un servicio mínimo, pocos ensayos por caso. La duración y la memoria del build aún no se han medido.

La aplicación inicial

gluonify-source-python es la aplicación inicial en Python: el mismo servicio que gluonify-source (REST, Charm, Top, gDown, salud), con su pyproject.toml y su archivo de bloqueo. Supera 29 de 29 comprobaciones de extremo a extremo en un clúster real: tokens de Charm, Top, gDown sobre Bolt+TLS, uses deducidos, reposo y despertar.

Límites

  • El SDK gluonify[fastapi] aún no está en PyPI. Mientras tanto se instala desde su repositorio, algo que la regla del archivo de bloqueo de Bup no acepta en un build real.
  • Solo Python 3.13: ninguna otra versión de Python, porque el intérprete es el de los nodos.
  • Sin JIT para extensiones C, ni el JIT experimental de CPython: MemoryDenyWriteExecute prohíbe la memoria escribible y ejecutable.