Différences

Ci-dessous, les différences entre deux révisions de la page.

--- admin:services:mobilizon.chapril.org:upgrade [2022/11/06 17:29] – ↷ Page déplacée et renommée de mobilizon_chapril_org_upgrade à admin:services:mobilizon.chapril.org:upgrade pitchum
+++ admin:services:mobilizon.chapril.org:upgrade [2025/06/11 18:42] (Version actuelle) – changement dans la liste des étapes pour la mise à jour du code (séparation des commandes et des instructions) rro
@@ Ligne 1: / Ligne 1: @@
-====== Mise à jour de la version chapril mobilizon ======
+====== Mise à jour de la version Chapril mobilizon ======
-<note warning>Cette page fait doublon avec la section idoine de la page [[admin:services:mobilizon.chapril.org#mise_a_jour_de_la_version_chapril_mobilizon|Mobilizon Chapril]].
+Pour fusionner les avancées de l'upstream avec la branche Chapril, il nous faut fusionner les modifications publiées dans le tag le plus récent.
-</note>
-Pour fusionner les avancées de l'upstream avec la branche chapril:
 ===== Plan d'action général =====
-  * Communiquer le début de migration
   * Fusionner la nouvelle version dans notre branche "chapril"
+  * Communiquer le début de migration
   * Compiler les assets du frontend et les envoyer sur la VM biliz
-  * prendre les vernières modifications et migrer la base de données
+  * Prendre les dernières modifications et migrer la base de données
-  * relancer le service mobilizon
+  * Relancer le service mobilizon
   * Vérfier que tout est bon
   * Communiquer la fin de migration
 Voici le détail des opérations:
 ===== Localement =====
-disons dans le dossier **/var/www/html/mobilizon**
+Admettons que vous avez les sources de mobilizon sur votre poste de travail dans le dossier ''/tmp/mobilizon'' et que la dernière version est la **5.1.2**. Pour faire l'upgrade vers le tag le plus récent:
-- fusionner le tag le plus récent sur la branche chapril
+  * Se positionner sur la branche main
-	- pour voir la liste des tags: **git tag**
+  * Récupérer les avancées de la branche distante du dépôt upstream, tags inclus
-	- **git merge 1.0.6** (par exemple, mais il faut utiliser la version la plus récente)
+    * Si vous n'avez pas ajouté le dépot upstream, ajoutez le en https ou en ssh selon votre préférence
-	- résoudre les éventuels conflits
+      * ''git remote add upstream https://framagit.org/kaihuri/mobilizon.git''
-- vérifier que tout fonctionne bien
+      * ''git remote add upstream git@framagit.org:kaihuri/mobilizon.git''
-- en effectuant les migrations de base données **mix ecto.migrate**
+  * Se positionner sur la branche du chapril
-- en lançant localement le serveur **mix phx.server** et en naviguant sur http://localhost:4000
+  * Fusionner le tag le plus récent vers la branche chapril avec un git merge.
-- créer un tag avec le préfixe chapril et le numéro de tag, par exemple **git tag chapril-1.0.6**
+    * pour voir la liste des tags: ''git tag''
-- envoyer vers la forge chapril notre nouveau tag
+    * résoudre les éventuels conflits
-	- **git push --tags**
+  * Vérifier que tout fonctionne bien
-	- Se positionner sur la branche master: **git checkout master**
+    * en effectuant les migrations de base données ''mix ecto.migrate''
-	- Prendre les avancées du dépot upstream, tags inclus:
+    * en lançant localement le serveur ''mix phx.server'' et en naviguant sur http://localhost:4000
-		- Si vous n'avez pas ajouté le dépot upstream, ajoutez le en https ou en ssh selon votre préférence
+  * une fois les conflits résolus, modifications faites et le lint vérifié, faire un commit et un tag chapril-x.x.x (en mettant le bon numéro de tag, celui que l'on vient de fusionner) les envoyer sur la forge du Chapril.
-			- **git remote add upstream https://framagit.org/framasoft/mobilizon.git**
-			- **git remote add upstream git@framagit.org:framasoft/mobilizon.git**
-		- **git pull --all**
-- Recompiler les assets du frontend et les mettre dans le dossier live/priv/static
-<note tip> cd /var/www/html/mobilizon/js && yarn run build </note>
-- Syncroniser les assets compilés avec la VM biliz (nécessite d'avoir **rsync** installé sur la VM)
+  git checkout main
+  git pull upstream main
+  git fetch --tags upstream
+  git checkout chapril
+  git merge 5.1.2
+  git tag chapril-5.1.2
+  git push --all
-<note tip>rsync -aP priv/static/* root@biliz.cluster.chapril.org:/srv/mobilizon.chapril.org/live/priv/static --delete</note>
+Nous pouvons maintenant mettre à jour la VM biliz en production.
+  * Recompiler les assets du frontend et les mettre dans le dossier live/priv/static
+<note tip> cd /var/www/html/mobilizon/js && yarn run build </note>
+  * Syncroniser les assets compilés avec la VM biliz (nécessite d'avoir **rsync** installé sur la VM)
+<note tip>rsync -aP priv/static/* root@biliz.cluster.chapril.org:/srv/mobilizon.chapril.org/live/priv/static --delete</note>
 ===== Sur la VM biliz =====
-- se connecter à la VM biliz, aller dans le dossier "live",
+  * Se connecter à la VM biliz, aller dans le dossier "live", se mettre en tant qu'utilisateur mobilizon et récupérer les dernières modifications de la branche chapril. (attention à avoir comme dépot d'origine le dépot de la forge april, et non l'upstream pour bien avoir votre branche personnelle) Ce qui nous amène sur le tag le plus récent:
-se mettre en tant qu'utilisateur mobilizon et récupérer les dernières modifications de la branche chapril. (attention à avoir comme dépot d'origine le dépot de la forge april, et non l'upstream pour bien avoir votre branche personnelle) Ce qui nous amène sur le tag le plus récent:
+  su mobilizon
-<note tip>
+  cd /srv/mobilizon.chapril.org/live
-**su mobilizon**
+  git checkout chapril
-**cd /srv/mobilizon.chapril.org/live**
+  git pull --tags origin && git pull origin chapril
-**git checkout chapril**
-**git pull --tags origin && git pull origin chapril**
+  * Stopper le service mobilizon: ''service mobilizon stop''
-</note>
-- Stopper le service mobilizon: **service mobilizon stop**
 ===== Migrer le backend de mobilizon =====
-(on en a pas forcément besoin à tous les coups, si dans la partie locale vous aviez remarqué que seule la partie frontend changeait, vous pouvez relancer le service après avoir uniquement mis à jour les assets de priv/static et faire **service mobilizon restart**). Ne pas oublier de spécifier l'environnement de prod.
+Il n'est pas nécessaire de le faire à tous les coups, si vous aviez remarqué que seule la partie frontend changeait, vous pouvez relancer le service après avoir uniquement mis à jour les assets de priv/static et faire ''service mobilizon restart''. Ne pas oublier de spécifier l'environnement de prod.
-<note tip>
   su -H mobilizon MIX_ENV=prod mix deps.get
   su -H mobilizon MIX_ENV=prod mix ecto.migrate
-</note>
-- Remettre l'utilisateur mobilizon comme owner des fichiers
+  * Remettre l'utilisateur mobilizon comme owner des fichiers
-<note tip>
-chown -R mobilizon:mobilizon /srv/mobilizon.chapril.org/live
+  chown -R mobilizon:mobilizon /srv/mobilizon.chapril.org/live
-</note>
-- relancer le service mobilizon: **service mobilizon start** ce qui doit prendre environ 5 secondes sur Biliz.
+  * Relancer le service mobilizon: ''service mobilizon start'' ce qui doit prendre environ 5 secondes sur Biliz.
 ===== Vérifications =====
@@ Ligne 76: / Ligne 77: @@
     * vérifier le frontend sur https://mobilizon.chapril.org , nécessite un vidage de votre cache navigateur (ctrl + R)
   * Communiquer la fin de mise à jour sur les canaux qui vont bien.