Aller au contenu

Mise à jour et déploiement

Ce guide explique comment passer à une nouvelle version de HeelonVault, puis, pour les administrateurs, comment réaliser une installation système sous Linux. Pour une première installation sur un poste, voir QUICKSTART.fr.md.

Activez Profil & Sécurité > Mises à jour de l’application > Vérifier automatiquement pour consulter la dernière version stable publiée sur GitHub, au démarrage et au plus une fois par 24 heures. Sans consentement, aucun contrôle automatique n’est effectué. Vérifier permet un contrôle ponctuel même si cette option est désactivée.

Le bandeau Découvrir la version ouvre les notes et téléchargements officiels dans votre navigateur ; Plus tard le masque pour la session de l’application. Une connexion indisponible n’est jamais présentée comme une absence de mise à jour. GitHub reçoit l’adresse IP, mais aucune donnée de coffre, de compte ou de licence. L’application n’installe rien et ne vérifie pas elle-même les paquets : les étapes ci-dessous restent nécessaires.

  1. Faites un export chiffré .hvb de vos coffres depuis Profil & Sécurité > Gestion des données, et conservez-le hors du poste.
  2. Notez la version installée (en-tête du journal des modifications) et lisez les sections des versions intermédiaires, en particulier les « Changements incompatibles ».
  3. Fermez HeelonVault.

Les évolutions du schéma de base sont appliquées automatiquement au premier lancement de la nouvelle version. Elles ne sont pas réversibles : revenir à une version antérieure impose de restaurer une sauvegarde faite avant la mise à jour.

Les mises à jour de dépendances de sécurité ne nécessitent pas, à elles seules, de recréer vos coffres, de changer votre mot de passe maître ou de renouveler votre phrase de récupération. Consultez le journal des modifications pour les éventuelles opérations propres à une livraison. Installez le paquet corrigé sur chaque poste et redémarrez aussi tout pont de rappel PSC autonome après sa mise à jour : remplacer les fichiers ne met pas à jour un processus déjà en cours.

Téléchargez et vérifiez le nouveau paquet comme pour une première installation (sections 1 et 2 du démarrage rapide), puis :

Système Procédure
Windows Lancez le nouveau .msi. Il remplace la version installée ; inutile de désinstaller d’abord. Un .msi plus ancien que la version installée est refusé.
macOS Glissez la nouvelle application dans Applications et choisissez Remplacer. L’étape Gatekeeper du premier lancement est à refaire.
Linux (AppImage) Remplacez l’ancien fichier .AppImage par le nouveau, puis rendez-le exécutable (chmod +x).

Vos données ne sont pas touchées par le remplacement de l’application : elles vivent dans un dossier séparé (voir Où sont mes données ?).

AppImage : données créées avec la version 2.0.0

Section intitulée « AppImage : données créées avec la version 2.0.0 »

L’AppImage 2.0.0 enregistrait sa base dans un dossier data/ relatif au dossier depuis lequel elle était lancée (souvent le dossier personnel : ~/data/heelonvault-rust-dev.db). Les versions suivantes utilisent ~/.local/share/heelonvault/heelonvault-rust.db. Au premier lancement, si ce nouveau fichier n’existe pas encore, l’AppImage y copie automatiquement l’ancienne base trouvée dans le dossier de lancement ou dans le dossier personnel. L’ancien fichier est laissé en place : supprimez-le vous-même une fois vos secrets vérifiés.

Réservée aux administrateurs qui veulent une installation dans /opt/heelonvault avec intégration au menu des applications, ou une base partagée sur un serveur. Pour un poste individuel, l’AppImage suffit.

Les scripts d’installation détectent la distribution (famille Debian/Ubuntu ou Fedora/RHEL/Rocky/AlmaLinux), installent les dépendances système et proposent deux profils :

Profil Base de données Logs
Personnel (défaut) ~/.local/share/heelonvault/heelonvault-rust.db ~/.local/state/heelonvault/logs/
Entreprise /var/lib/heelonvault/heelonvault-rust.db /var/log/heelonvault/

Le profil Personnel partage la base de l’AppImage : les deux peuvent coexister.

Prérequis : un dépôt heelonvault-core au tag voulu et le binaire construit en mode release, en tant qu’utilisateur (voir la documentation de développement) :

