Mise à jour de l’application

Cette page décrit la procédure de montée de version d’une instance ESUP-Stage existante. Pour une première installation, voir ESUP Stage.

Avant la mise à jour

  1. Lire la liste des changements de la version cible : nouvelles propriétés de configuration, changements de comportement, actions manuelles éventuelles.

  2. Sauvegarder la base de données (voir Sauvegarde et exploitation).

    Les migrations de schéma (Liquibase) s’exécutent automatiquement au démarrage de la nouvelle version et ne sont pas réversibles. La sauvegarde préalable est le seul moyen de retour arrière.

  3. Sauvegarder le répertoire appli.data_dir et le fichier application.properties.

  4. Prévenir les utilisateurs via le mode maintenance.

Mise à jour (déploiement WAR / Tomcat)

  1. Récupérer la nouvelle version :

    cd /opt/esup-stage
git fetch --tags
git checkout <tag-de-la-version>

  2. Supprimer le package-lock.json et le dossier node_modules dans src/frontend (fortement recommandé à chaque changement de version pour éviter les incohérences de dépendances) :

    rm -rf src/frontend/node_modules src/frontend/package-lock.json

  3. Compléter le application.properties avec les éventuelles nouvelles propriétés (voir Référence de configuration).

  4. Compiler :

    mvn clean package

  5. Arrêter Tomcat, remplacer le WAR dans webapps (en conservant le même nom de fichier qu’auparavant : ROOT.war ou esup-stage.war), supprimer le répertoire déployé correspondant, puis redémarrer Tomcat.

  6. Suivre le démarrage dans les logs : les changesets Liquibase de la nouvelle version s’appliquent automatiquement.

Ne modifiez jamais appli.datasource.context (baseline ou legacy) lors d’une mise à jour : ce choix est définitif depuis la première installation.

Mise à jour (Docker)

  1. Sauvegarder la base et le volume de données ;

  2. mettre à jour IMAGE_TAG dans le fichier .env avec le tag de la nouvelle version (consultez les tags disponibles sur le workflow Docker Image CI) ;

  3. relancer :

    docker-compose pull
docker-compose up -d

Après la mise à jour

  1. Vérifier l’écran d’accueil et la version affichée ;

  2. si de nouvelles propriétés obligatoires ont été introduites, l’écran « Configuration requise » les signale (voir Configuration en base) ;

  3. tester les connecteurs (mailer, référentiel, signature…​) via les boutons de test de l’écran de configuration ;

  4. vérifier les logs au démarrage (erreurs Liquibase, tâches planifiées) ;

  5. désactiver le mode maintenance.