- CLI (clap) : create/destroy/list. Network namespace créé via
rtnetlink::NetworkNamespace (fork + unshare(CLONE_NEWNET) + bind-mount,
équivalent de `ip netns add`), paire veth créée dans la racine, un
bout déplacé dans le namespace (setns_by_fd) et adressé depuis un
thread OS dédié qui fait setns() - jamais un thread du pool
spawn_blocking de tokio, qui serait réutilisé pour d'autres tâches et
resterait coincé dans le namespace.
- Journal d'audit JSON (stderr + /var/log/tripoli-netctl/audit.log) à
chaque opération.
- Documenté explicitement comme labo pédagogique un-seul-poste :
tripoli-edge et tripoli-api restent nativement sur l'hôte, ce projet
ne pilote aucun trafic de production.
- Testé en conditions réelles sur le serveur : création, adressage des
deux côtés (dont lo, down par défaut dans un netns neuf), ping
traversant effectivement la veth, puis destruction propre (veth +
namespace) vérifiée par absence des interfaces et du namespace.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- axum + sqlx (requêtes runtime, pas les macros query! à vérification
compile-time - évite d'exiger une base joignable à chaque build).
- Auth par session opaque côté serveur (cookie HttpOnly/Secure/SameSite,
pas de JWT - révocation = suppression de ligne). Mots de passe
Argon2.
- Fichiers : upload multipart streamé chunk par chunk vers le disque
(jamais accumulé en mémoire - condition réelle d'une progression
d'upload non simulée), download streamé, blobs nommés par UUID
(le nom d'origine ne vit qu'en métadonnée).
- Stockage disque pour cette v1 (pas Object Storage - pas de bénéfice
réel pour un unique VPS avec 55 Go libres, ajouté sans complexité
inutile).
- PostgreSQL dans un conteneur Docker dédié, séparé de celui
d'iot-alarm-system (pas de couplage entre projets sans rapport).
- Déployé en prod sous systemd (même utilisateur système que
tripoli-edge), branché sur son upstream par défaut. Vérifié
bout-en-bout via https://tripoli.cloud/api/... : inscription,
connexion, upload, download, suppression, et les cas d'erreur
(401 sans session, 409 email déjà pris, 401 mauvais mot de passe,
404 double suppression).
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- tripoli-edge (hyper/tokio bas niveau, pas de framework type axum) :
/healthz, /metrics (Prometheus, compteurs à la main), reverse-proxy
vers tripoli-api avec vrais 502 tant que ce service n'existe pas
(Phase 3), logs JSON structurés par requête.
- Écoute sur 127.0.0.1 + 172.17.0.1 (passerelle docker0), jamais sur
l'interface publique - même pattern que le Nginx de VoltVision déjà
sur ce serveur.
- Déployé en prod : systemd (utilisateur système dédié, sans privilège),
bloc Caddy ajouté pour tripoli.cloud/www.tripoli.cloud, règle ufw
ajoutée (Ansible) pour que Caddy puisse joindre le port 9000 - sans
quoi le chemin INPUT de l'hôte bloque le trafic inter-bridges même
vers 172.17.0.1.
- Vérifié bout-en-bout via https://tripoli.cloud, sans régression sur
les 6 autres domaines déjà servis par ce Caddy.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- Reconnaissance : le serveur héberge déjà 6 autres projets derrière un
Caddy partagé (80/443) ; tripoli-edge sera un service interne (décision
prise avec l'utilisateur), pas un second frontal.
- WireGuard : canal admin Mac <-> serveur (10.100.0.0/24, port 58212/udp
après avoir découvert que 51820 était filtré par le pare-feu Hetzner
Cloud, distinct de ufw).
- Ansible : rôle base (confirme fail2ban/unattended-upgrades/ufw déjà en
place, sans toucher aux règles des autres projets) + rôle wireguard
(clé privée générée sur la cible, jamais stockée dans ce dépôt).
- OpenTofu : serveur Hetzner référencé en data source lecture seule
(jamais recréé/détruit - serveur partagé et déjà en prod) ; DNS
tripoli.cloud géré via le provider OVH.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
