Mettre à jour DumbMonit

DumbMonit vous prévient quand une version plus récente existe et vous guide dans la mise à jour. Il n’installe jamais rien de lui-même.

Repérer une nouvelle version

Une fois par jour au plus, le serveur interroge l’API publique des releases de GitHub (api.github.com/repos/laupernoe/dumbmonit/releases) pour connaître la dernière release et la compare à la version que vous utilisez. Les pré-versions comme 0.1.0-alpha.7 sont comparées correctement : alpha.10 est plus récent que alpha.9, et 0.1.0 est plus récent que n’importe quel 0.1.0-alpha.N. Les brouillons sont ignorés, et une instance sur une version stable ne se voit jamais proposer de pré-version.

Quand une version plus récente existe, Mise à jour disponible : vX apparaît en bas à droite de chaque page et dans Réglages → À propos, où Comment mettre à jour ouvre les étapes ci-dessous et Voir les nouveautés rouvre la fenêtre Nouveautés. Vérifier maintenant relance la vérification immédiatement (au plus une fois par minute).

Désactiver la vérification

Pour les réseaux isolés (air-gapped), désactivez Vérifier les nouvelles versions dans Réglages → À propos (administrateurs), ou définissez la variable d’environnement, qui l’emporte sur l’interrupteur :

environment:
  DUMBMONIT_UPDATE_CHECK: "off"

La même information est disponible pour les scripts et les jetons d’API sur GET /api/update.

Mettre à jour

Sauvegardez. Téléchargez une sauvegarde depuis Réglages → Sauvegarde, et conservez une copie de /data/secret.key (voir Sauvegarde et restauration). Sans cette clé, les mots de passe et jetons stockés ne peuvent pas être déchiffrés.
Récupérez l’image et redémarrez, depuis le dossier qui contient votre docker-compose.yml :
Fenêtre de terminal
```
docker compose pull && docker compose up -d
```
Vos données vivent dans le volume /data et sont conservées ; les migrations de base de données s’exécutent au démarrage.
Rechargez la page. Réglages → À propos affiche la nouvelle version et Vous êtes à jour.

Pour figer une version plutôt que de suivre :latest, changez le tag d’image dans le fichier Compose (par exemple ghcr.io/laupernoe/dumbmonit:0.1.0-alpha.7) et relancez la même commande.

Pour revenir en arrière, restaurez la sauvegarde prise à l’étape 1 sur l’image précédente.

Changements de configuration après une mise à jour

docker compose pull && docker compose up -d remplace l’image, mais votre docker-compose.yml vous appartient : DumbMonit ne le modifie jamais. Certaines versions demandent un changement à cet endroit, comme un port à publier ou une variable d’environnement à ajouter.

Quand une mise à jour en demande un, la première fois qu’un administrateur ouvre DumbMonit ensuite, une fenêtre liste ce qu’il faut changer, avec pour chacun le bloc à copier :

Terminé ferme le changement. Quand DumbMonit sait le vérifier (par exemple que le port des agents répond depuis le serveur), il vérifie d’abord et demande un second clic si la vérification échoue encore, car une redirection en boucle (NAT) ou un reverse proxy peut masquer un port qui fonctionne.
Je le ferai plus tard masque la fenêtre. Un rappel reste dans le coin de chaque page tant que vous ne l’avez pas fermé, et le fermer est définitif : un changement fermé ne revient jamais pour sa version.
Un changement qu’une vérification trouve manquant reste listé même si vous avez mis à jour il y a longtemps : une instance qui a sauté une étape dans une version antérieure est rattrapée.

Réglages → À propos → Changements de configuration → Voir la liste montre tous les changements demandés par une version (à faire, fermés, ou inutiles sur cette instance) avec leur bloc, quand vous voulez les relire. Seuls les administrateurs la voient, et elle est coupée dans la démo publique.

Depuis	Changement	Que faire
0.14.0	Canal chiffré des agents	Publier le port 8443 : ajoutez `"8443:8443"` aux `ports` du service `dumbmonit` (voir Sécurité du canal des agents).

Une installation neuve n’a rien à changer. L’instance enregistre au démarrage la version qu’elle exécute et celle dont elle vient, et les changements fermés font partie de la sauvegarde. Les scripts peuvent lire la liste sur GET /api/upgrade-notes (administrateur connecté, indisponible pour les jetons d’API).