tripoli.cloud/README.md
Adam Belkacemi 546734ad77 Phase 3 : tripoli-api (auth, fichiers, PostgreSQL)
- 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>
2026-09-16 22:43:02 +02:00

41 lines
2.5 KiB
Markdown

# Tripoli Cloud
Cloud personnel (photos, sauvegardes, partage de fichiers) construit pour
démontrer des compétences SRE proches de la stack de Clever Cloud (Rust,
netlink, WireGuard, CI/CD). **Un seul serveur, pas un cluster** — ce README
reste honnête sur ce qui est réellement en place vs prévu.
## Serveur
Hetzner CPX22 (2 vCPU, 3.7 Go RAM, 75 Go disque), Ubuntu 26.04, `65.109.142.188`
/ `tripoli.cloud`. **Ce serveur héberge déjà six autres projets en
production** (Forgejo, lecheminvert.tech, check-my-irve, iot-alarm-system,
voltvision, monitoring Prometheus/Grafana) derrière un Caddy partagé qui
tient les ports 80/443. Décision assumée : le futur `tripoli-edge` (Rust)
sera un service **interne**, derrière ce Caddy — pas un second frontal en
concurrence sur 80/443. Reprendre ces ports casserait les sites existants.
Pas de virtualisation imbriquée (KVM/QEMU) sur ce VPS Hetzner Cloud — non
tenté, non simulé.
## État réel
| Composant | État |
|---|---|
| Prototype frontend (`app/`) | Fait — React/TS/Vite/Tailwind, maquette |
| Reconnaissance serveur (Phase 0) | Fait |
| WireGuard (canal admin Mac ↔ serveur) | Fait — `10.100.0.0/24`, port 58212/udp (51820 filtré par le pare-feu Hetzner Cloud, voir `ansible/group_vars/all.yml`) |
| Pare-feu / fail2ban / unattended-upgrades | Déjà en place avant ce projet ; confirmés/complétés par Ansible |
| SSH public | Toujours ouvert (choix explicite, pas encore restreint au VPN) |
| Ansible (rôle de base) | Fait — `ansible/` |
| OpenTofu (serveur + DNS) | Code écrit — `tofu/` ; serveur en donnée en lecture seule (jamais recréé/détruit), DNS géré via le provider OVH. `plan`/`apply` pas encore exécutés (nécessitent des identifiants OVH/Hetzner non fournis) |
| `tripoli-edge` (Rust, Phase 2) | Fait et déployé en prod — `tripoli-edge/`, service systemd, derrière Caddy, vérifié via `https://tripoli.cloud/healthz` et `/metrics` |
| `tripoli-api` (Rust, Phase 3) | Fait et déployé en prod — `tripoli-api/`, auth par session (Argon2), upload/download, PostgreSQL dédié (Docker), vérifié via `https://tripoli.cloud/api/...` |
| `tripoli-netctl` (Rust, Phase 4) | Pas commencé |
| Observabilité dédiée (Phase 5) | Pas commencé (une stack Prometheus/Grafana existe déjà sur le serveur, partagée avec les autres projets) |
| Bird/BGP (Phase 6, bonus) | Pas commencé |
## Dépôt
Code poussé sur `forge.adam.belkacemi.me/adam/tripoli.cloud` (même
instance Forgejo que les autres projets hébergés sur ce serveur).