Python (FastAPI) sur Gluonify

Gluonify exécute aussi des applications Python : un service FastAPI est construit depuis votre dépôt Git, signé comme un exécutable natif, et tourne sur le CPython 3.13 que Debian installe sur les nœuds, dans le même bac à sable que toutes les autres applications.

Ce qui est pris en charge

  • CPython 3.13 de Debian 13, installé sur les nœuds par la plateforme et tenu à jour par les mises à jour de sécurité. Une application n'est placée que sur un nœud dont le python3 a la même version mineure.
  • FastAPI et uvicorn, roues compilées comprises (pydantic-core par exemple). Le point d'entrée est [tool.gluonify] entry dans pyproject.toml (lancé par python3 -m), ou l'unique entrée de [project.scripts].
  • Le SDK gluonify[fastapi] : jetons Charm (vérification des jetons reçus, jetons d'application vers les services), configuration et secrets de Top, et gDown par le pilote neo4j en Bolt+TLS (bolt+s://, autorité interne fournie ; bolt:// en clair refusé).
  • « uses » déduit au build : Bup lit les distributions installées sans rien importer (gluonify donne charm, neo4j donne gdown) ; gluonify.json reste facultatif.
  • Le port est donné dans la variable nommée par gluonify.json (PORT dans l'application de départ) et le chemin de santé est le vôtre (/health/ready, /health/live dans l'application de départ).

pyproject.toml : le point d'entrée

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

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

Ce que Bup contrôle

  • Un fichier de verrou : requirements.lock épinglé avec empreintes (ou exporté par uv export --frozen), installé par pip --require-hashes, en roues seulement, depuis le seul index de la plateforme. Les lignes éditables, par chemin ou par URL sont refusées.
  • Une analyse Sonar de votre code, et des règles d'appels dangereux (eval, exec, pickle, shell=True, os.system, yaml.load sans SafeLoader) : un dépôt qui les enfreint est refusé avant tout build.
  • pip-audit sur les dépendances, avec la même politique d'organisation que Maven et npm : une vulnérabilité sans gravité notée compte comme critique.
  • Une archive gzip signée : un lanceur, votre code compilé en .pyc et le site-packages du venv, sans pip ; publiée, stockée et signée (provenance Ed25519) exactement comme un exécutable natif.

Le bac à sable

Une application Python tourne dans le même bac à sable systemd qu'une application native : son compte, son dossier et son réseau, ProtectSystem=strict, NoNewPrivileges, aucune capacité, un filtre seccomp, et MemoryDenyWriteExecute=yes. CPython sans JIT n'a jamais besoin de mémoire à la fois inscriptible et exécutable, et les rappels ctypes fonctionnent sous cette protection. L'interpréteur démarre isolé (python3 -I -S -B) : seuls votre code et le venv sont sur sys.path.

Mise en sommeil et réveil

Le mode endormi fonctionne comme pour les applications natives : une application Python inactive est arrêtée, et la requête suivante, par l'ingress, la réveille ; la requête est retenue, pas perdue.

Chiffres mesurés

FastAPI et uvicorn sur le CPython 3.13.5 du nœud, mesurés le 2026-10-14 avec un vrai agent et un vrai orchestrateur, dans un conteneur Debian 13 avec un vrai systemd.

  • arm64 (Apple M4 Max, Docker Desktop) — Archive (gzip) 4.9 Mo, Mémoire (RSS) 48.6–48.7 Mo, Réveil sur requête 0.61 s

Mesuré sur arm64 (Apple M4 Max), un service minimal, quelques essais par cas. La durée et la mémoire du build ne sont pas encore mesurées.

L'application de départ

gluonify-source-python est l'application de départ en Python : le même service que gluonify-source (REST, Charm, Top, gDown, santé), avec son pyproject.toml et son fichier de verrou. Elle passe 29 contrôles de bout en bout sur 29 sur un vrai cluster : jetons Charm, Top, gDown en Bolt+TLS, uses déduits, mise en sommeil et réveil.

Limites

  • Le SDK gluonify[fastapi] n'est pas encore sur PyPI. D'ici là, il s'installe depuis son dépôt, ce que la règle du fichier de verrou de Bup n'accepte pas pour un vrai build.
  • Python 3.13 seulement : aucune autre version de Python, car l'interpréteur est celui des nœuds.
  • Pas de JIT pour les extensions C, ni le JIT expérimental de CPython : MemoryDenyWriteExecute interdit la mémoire inscriptible et exécutable.