Runbook — exploiter MyPrptGen

Déployer une nouvelle version

Depuis /root/Projets/MyPrptGen sur le VPS :

COMPOSE_DISABLE_ENV_FILE=1 docker compose config
COMPOSE_DISABLE_ENV_FILE=1 docker compose up -d --build
docker inspect myprptgen --format '{{.State.Status}} {{if .State.Health}}{{.State.Health.Status}}{{end}}'

Vérifier que tout va bien

docker logs --tail 50 myprptgen
curl -s -o /dev/null -w '%{http_code}\n' https://prp.numeriques-technologies.site/login

Attendu : conteneur running, santé healthy, page de connexion en 200.

Revenir en arrière

Identifier le dernier commit sain dans le dépôt.
Revenir dessus sur la branche de déploiement, puis relancer la séquence de déploiement ci-dessus.
Vérifier de nouveau les journaux et la page de connexion.

Le retour arrière n’efface pas les données : l’historique et la bibliothèque vivent dans le navigateur des utilisateurs.

Casse connue et gestes associés

Page blanche après déploiement : service worker servant un cache ancien — le bouton « Mettre à jour » dans l’application force la purge et le rechargement.
Bouton d’installation PWA absent : normal sur iOS (le navigateur n’émet pas d’événement) et lorsque l’application est déjà installée. C’est une règle d’interface assumée : on masque un contrôle sans capacité.
Débordement horizontal signalé sur mobile : mesurer avant de corriger ; les correctifs à l’estime se sont déjà contredits.

Règles d’intervention

Ne jamais déployer depuis une machine qui ne porte pas la production sans le dire.
Aucune correction directe en production : item de roadmap, branche, tests, déploiement.
Les secrets (hash du mot de passe, secret de session) vivent dans l’environnement du conteneur, jamais dans le dépôt ni dans ce wiki.