mirror of
https://github.com/YunoHost/doc.git
synced 2024-09-03 20:06:26 +02:00
Add a page of overview about apps
This commit is contained in:
Alexandre Aubin
parent
753b7f8bde
commit
9dbcdcd21b
2 changed files with 91 additions and 0 deletions
45
apps_overview.md
Normal file
45
apps_overview.md
Normal file
|
|
@ -0,0 +1,45 @@
|
|||
Applications
|
||||
============
|
||||
|
||||
One of the key feature of YunoHost is the ability to easily install applications which are then immediately usable. Example of applications include a blog system, a "cloud" (to host and sync files), a website, an RSS reader, ...
|
||||
|
||||
Applications must be packaged manually by application packagers/maintainers. Apps can be integrated with YunoHost to support upgrades, backup/restore and LDAP/SSO integration among other things.
|
||||
|
||||
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`.
|
||||
|
||||
By default, YunoHost only knows about the official application list. Those are applications which have been carefully packaged, integrated, reviewed and shall be maintained by the YunoHost team.
|
||||
|
||||
Nevertheless, you might want to have access to the larger catalog of the community list. It can easily be added through the 'Manage applications lists' view of the webadmin, or with the command `yunohost app fetchlist -n community -u https://app.yunohost.org/community.json`. Just be aware that apps in this list offer less guarantees than the official apps and the YunoHost team is not responsible for them !
|
||||
|
||||
The full list of application (official and community) can be browsed at [this page](/apps).
|
||||
|
||||
Integration and quality levels
|
||||
------------------------------
|
||||
|
||||
Automated tests are being ran regularly to test the integration and quality of all official apps, as well as community apps who were declared to be 'working'. The result is a level between 0 and 7, whose meaning is detailed on [this page](/packaging_apps_levels_fr). Some tests results may also be available [on this dashboard](https://dash.yunohost.org/appci/branch/stable).
|
||||
|
||||
LDAP / SSO integration
|
||||
----------------------
|
||||
|
||||
Applications may support integration with the LDAP / Single Sign On system, such that users who connects to the user portal can be automatically logged in all those apps. Some applications however do not support this as it can be either not implemented in the upstream, or the package didn't work on this part yet.
|
||||
|
||||
Multi-instance applications
|
||||
---------------------------
|
||||
|
||||
Some applications support the ability to be installed several times (at different locations) ! To do so, just go another time in Applications > Install, and select again the application to install.
|
||||
|
||||
|
||||
User access management
|
||||
----------------------
|
||||
|
||||
Access to apps can be restricted to some users only. This can be configured via the webadmin in Applications > (choose an app) > Access, or similarly via the command line `yunohost app addaccess`, `removeaccess` and `clearaccess`.
|
||||
|
||||
Packaging applications
|
||||
----------------------
|
||||
|
||||
If you want to learn or contribute to app packaging, please check the [contributor documentation](contributordoc).
|
||||
46
apps_overview_fr.md
Normal file
46
apps_overview_fr.md
Normal file
|
|
@ -0,0 +1,46 @@
|
|||
Applications
|
||||
============
|
||||
|
||||
L'une des fonctionnalités principales de YunoHost est la possibilité d'installer facile des applications immédiatement utilisables. Pour donner des exemples d'application, il est possible d'installer un système de blog, un "cloud" (pour héberger et synchroniser des fichiers), un site web, un lecteur RSS, ....
|
||||
|
||||
Les applications doivent être packagées manuellement par les packageurs/mainteneurs d'applications. Les applications peuvent être intégrées avec YunoHost pour gérer les mise à jour, la sauvegarde/restauration et l'intégration LDAP/SSO, entre autres.
|
||||
|
||||
Les applications peuvent être installées et gérées via l'interface webadmin dansila 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`.
|
||||
|
||||
Par défaut, YunoHost ne connaît que la liste officielle des applications. Il s'agit d'applications qui ont été soigneusement packagées, intégrées, revues et doivent être maintenues par l'équipe YunoHost.
|
||||
|
||||
Néanmoins, vous souhaiterez peut-être avoir accès au catalogue plus fourni de la liste communautaire. Cette liste peut facilement être ajouté via la vue 'Gérer les listes d'applications' de l'administrateur web, ou avec la commande `yunohost app fetchlist -n community -u https://app.yunohost.org/community.json`. Sachez simplement que les applications de cette liste offrent moins de garanties que les applications officielles et que l'équipe YunoHost n'en est pas responsable !
|
||||
|
||||
La liste des applications existantes (officielles et communautaires) peut être consultée sur [cette page](/apps).
|
||||
|
||||
Niveaux d'intégration et de qualité
|
||||
------------------------------
|
||||
|
||||
Des tests automatisés sont exécutés régulièrement pour tester l'intégration et la qualité de toutes les applications officielles, ainsi que les applications communautaires qui ont été déclarées "working". Le résultat est un niveau entre 0 et 7, dont la signification est détaillée sur [cette page](/packaging_apps_levels_levels_fr). Certains résultats de tests peuvent également être disponibles sur [ce tableau de bord](https://dash.yunohost.org/appci/branch/stable).
|
||||
|
||||
Intégration LDAP / SSO
|
||||
----------------------
|
||||
|
||||
Les applications peuvent prendre en charge l'intégration avec le système LDAP / Single Sign On, de sorte que les utilisateurs qui se connectent au portail utilisateur peuvent être automatiquement authentifié sur toutes ces applications. Certaines applications ne le supportent pas car cette fonctionnalité n'est, soit pas implémentée en amont du logiciel de l'app, soit le mainteneur n'a pas encore travaillé sur cette partie.
|
||||
|
||||
Applications multi-instances
|
||||
---------------------------
|
||||
|
||||
Certaines applications peuvent être installées plusieurs fois (à différents endroits) ! Pour ce faire, il suffit de retourner dans Applications > Installer, et de sélectionner à nouveau l'application à installer.
|
||||
|
||||
|
||||
Gestion de l'accès des utilisateurs
|
||||
----------------------
|
||||
|
||||
L'accès aux applications peut être limité à certains utilisateurs seulement. Ceci peut être configuré via la webadmin dans Applications > (une application) > Accès, ou de la même manière via les commandes `yunohost addaccess`, `removeaccess` et `clearaccess`.
|
||||
|
||||
Packaging d'applications
|
||||
------------------------
|
||||
|
||||
Si vous voulez apprendre ou contribuer à l'empaquetage des applications, veuillez consulter la [documentation des contributeurs](contributordoc).
|
||||
|
||||
Loading…
Add table
Reference in a new issue