Python (FastAPI) su Gluonify

Gluonify esegue anche applicazioni Python: un servizio FastAPI viene costruito dal suo repository Git, firmato come un eseguibile nativo, e gira sul CPython 3.13 che Debian installa sui nodi, nella stessa sandbox di tutte le altre applicazioni.

Cosa è supportato

  • CPython 3.13 di Debian 13, installato sui nodi dalla piattaforma e mantenuto aggiornato con gli aggiornamenti di sicurezza. Un'applicazione viene collocata solo su un nodo il cui python3 ha la stessa versione minore.
  • FastAPI e uvicorn, comprese ruote compilate come pydantic-core. Il punto di ingresso è [tool.gluonify] entry in pyproject.toml (eseguito con python3 -m), oppure l'unica voce di [project.scripts].
  • L'SDK gluonify[fastapi]: token di Charm (verifica dei token ricevuti, token di applicazione verso i servizi), configurazione e segreti di Top, e gDown tramite il driver neo4j su Bolt+TLS (bolt+s://, autorità interna fornita; bolt:// in chiaro rifiutato).
  • "uses" dedotto al build: Bup legge le distribuzioni installate senza importare nulla (gluonify dà charm, neo4j dà gdown); gluonify.json resta facoltativo.
  • La porta è data nella variabile indicata in gluonify.json (PORT nell'applicazione di partenza) e il percorso di salute è il suo (/health/ready, /health/live nell'applicazione di partenza).

pyproject.toml: il punto di ingresso

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

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

Cosa controlla Bup

  • Un file di lock: requirements.lock fissato con hash (o esportato da uv export --frozen), installato con pip --require-hashes, solo ruote, solo dall'indice della piattaforma. Le righe modificabili, per percorso o per URL sono rifiutate.
  • Un'analisi Sonar del suo codice e regole sulle chiamate pericolose (eval, exec, pickle, shell=True, os.system, yaml.load senza SafeLoader): un repository che le viola è rifiutato prima di qualsiasi build.
  • pip-audit sulle dipendenze, con la stessa politica dell'organizzazione di Maven e npm: una vulnerabilità senza gravità assegnata conta come critica.
  • Un archivio gzip firmato: un lanciatore, il suo codice compilato in .pyc e il site-packages del venv, senza pip; pubblicato, conservato e firmato (provenienza Ed25519) esattamente come un eseguibile nativo.

La sandbox

Un'applicazione Python gira nella stessa sandbox systemd di una nativa: il suo account, la sua cartella e la sua rete, ProtectSystem=strict, NoNewPrivileges, nessuna capability, un filtro seccomp e MemoryDenyWriteExecute=yes. CPython senza JIT non ha mai bisogno di memoria insieme scrivibile ed eseguibile, e le callback di ctypes funzionano con questa protezione. L'interprete parte isolato (python3 -I -S -B): solo il suo codice e il venv sono su sys.path.

Sospensione e risveglio

La modalità sospensione funziona come per le applicazioni native: un'applicazione Python inattiva viene fermata, e la richiesta successiva tramite l'ingress la risveglia; la richiesta è trattenuta, non persa.

Valori misurati

FastAPI e uvicorn sul CPython 3.13.5 del nodo, misurati il 2026-10-14 con un agente e un orchestratore reali, in un container Debian 13 con un systemd reale.

  • arm64 (Apple M4 Max, Docker Desktop) — Archivio (gzip) 4.9 MB, Memoria (RSS) 48.6–48.7 MB, Risveglio su richiesta 0.61 s

Misurato su arm64 (Apple M4 Max), un servizio minimo, poche prove per caso. Durata e memoria del build non sono ancora misurate.

L'applicazione di partenza

gluonify-source-python è l'applicazione di partenza in Python: lo stesso servizio di gluonify-source (REST, Charm, Top, gDown, salute), con il suo pyproject.toml e il suo file di lock. Supera 29 controlli end-to-end su 29 su un cluster reale: token di Charm, Top, gDown su Bolt+TLS, uses dedotti, sospensione e risveglio.

Limiti

  • L'SDK gluonify[fastapi] non è ancora su PyPI. Nel frattempo si installa dal suo repository, cosa che la regola del file di lock di Bup non accetta per un build reale.
  • Solo Python 3.13: nessun'altra versione di Python, perché l'interprete è quello dei nodi.
  • Nessun JIT per le estensioni C, né il JIT sperimentale di CPython: MemoryDenyWriteExecute vieta la memoria scrivibile ed eseguibile.