Différences

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

--- admin:services:mobilizon.chapril.org:upgrade [2025/05/10 13:18] – fusion de la partie mise à jour de la page principale rro
+++ 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 17: / Ligne 17: @@
 ===== Localement =====
-Admettons que vous avez les sources de mobilizon sur votre poste de travail 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:
-Pour faire l'upgrade vers le tag le plus récent
+  * Se positionner sur la branche main
-- fusionner le tag le plus récent sur la branche chapril
+  * Récupérer les avancées de la branche distante du dépôt upstream, tags inclus
-	- pour voir la liste des tags: **git tag**
+    * Si vous n'avez pas ajouté le dépot upstream, ajoutez le en https ou en ssh selon votre préférence
-	- **git merge 1.0.6** (par exemple, mais il faut utiliser la version la plus récente)
+      * ''git remote add upstream https://framagit.org/kaihuri/mobilizon.git''
-	- résoudre les éventuels conflits
+      * ''git remote add upstream git@framagit.org:kaihuri/mobilizon.git''
-- vérifier que tout fonctionne bien
+  * Se positionner sur la branche du chapril
-        - en effectuant les migrations de base données **mix ecto.migrate**
+  * Fusionner le tag le plus récent vers la branche chapril avec un git merge.
-        - en lançant localement le serveur **mix phx.server** et en naviguant sur http://localhost:4000
+    * pour voir la liste des tags: ''git tag''
-- créer un tag avec le préfixe chapril et le numéro de tag, par exemple **git tag chapril-1.0.6**
+    * résoudre les éventuels conflits
-- envoyer vers la forge chapril notre nouveau tag
+  * Vérifier que tout fonctionne bien
-	- **git push --tags**
+    * en effectuant les migrations de base données ''mix ecto.migrate''
-	- Se positionner sur la branche master: **git checkout master**
+    * en lançant localement le serveur ''mix phx.server'' et en naviguant sur http://localhost:4000
-	- Prendre les avancées du dépot upstream, tags inclus:
+  * 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.
-		- Si vous n'avez pas ajouté le dépot upstream, ajoutez le en https ou en ssh selon votre préférence
-			- **git remote add upstream https://framagit.org/framasoft/mobilizon.git**
+  git checkout main
-			- **git remote add upstream git@framagit.org:framasoft/mobilizon.git**
+  git pull upstream main
-		- **git pull --all**
+  git fetch --tags upstream
-- fusionner le tag le plus récent vers la branche chapril avec un git merge.
+  git checkout chapril
-  <code>git checkout chapril && git merge 1.3.0</code> par exemple
+  git merge 5.1.2
-- une fois les conflits résolus, modifications faites et le lint vérifiées, faire un commit et un tag chapril-1.x.x (en mettant le bon numéro de tag, celui que l'on vient de fusionner) les envoyer sur la forge du
+  git tag chapril-5.1.2
-  Chapril.
+  git push --all
-    - <code>git tag chapril-1.3.0</code> par exemple
-    - <code>git push origin --all</code>
 Nous pouvons maintenant mettre à jour la VM biliz en production.
-- Recompiler les assets du frontend et les mettre dans le dossier live/priv/static
+  * 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)
+  * 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
-<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 =====