Fenêtre de terminal
cargo build --release -p heelonvault-app
# Aperçu, sans rien modifier
sudo env HEELONVAULT_DRY_RUN=1 ./scripts/install.sh
# Installation
sudo ./scripts/install.sh

Le script prend le binaire le plus récent entre target/release/heelonvault et la racine du dépôt. Si CARGO_TARGET_DIR est défini (sudo ne le transmet pas), indiquez-le : sudo env HEELONVAULT_BINARY="$CARGO_TARGET_DIR/release/heelonvault" ./scripts/install.sh. Il refuse un binaire périmé : version différente de celle des sources, ou fichier source modifié après le build, comme après un git pull (HEELONVAULT_ALLOW_STALE_BINARY=1 pour passer outre).

Il vérifie ensuite l’intégrité du binaire si un fichier heelonvault.sha256 l’accompagne, copie l’application et ses migrations dans /opt/heelonvault, génère le lanceur run.sh et l’entrée de menu com.heelonvault.rust.desktop. Les scripts install-ubuntu.sh et install-rhel.sh permettent de forcer une famille de distribution.

En profil Entreprise, le script ne configure que les chemins partagés : la publication réseau (RDS, VDI, RemoteApp, bastion…) reste à votre charge. Placez la base sur un stockage à faible latence, idéalement local au serveur d’exécution.

Fermez HeelonVault, puis depuis le dépôt au nouveau tag :

Fenêtre de terminal
cargo build --release -p heelonvault-app
sudo ./scripts/install.sh

La même commande installe ou met à jour. Pour une mise à jour, le script :

  1. affiche la version installée et celle qui va la remplacer, et propose par défaut le profil actuel (Personnel ou Entreprise) ;
  2. refuse de continuer si HeelonVault est ouvert ;
  3. installe les dépendances système, puis sauvegarde les bases détectées dans /var/backups/heelonvault (heelonvault_user_<utilisateur>_backup_AAAAMMJJ_HHMMSS.db ou heelonvault_enterprise_backup_AAAAMMJJ_HHMMSS.db) avec une copie cohérente (sqlite3 .backup) dont l’intégrité est vérifiée ; une sauvegarde invalide interrompt tout ;
  4. prépare la nouvelle version à côté de l’ancienne (/opt/heelonvault.new), puis l’échange avec elle en une seule opération ;
  5. en cas d’erreur après l’échange (icônes, lanceur, validation), restaure automatiquement la version précédente.

Jusqu’à l’étape 4, un échec laisse l’installation existante intacte. Les bases ne sont jamais modifiées par le script : seule l’application les migre, à son premier lancement.

Contrôle après mise à jour :

Fenêtre de terminal
test -x /opt/heelonvault/heelonvault && test -x /opt/heelonvault/run.sh && echo OK
stat -c "%a %n" ~/.local/share/heelonvault/heelonvault-rust.db # attendu : 600
Fenêtre de terminal
# 1. Réinstaller la version précédente (dépôt au tag précédent, binaire correspondant)
sudo ./scripts/install.sh
# 2. Restaurer la sauvegarde faite avant la mise à jour
ls -lth /var/backups/heelonvault/
cp /var/backups/heelonvault/<sauvegarde>.db ~/.local/share/heelonvault/heelonvault-rust.db
Fenêtre de terminal
sudo ./scripts/remove.sh

Les données et les sauvegardes ne sont supprimées que si vous le confirmez explicitement.

Migration depuis l’ancienne version Python (0.4)

Section intitulée « Migration depuis l’ancienne version Python (0.4) »

HeelonVault ne lit ni ne modifie jamais les données de l’ancienne application Python. Pour les reprendre, exportez-les en CSV, puis importez ce fichier depuis Profil & Sécurité > Gestion des données > Importer des données (CSV) :

Fenêtre de terminal
# Données dans le dossier par défaut (~/.local/share/passwordmanager), profil donné
./scripts/export-legacy-v0.4-to-csv.py --profile <profil> --output legacy_export.csv
# Ou chemins explicites (déploiement partagé, par exemple sous /var/lib/heelonvault-shared)
./scripts/export-legacy-v0.4-to-csv.py \
--db-path <chemin>/passwords_<profil>.db \
--salt-path <chemin>/salt_<profil>.bin \
--output legacy_export.csv

Le fichier CSV contient vos mots de passe en clair : supprimez-le de façon sûre dès l’import terminé.