[enh] Migration fr + retitle

This commit is contained in:
ljf 2022-08-07 19:51:22 +02:00 committed by ljf (zamentur)
parent a6088ef1d8
commit b29c595a59
6 changed files with 52 additions and 10 deletions

View file

@ -1,5 +1,5 @@
--- ---
title: Migrer vers Buster title: Migrer de 3.x vers 4.x
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs

View file

@ -1,5 +1,5 @@
--- ---
title: Migrating an existing instance to Buster title: Migrating from 3.x to 4.x
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs

View file

@ -1,5 +1,5 @@
--- ---
title: Migrer vers Bullseye title: Migrer de 4.x vers 11.x
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs
@ -47,6 +47,28 @@ Si la migration a échoué a un moment donné, la première chose à faire est d
## Choses à vérifier après la migration ## Choses à vérifier après la migration
#### Exécuter la migration pour réparer votre application python
Après la mise à jour, vos applications python devraient être indisponibles car leur environnement virtuel doit être reconstruit.
Pour ce faire, vous pouvez exécuter les migrations en cours dans `Webadmin > Mises à jour`. Les applications ci-dessous ne seront pas réparées automatiquement, vous devez les mettre à jour manuellement avec `yunohost app upgrade -f APP`.
Les applications qui ne seront pas réparées automatiquement et nécessitent une mise à jour forcée :
* calibreweb
* django-for-runners
* ffsync (cette application est en python2 et n'est plus maintenue, aucune garantie)
* jupiterlab
* librephotos
* mautrix
* mediadrop
* mopidy
* pgadmin
* tracim
* synapse
* weblate
! !! Si nécessaire, vous pouvez désactiver la reconstruction automatique pour une application python spécifique, en supprimant le fichier dédié terminé par `.requirements_backup_for_bullseye_upgrade.txt` avant d'appliquer la migration. Vous pouvez trouver ce fichier près du venv de votre application dans `/opt` ou `/var/www`.
#### Vérifiez que vous êtes véritablement sous Debian Bullseye et YunoHost 11.x #### Vérifiez que vous êtes véritablement sous Debian Bullseye et YunoHost 11.x
Pour cela, vous pouvez aller dans la partie Diagnostic (section Système de base). (Vous pouvez aussi regarder ce qui est affiché à droite dans le pied de page de la webadmin). En ligne de commande, vous pouvez aussi utiliser `lsb_release -a` et `yunohost --version`. Pour cela, vous pouvez aller dans la partie Diagnostic (section Système de base). (Vous pouvez aussi regarder ce qui est affiché à droite dans le pied de page de la webadmin). En ligne de commande, vous pouvez aussi utiliser `lsb_release -a` et `yunohost --version`.
@ -65,7 +87,5 @@ Si votre app est cassée et que vous étiez déjà sur la dernière version d'un
yunohost app upgrade -f NOM_APP yunohost app upgrade -f NOM_APP
``` ```
!!! Nous savons que les applications suivantes doivent être mises à jour de force: my_webapp, jupiterlab, weblate. Contrairement, aux mises à jours majeures précédentes, la plupart des applications python3 comme borg ou django ne devraient plus nécessiter de mise à jour pour refonctionner.
## Soucis (mineurs) connus après la migration ## Soucis (mineurs) connus après la migration

View file

@ -1,5 +1,5 @@
--- ---
title: Migrating an existing instance to Bullseye title: Migrating from 4.x to 11.x
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs
@ -51,10 +51,34 @@ If the migration failed at some point, it should be possible to relaunch it. If
For this, go in Diagnosis (category Base system) or look at the footer of the webadmin. In the command line, you can use `lsb_release -a` and `yunohost --version`. For this, go in Diagnosis (category Base system) or look at the footer of the webadmin. In the command line, you can use `lsb_release -a` and `yunohost --version`.
#### Run the migration to repair your python app
After upgrading, your python apps should be unavailable cause their virtual env need to be rebuild.
To do that you can run the pending migrations in `Webadmin > Update`. The apps below won't be automatically repaired, you need to force upgrade them manually instead with `yunohost app upgrade -f APP`.
Apps which won't be automatically repaired and need a force upgrade:
* calibreweb
* django-for-runners
* ffsync (this app is in python2 and no longer maintained, no guarantee)
* jupiterlab
* librephotos
* mautrix
* mediadrop
* mopidy
* pgadmin
* tracim
* synapse
* weblate
!!! If needed, you can disable the automatic rebuild for a specific python app, by removing the dedicated file ended by `.requirements_backup_for_bullseye_upgrade.txt` before to apply the migration. You can find this file near the venv of your app inside `/opt` or `/var/www`.
#### Check that no issue appeared in the diagnosis #### Check that no issue appeared in the diagnosis
Also in the Diagnosis in the webadmin, make sure that no specific issue appeared after running the migration (for example a service that crashed for some reason). Also in the Diagnosis in the webadmin, make sure that no specific issue appeared after running the migration (for example a service that crashed for some reason).
If the service php7.3-fpm appears to be dead, you should upgrade your PHP apps like the custom web app. Next, you can run `apt autoremove`.
#### Check that your applications are working #### Check that your applications are working
Test that your applications are working. If they aren't, you should try to upgrade them (it is also a good idea to upgrade them even if they are working anyway). Test that your applications are working. If they aren't, you should try to upgrade them (it is also a good idea to upgrade them even if they are working anyway).
@ -64,7 +88,5 @@ If your app is broken and you were already with the last version, you can rerun
yunohost app upgrade -f APP_NAME yunohost app upgrade -f APP_NAME
``` ```
!!! We know that the following applications need to be updated by force: my_webapp, jupiterlab, weblate. Contrary to previous major updates, most python3 applications like borg or django should not need an update to work again.
## Current known (minor) issues after the migration ## Current known (minor) issues after the migration

View file

@ -1,5 +1,5 @@
--- ---
title: Migrer vers Stretch title: Migrer de 2.4+ vers 3.x
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs

View file

@ -1,5 +1,5 @@
--- ---
title: Migrating an existing instance to Stretch title: Migrating from 2.4+ to 3.x
template: docs template: docs
taxonomy: taxonomy:
category: docs category: docs