mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Merge branch 'grav' of https://github.com/YunoHost/doc
This commit is contained in:
commit
b6dd2395c5
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`.
|
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
|
Il est possible de naviguer dans le catalogue d'application dans la webadmin (dans Applications > Installer) ou bien [ici](/apps).
|
||||||
|
|
||||||
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).
|
|
||||||
|
|
||||||
## Niveaux d'intégration et de qualité
|
## 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.
|
Applications can be installed and managed through the webadmin interface in 'Applications' or through commands of the `yunohost app` category.
|
||||||
|
|
||||||
## Application lists
|
The application catalog can be browsed in the webadmin (in Applications > Install) or [here](/apps).
|
||||||
|
|
||||||
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).
|
|
||||||
|
|
||||||
## Integration and quality levels
|
## 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).*
|
*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…
Add table
Reference in a new issue