61 lines
2.4 KiB
Markdown
61 lines
2.4 KiB
Markdown
|
# tripoli-edge
|
||
|
|
|
||
|
|
Service Rust interne placé derrière le Caddy déjà en place sur le
|
||
|
|
serveur (voir `README.md` à la racine du dépôt pour le pourquoi : ce
|
||
|
|
Caddy tient déjà les ports 80/443 pour six autres domaines).
|
||
|
|
|
||
|
|
Ce que fait tripoli-edge, concrètement :
|
||
|
|
|
||
|
|
- `GET /healthz` : répond directement, sans toucher à tripoli-api.
|
||
|
|
- `GET /metrics` : métriques au format d'exposition Prometheus
|
||
|
|
(compteurs à la main, voir `src/metrics.rs`).
|
||
|
|
- Tout le reste : reverse-proxy vers `tripoli-api` (méthode, en-têtes et
|
||
|
|
corps conservés). Tant que `tripoli-api` n'existe pas (Phase 3), ça
|
||
|
|
répond un vrai `502 Bad Gateway`, pas une réponse simulée.
|
||
|
|
- Logs structurés JSON (`tracing` + `tracing-subscriber`) pour chaque
|
||
|
|
requête : méthode, chemin, host, statut, latence.
|
||
|
|
|
||
|
|
## Configuration (variables d'environnement)
|
||
|
|
|
||
|
|
| Variable | Défaut | Rôle |
|
||
|
|
|---|---|---|
|
||
|
|
| `TRIPOLI_EDGE_LISTEN` | `127.0.0.1:9000,172.17.0.1:9000` | Adresses d'écoute (jamais `0.0.0.0` — voir plus bas) |
|
||
|
|
| `TRIPOLI_API_UPSTREAM` | `127.0.0.1:8081` | Adresse de tripoli-api |
|
||
|
|
| `RUST_LOG` | — | Niveau de logs (`info`, `debug`, ...) |
|
||
|
|
|
||
|
|
`172.17.0.1` est la passerelle `docker0` du serveur : c'est ce qui permet
|
||
|
|
au conteneur Caddy (sur un réseau Docker différent) de joindre
|
||
|
|
tripoli-edge, qui tourne nativement sur l'hôte — même pattern que le
|
||
|
|
Nginx de VoltVision sur ce même serveur. tripoli-edge n'écoute jamais sur
|
||
|
|
l'interface publique.
|
||
|
|
|
||
|
|
## Déploiement (fait manuellement pour cette phase)
|
||
|
|
|
||
|
|
L'automatisation complète (build + déploiement via CI) est prévue dans
|
||
|
|
la section CI/CD du brief, pas encore faite. Pour l'instant, sur le
|
||
|
|
serveur :
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# build (rustc/cargo installés via apt)
|
||
|
|
cd /opt/tripoli-edge/src && cargo build --release
|
||
|
|
install -m 755 target/release/tripoli-edge /usr/local/bin/tripoli-edge
|
||
|
|
systemctl restart tripoli-edge
|
||
|
|
```
|
||
|
|
|
||
|
|
Le service tourne sous l'utilisateur système `tripoli` (sans shell,
|
||
|
|
sans privilège) via `deploy/tripoli-edge.service`, déjà installé dans
|
||
|
|
`/etc/systemd/system/`.
|
||
|
|
|
||
|
|
Le bloc Caddy est dans `deploy/Caddyfile.snippet` — ajouté à
|
||
|
|
`/opt/edge/Caddyfile` sur le serveur (fichier partagé, donc pas commité
|
||
|
|
dans son intégralité ici). Une règle `ufw` supplémentaire était
|
||
|
|
nécessaire pour que Caddy puisse joindre `172.17.0.1:9000` (voir
|
||
|
|
`ansible/roles/base/tasks/main.yml`).
|
||
|
|
|
||
|
|
## Vérifié en production
|
||
|
|
|
||
|
|
```
|
||
|
|
curl https://tripoli.cloud/healthz -> 200 "ok"
|
||
|
|
curl https://tripoli.cloud/metrics -> métriques Prometheus
|
||
|
|
```
|