[Mémo] Mise à jour Umami v1 vers v2

[EVO]

[Mémo] Mise à jour Umami v1 vers v2
​

La version 2 de Umami sortie le 17 Avril 2023, apporte de nombreuses modifications / changements / fonctionnalitées ! Mais aussi, de profonds changements dans la base de données !


Le développeur nous demande donc de consulter https://umami.is/docs/migrate-v1-v2 pour en savoir plus sur la méthode pour migrer de v1 a v2.

Si comme moi, vous avez Umami dans un docker-compose, c'est plutôt simple, et cela se fait comme ceci :

Bien sur, on oublie pas de faire des sauvegarde avant !

Stopper et supprimer les conteneurs de votre docker-compose avec la commande docker-compose down

Lancer la migration :

docker compose run --rm <service_name> npx @umami/migrate-v1-v2@latest

Vous devez remplacer <service_name> par le nom du service umami,

Exemple : si vous avez installé Umami avec ce tutoriel ( [Tuto] Installation de Umami + MySQL en Docker ) alors la commande est la suivante :

docker compose run --rm umami npx @umami/migrate-v1-v2@latest

Le terminal va vous demandez si vous souhaitez effectuer la mise à jour du script, indiquer y pour Oui.
La migration ce déroule, puis il vous demande si vous souhaitez nettoyer les anciennes tables, répondez Y pour Oui, ou N pour Non.


Apres cela, la migration est faites, vous pouvez relancer normalement vos services : docker compose up -d

Le code "injecté" sur les sites qui sont "suivis" aura également besoin d'être replacer.