Fichiers
jobrunner-html/beta/deploiement/PLAN.md
T

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 : 0600 sur beta.sqlite, 0700 sur ~/jobrunner-beta-data

5. Exploitation & Gestion des Codes

Depuis l'interface web (recommandé) :

Rendez-vous sur https://admin.jobrunner.fr :

  1. Connectez-vous avec vos identifiants d'administration.
  2. Dans la section Gestion de la Bêta, saisissez le nom ou la référence du testeur (ex. Thomas D. (WhatsApp)).
  3. Choisissez la durée de validité (30 jours, 60 jours, 90 jours ou illimitée).
  4. Cliquez sur Créer le code.
  5. Le code JRB-XXXX-XXXX-XXXX s'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 :

  1. Couper le reverse proxy sur cornafsuisse : Restaurer la sauvegarde Caddy /root/sauvegardes/caddy/Caddyfile.avant-admin-jobrunner-20261029-105849 et recharger Caddy (caddy reload).
  2. Stopper le service sur cornafserver :
    systemctl --user stop jobrunner-beta
    
  3. Fermer le port au pare-feu : Retirer le port 8830 de /etc/nftables.d/filtre_hote.nft et recharger nftables.