Processus de rachat

Le processus de prise de contrôle migre atomiquement le trafic de nginx vers bext. Il arrête nginx, lie bext aux ports 80/443 et fournit une restauration automatique en cas d'échec.

Machine à états#

La reprise suit une machine à états stricte :

Preflight ──→ TakingOver ──→ Active
                  │              │
                  ▼              ▼
               Failed ←── RollingBack ──→ RolledBack

Séquence de reprise#

Lorsque vous cliquez sur « Reprendre » (ou POST sur /api/takeover ):

1. Vérifier les conditions préalables — la phase doit être un contrôle en amont, aucun échec de vérification critique
2. Phase de réglage = TakingOver — L'interface utilisateur affiche la superposition de chargement
3. Enregistrer l'état de nginx — indique si nginx a été activé pour le démarrage
4. Arrêt nginx — systemctl stop nginx
5. Attendre les ports — interroger les ports 80/443 pendant 3 secondes maximum

• Si les ports sont toujours occupés → restauration automatique, phase = Échec

6. Désactiver nginx — systemctl disable nginx (non fatal en cas d'échec)
7. Lier bext — commencer à servir sur les ports 80/443 avec la configuration nginx
8. Phase de réglage = Actif

Séquence de restauration#

Lorsque vous cliquez sur "Rollback" (ou POST sur /api/rollback ) :

1. Vérifier la phase — doit être actif ou en échec
2. Phase de réglage = RollingBack
3. Réactiver nginx — systemctl enable nginx (s'il a été activé auparavant)
4. Démarrage nginx — systemctl start nginx
5. Vérifiez — attendez 500 ms et vérifiez que nginx est en cours d'exécution

• Si nginx ne démarre pas → phase = Échec avec message d'erreur

6. Phase de réglage = RolledBack

Restauration automatique#

Si la reprise échoue après l'arrêt de nginx (par exemple, ports toujours occupés par un autre processus), bext exécute immédiatement :

systemctl start nginx

Cela garantit que le trafic n’est jamais laissé sans serveur. La phase est définie sur Échec et l'erreur est affichée dans le tableau de bord.

Conditions préalables#

• Accès root — nécessaire pour arrêter/démarrer les services et se lier aux ports < 1024
• systemd — le rachat utilise systemctl pour toute la gestion des services
• nginx.service — l'unité systemd nginx doit être nommée « nginx »

Garanties de sécurité#

1. Lecture seule pendant le contrôle en amont — aucune modification du système jusqu'à ce que vous déclenchiez explicitement la prise de contrôle
2. Confirmation requise — la reprise et la restauration nécessitent une confirmation de l'utilisateur
3. Transitions atomiques — si une étape échoue, la restauration automatique restaure immédiatement nginx
4. Démarrage préservé — L'état activé/désactivé de nginx est enregistré et restauré lors de la restauration
5. Le tableau de bord reste actif. — le serveur de contrôle en amont reste accessible sur son port pour un accès en cas de restauration, même après la reprise.
6. Aucune perte de données — la reprise gère uniquement le cycle de vie des processus, pas les fichiers de configuration

Utilisation via CLI#

# Launch with auto-detected config
sudo bext nginx-takeover

# Specify config and port
sudo bext nginx-takeover --nginx-config /etc/nginx/nginx.conf --port 9999

Référence des vérifications préalables au vol#

Toutes les vérifications critiques doivent être réussies avant que la prise de contrôle ne soit autorisée. Les avertissements non critiques sont informatifs : ils mettent en évidence les problèmes potentiels mais ne bloquent pas la migration.

En rapport#

• Tableau de bord de contrôle en amont — l'interface utilisateur qui pilote les boutons Take Over et Rollback
• Mode mascarade — le chemin alternatif qui évite du tout d'arrêter nginx
• Guide de migration — procédure pas à pas complète de migration ; le rachat est l’option B
• Aperçu de la compatibilité nginx — ce que bext analyse avant l'exécution de la prise de contrôle
• Opérations : invalidation et redémarrages — cycle de vie du service après le basculement