mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Misc rework, reorganization
This commit is contained in:
Alexandre Aubin
parent
9a3bf730fd
commit
d66a538688
50 changed files with 71 additions and 153 deletions
|
|
@ -13,11 +13,7 @@ Les applications doivent être packagées manuellement par les packageurs/mainte
|
|||
|
||||
Les applications peuvent être installées et gérées via l'interface webadmin dans la partie 'Applications', ou via les commandes de la catégorie `yunohost app`.
|
||||
|
||||
## Listes d'applications
|
||||
|
||||
Du point de vue technique, les applications sont des dépôts de code public (comme [celui-ci](https://github.com/YunoHost-Apps/wordpress_ynh)). Les applications existantes sont indexées à l'aide de "listes d'applications". Ces listes peuvent être gérées dans Applications > Installer > Gérer les listes d'applications, ou avec des commandes telles que `yunohost app fetchlist`.
|
||||
|
||||
La liste des applications existantes peut être consultée sur [cette page](/apps).
|
||||
Il est possible de naviguer dans le catalogue d'application dans la webadmin (dans Applications > Installer) ou bien [ici](/apps).
|
||||
|
||||
## Niveaux d'intégration et de qualité
|
||||
|
||||
|
|
|
|||
|
|
@ -13,11 +13,7 @@ Applications must be packaged manually by application packagers/maintainers. App
|
|||
|
||||
Applications can be installed and managed through the webadmin interface in 'Applications' or through commands of the `yunohost app` category.
|
||||
|
||||
## Application lists
|
||||
|
||||
From the technical point of view, applications are public code repository (such as [this one](https://github.com/YunoHost-Apps/wordpress_ynh)). Existing applications are indexed using "application lists". Those lists can be managed in Applications > Install > Manage applications lists or with commands such as `yunohost app fetchlist`.
|
||||
|
||||
The full list of application can be browsed at [this page](/apps).
|
||||
The application catalog can be browsed in the webadmin (in Applications > Install) or [here](/apps).
|
||||
|
||||
## Integration and quality levels
|
||||
|
||||
|
|
|
|||
|
|
@ -1,26 +0,0 @@
|
|||
---
|
||||
title: Mettre à jour le système
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/update'
|
||||
---
|
||||
|
||||
## Depuis la webadmin
|
||||
|
||||
Dans la partie administration, choisir Mettre à jour le système.
|
||||
|
||||
L’application recherche les mises à jour et les propose s’il y en a.
|
||||
|
||||
Si c’est le cas, cliquer sur le bouton vert « Mettre à jour » et les mises à
|
||||
jour se font.
|
||||
|
||||
## Depuis la ligne de commande
|
||||
|
||||
Depuis la ligne de commande, vous pouvez utiliser :
|
||||
|
||||
``` bash
|
||||
yunohost tools update
|
||||
yunohost tools upgrade --system
|
||||
```
|
||||
|
|
@ -1,25 +0,0 @@
|
|||
---
|
||||
title: Update the system
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/update'
|
||||
---
|
||||
|
||||
## From the webadmin
|
||||
|
||||
On the administraton panel, click on Upgrade the system.
|
||||
|
||||
The application search for updates and propose it if so.
|
||||
|
||||
If so, click on green update button and updates are applied.
|
||||
|
||||
## From the command line
|
||||
|
||||
From the command line, you can run:
|
||||
|
||||
``` bash
|
||||
yunohost tools update
|
||||
yunohost tools upgrade --system
|
||||
```
|
||||
|
|
@ -1,46 +0,0 @@
|
|||
---
|
||||
title: Mettre à jour ses applications
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/app_update'
|
||||
---
|
||||
|
||||
Une fois que vous avez installé des applications, il est nécessaire de les mettre à jour. Plusieurs méthodes existent et sont détaillées ci-dessous.
|
||||
|
||||
** Attention : ** il est recommandé de faire une sauvegarde de la base de données (par exemple via l’application [phpMyAdmin](https://github.com/YunoHost-apps/phpmyadmin_ynh) ([installer](https://install-app.yunohost.org/?app=phpmyadmin))) ainsi que des fichiers avant une opération de mise à jour.
|
||||
|
||||
### Mise à jour par l’interface Web
|
||||
Pour cela, il faut aller dans l’onglet "Mettre à jour le système".
|
||||
|
||||
Une fois la liste des paquets et des applications rafraîchie, il sera proposé de mettre à jour les applications et paquets qui peuvent l’être.
|
||||
|
||||
|
||||
### Mise à jour en ligne de commande
|
||||
Il faut d’abord se connecter sur le serveur en SSH, puis entrer la commande suivante (dans le cas d’une mise à jour WordPress) :
|
||||
```bash
|
||||
yunohost app upgrade wordpress
|
||||
```
|
||||
**Note :** dans le cas où plusieurs applications du même type (ex : deux WordPress) sont installées sur le serveur, il est nécessaire de spécifier le nom d’instance (ex : wordpress ou wordpress__2).
|
||||
|
||||
#### Mise à jour d’une application non officielle
|
||||
Il faut pour cela indiquer le dépôt Git qui contient la mise à jour.
|
||||
|
||||
Par exemple, pour mettre à jour LimeSurvey, entrer :
|
||||
```bash
|
||||
yunohost app upgrade limesurvey -u https://github.com/zamentur/limesurvey_ynh
|
||||
```
|
||||
|
||||
**Note :** faites attention aux applications/mises à jour non officielles que vous installez. Assurez-vous que ces mises à jour sont stables et ne constituent pas une étape de développement. Si une application ou une mise à jour n’est pas intégrée au dépôt officiel, il y a sûrement une raison.
|
||||
|
||||
**Attention :** assurez-vous du contenu de cette mise à jour ; l’installation ou la mise à jour d’une application non officielle permet à cette dernière d’exécuter des scripts avec les privilèges les plus élevés. Si le script est malicieux, il pourrait nuire à votre vie privée en communiquant à des tiers toute donnée présente sur le serveur, ou bien les détruire irrémédiablement.
|
||||
|
||||
##### Options de ligne de commande
|
||||
|
||||
Lorsque vous mettez à jour des applications à partir de la ligne de commande, vous pouvez spécifier des options spécifiques pour modifier le comportement du script d'upgrade.
|
||||
Pour définir ces options, définissez la variable correspondante avant la commande d'upgrade : `sudo OPTION_TO_SET=1 yunohost app upgrade wordpress`
|
||||
|
||||
Les options disponibles sont:
|
||||
- `NO_BACKUP_UPGRADE`: Ne pas effectuer le backup avant la mise à jour. Ce qui veut dire que la mise à jour se fera sans sauvegarde de sécurité.
|
||||
- `YNH_FORCE_UPGRADE`: Force la mise à jour de l'application et du package, même si l'application est déjà à jour.
|
||||
|
|
@ -1,45 +0,0 @@
|
|||
---
|
||||
title: Upgrade your applications
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/app_update'
|
||||
---
|
||||
|
||||
Once you installed applications, you may need to upgrade them, sooner or later.
|
||||
|
||||
**Caution:** please be advised to backup your databases (using phpMyAdmin application for example) and files before any upgrade.
|
||||
|
||||
### Upgrade using the admin panel
|
||||
Go to Tools > Update system
|
||||
|
||||
Once the applications packages list is retrieved, you will be able to update official applications that have a pending upgrade.
|
||||
|
||||
### Upgrade using command line
|
||||
First, connect to your server through SSH and type in the following command (WordPress update):
|
||||
```bash
|
||||
yunohost app upgrade wordpress
|
||||
```
|
||||
**Note:** in case you have multiple instances of the same type (ex: 2 wordpress) installed, you will need to specify the instance name (ex: wordpress or wordpress__2).
|
||||
|
||||
#### Upgrade an unofficial application
|
||||
Specify the Git repository containing the upgrade.
|
||||
|
||||
For intance, to upgrade LimeSurvey:
|
||||
```bash
|
||||
yunohost app upgrade limesurvey -u https://github.com/zamentur/limesurvey_ynh
|
||||
```
|
||||
|
||||
**Note:** be cautious when installing unofficial applications and upgrades. Be sure that theses updates are stables and are not a step in the development process. There may be a good reason if an application is not listed in the official repository.
|
||||
|
||||
**Caution:** be sure to check the content of any update; installing or upgrading an unofficial application allows it to run scripts with the highest privileges.
|
||||
|
||||
#### Command line options
|
||||
|
||||
When upgrading apps from the command line, you can specify specific options to change the behaviour of the upgrade script.
|
||||
To set those options, set the corresponding variable before the upgrade command: `sudo OPTION_TO_SET=1 yunohost app upgrade wordpress`
|
||||
|
||||
Available options are:
|
||||
- `NO_BACKUP_UPGRADE`: Do not perform the backup before the upgrade. Which means the upgrade will be operated without a security backup.
|
||||
- `YNH_FORCE_UPGRADE`: Force the upgrade of the app and the package, even if the app is already up to date.
|
||||
34
pages/01.administrate/04.learn/11.update/upgrade.fr.md
Normal file
34
pages/01.administrate/04.learn/11.update/upgrade.fr.md
Normal file
|
|
@ -0,0 +1,34 @@
|
|||
---
|
||||
title: Mettre à jour le système
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/update'
|
||||
aliases:
|
||||
- '/upgrade'
|
||||
---
|
||||
|
||||
## Depuis la webadmin
|
||||
|
||||
Dans la partie administration, choisir Mettre à jour le système. YunoHost va mettre à jour le catalogue des paquets sytème et le catalogue des applications, et afficher les mise à jour disponibles.
|
||||
|
||||
Cliquez sur les boutons verts pour lancer les mises à jours du système et des applications.
|
||||
|
||||
## Depuis la ligne de commande
|
||||
|
||||
Voici quelques exemples de ligne de commande correspondantes :
|
||||
|
||||
``` bash
|
||||
# Aller chercher les mises à jour disponibles
|
||||
yunohost tools update
|
||||
|
||||
# Mettre à jour tous les paquets systèmes
|
||||
yunohost tools upgrade --system
|
||||
|
||||
# Mettre à jour toutes les applications
|
||||
yunohost tools upgrade --apps
|
||||
|
||||
# Mettre à jour une application en particulier
|
||||
yunohost app upgrade wordpress
|
||||
```
|
||||
34
pages/01.administrate/04.learn/11.update/upgrade.md
Normal file
34
pages/01.administrate/04.learn/11.update/upgrade.md
Normal file
|
|
@ -0,0 +1,34 @@
|
|||
---
|
||||
title: Update the system
|
||||
template: docs
|
||||
taxonomy:
|
||||
category: docs
|
||||
routes:
|
||||
default: '/update'
|
||||
aliases:
|
||||
- '/upgrade'
|
||||
---
|
||||
|
||||
## From the webadmin
|
||||
|
||||
On the administraton panel, click on Upgrade the system. YunoHost will refresh the system package catalog as well as the application catalog, and display available upgrades.
|
||||
|
||||
Click on green upgrade buttons to upgrade the system and applications.
|
||||
|
||||
## From the command line
|
||||
|
||||
Here are some example of corresponding command lines:
|
||||
|
||||
``` bash
|
||||
# Fetch available updates
|
||||
yunohost tools update
|
||||
|
||||
# Upgrade all system packages
|
||||
yunohost tools upgrade --system
|
||||
|
||||
# Upgrade all apps
|
||||
yunohost tools upgrade --apps
|
||||
|
||||
# Upgrade a specific application
|
||||
yunohost app upgrade wordpress
|
||||
```
|
||||
|
|
@ -17,7 +17,7 @@ Two things remain important to note:
|
|||
|
||||
*If you need advice, do not hesitate to [ask us](/help).*
|
||||
|
||||
*To talk about security flaws, contact the [YunoHost security team](/security_team).*
|
||||
*To discuss security flaws, contact the [YunoHost security team](/security_team).*
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue