7.1 KiB
7.1 KiB
Déploiement de la Bêta JobRunner (Appliqué en production le 29/10/2026)
Ce document décrit l'architecture déployée et les procédures d'exploitation pour la bêta testeurs de JobRunner.
1. Architecture en Production
INTERNET
│
▼
┌────────────────────────┐
│ VPS cornafsuisse │
│ IP : 179.237.102.233 │
│ Caddy (TLS Let's Enc) │
└───────────┬────────────┘
│
┌────────────────────────────┴────────────────────────────┐
│ │
admin.jobrunner.fr jobrunner.fr
(HTTP Basic Auth) www. / beta.jobrunner.fr
│ │
┌───────┴───────────────┐ │
│ Fichiers statiques │ │
│ /srv/jobrunner.fr │ │
│ (Espace projet) │ │
└───────┬───────────────┘ │
│ │
│ Route /_admin/api/* │
│ (en-tête X-Admin: 1) │
▼ ▼
Tunnel WireGuard wg2 (chiffré) Tunnel WireGuard wg2 (chiffré)
│ │
└────────────────────────────┬────────────────────────────┘
│
▼
┌────────────────────────┐
│ cornafserver (maison) │
│ IP wg2 : 10.88.88.2 │
│ nftables : port 8830 │
│ Service systemd user │
│ jobrunner-beta │
│ SQLite beta.sqlite │
└────────────────────────┘
2. Configuration DNS (Infomaniak)
| Enregistrement | Type | Cible | Rôle |
|---|---|---|---|
jobrunner.fr |
A |
179.237.102.233 |
Bêta publique (redirigée vers /__beta/gate) |
www.jobrunner.fr |
A |
179.237.102.233 |
Alias web |
beta.jobrunner.fr |
A |
179.237.102.233 |
Sous-domaine dédié bêta |
admin.jobrunner.fr |
A |
179.237.102.233 |
Espace projet & générateur de codes (accès restreint) |
3. Configuration Caddy (cornafsuisse)
Fichier : /etc/caddy/Caddyfile
Espace projet & API Admin :
admin.jobrunner.fr {
import /etc/caddy/jobrunner-auth.caddy
import /etc/caddy/securite.caddy
log {
format filter {
wrap json
fields {
request>remote_ip delete
request>client_ip delete
request>headers>X-Forwarded-For delete
request>headers>X-Real-Ip delete
}
}
}
encode zstd gzip
handle /_admin/api/* {
reverse_proxy 10.88.88.2:8830 {
header_up Host admin.jobrunner.fr
header_up X-Admin 1
header_up X-Forwarded-For {remote_host}
header_up X-Forwarded-Proto https
}
}
handle {
root * /srv/jobrunner.fr
file_server
}
}
Bêta publique :
jobrunner.fr, www.jobrunner.fr, beta.jobrunner.fr {
import /etc/caddy/securite.caddy
header {
X-Robots-Tag "noindex, nofollow, noarchive"
-Server
}
encode zstd gzip
reverse_proxy 10.88.88.2:8830 {
header_up Host {host}
header_up X-Forwarded-For {remote_host}
header_up X-Forwarded-Proto https
}
}
4. Configuration Serveur (cornafserver)
Pare-feu nftables :
Fichier : /etc/nftables.d/filtre_hote.nft
Le port 8830 est autorisé uniquement depuis l'interface WireGuard wg2 :
table inet filtre_hote {
set tcp_wg2 {
type inet_service
flags interval
elements = { 22, 8000, 8095, 8830 }
}
}
Service systemd utilisateur :
Fichier : ~/.config/systemd/user/jobrunner-beta.service
- Écoute :
0.0.0.0:8830(joignable par wg2 uniquement) - Répertoire de travail :
/home/cornaf2049/jobrunner-beta - Variables d'environnement :
BETA_DATA=/home/cornaf2049/jobrunner-beta-data - Droits SQLite :
0600surbeta.sqlite,0700sur~/jobrunner-beta-data
5. Exploitation & Gestion des Codes
Depuis l'interface web (recommandé) :
Rendez-vous sur https://admin.jobrunner.fr :
- Connectez-vous avec vos identifiants d'administration.
- Dans la section Gestion de la Bêta, saisissez le nom ou la référence du testeur (ex. Thomas D. (WhatsApp)).
- Choisissez la durée de validité (30 jours, 60 jours, 90 jours ou illimitée).
- Cliquez sur Créer le code.
- Le code
JRB-XXXX-XXXX-XXXXs'affiche immédiatement avec :- Un bouton pour copier le code seul.
- Un bouton pour copier le message d'invitation pré-rempli pour WhatsApp ou SMS.
En ligne de commande sur cornafserver :
# Lister les codes actifs
python3 ~/jobrunner-beta/beta/codes.py liste
# Créer un code en CLI
python3 ~/jobrunner-beta/beta/codes.py generer --label "Testeur X" --jours 30
# Révoquer un code immédiatement
python3 ~/jobrunner-beta/beta/codes.py revoquer <ID>
# Consulter le journal d'activité
python3 ~/jobrunner-beta/beta/codes.py journal
# Consulter les retours testeurs reçus
python3 ~/jobrunner-beta/beta/codes.py retours
Maintenance du service :
# Vérifier l'état du service
systemctl --user status jobrunner-beta
# Redémarrer après mise à jour
systemctl --user restart jobrunner-beta
# Consulter les logs en direct
journalctl --user -u jobrunner-beta -f -n 50
6. Procédure de Retour Arrière (Rollback)
En cas de besoin de suspension temporaire ou définitive :
- Couper le reverse proxy sur
cornafsuisse: Restaurer la sauvegarde Caddy/root/sauvegardes/caddy/Caddyfile.avant-admin-jobrunner-20261029-105849et recharger Caddy (caddy reload). - Stopper le service sur
cornafserver:systemctl --user stop jobrunner-beta - Fermer le port au pare-feu :
Retirer le port 8830 de
/etc/nftables.d/filtre_hote.nftet recharger nftables.