mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
[enh] Migration fr + retitle
This commit is contained in:
parent
a6088ef1d8
commit
b29c595a59
6 changed files with 52 additions and 10 deletions
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
||||||
|
|
|
@ -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
|
||||||
|
|
||||||
|
|
|
@ -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
|
||||||
|
|
|
@ -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
|
||||||
|
|
Loading…
Add table
Reference in a new issue