1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/armadietto_ynh.git synced 2024-09-03 18:06:18 +02:00
armadietto_ynh/README_fr.md

103 lines
5.6 KiB
Markdown
Raw Normal View History

2022-01-01 16:14:00 +01:00
# Armadietto pour YunoHost
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
[![Niveau d'intégration](https://dash.yunohost.org/integration/armadietto.svg)](https://dash.yunohost.org/appci/app/armadietto) ![](https://ci-apps.yunohost.org/ci/badges/armadietto.status.svg) ![](https://ci-apps.yunohost.org/ci/badges/armadietto.maintain.svg)
[![Installer Armadietto avec YunoHost](https://install-app.yunohost.org/install-with-yunohost.svg)](https://install-app.yunohost.org/?app=armadietto)
2021-12-17 11:38:57 +01:00
*[Read this readme in english.](./README.md)*
2022-01-01 16:14:00 +01:00
*[Lire ce readme en français.](./README_fr.md)*
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
> *Ce package vous permet d'installer Armadietto rapidement et simplement sur un serveur YunoHost.
Si vous n'avez pas YunoHost, regardez [ici](https://yunohost.org/#/install) pour savoir comment l'installer et en profiter.*
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
## Vue d'ensemble
[Armadietto](https://github.com/remotestorage/armadietto/) est un serveur [remoteStorage](https://remotestorage.io) écrit pour Node.js.
2021-12-17 11:38:57 +01:00
2022-01-12 01:11:41 +01:00
Armadietto est maintenu par la communauté remoteStorage, ([IRC](https://web.libera.chat/#remotestorage), [forums](https://community.remotestorage.io/)).
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
> ### :warning: WARNING
> Veuillez ne pas considérer `armadietto` comme prêt pour la production, ce projet est toujours
> comme expérimental. Comme avec toute technologie de stockage en phase alpha, vous
> devez vous attendre à ce qu'elle mange vos données et prendre des précautions contre cela. Vous
> Vous devez vous attendre à ce que ses API et ses schémas de stockage changent avant qu'il ne soit
> étiqueté comme stable.
2021-12-17 11:38:57 +01:00
**Version livrée:** 0.1.5
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
### Application pour remoteStorage
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
[Cliquez ici](https://remotestorage.io/apps/) pour voir la liste des applications qui peuvent être utilisées avec RemoteStorage.
**Version incluse :** 0.0.3~ynh2
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
## Captures d'écran
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
![](./doc/screenshots/armadietto.png)
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
## Avertissements / informations importantes
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
### :warning: WARNING
2022-01-12 01:11:41 +01:00
Le paquet Armadietto_ynh est toujours en cours de développement, vous devez donc vous attendre à d'éventuels changements non documentés avant qu'il ne soit qualifié de stable.
2022-01-02 02:37:17 +01:00
2022-01-12 01:11:41 +01:00
### :information_source: Considérations sur la sécurité de [Armadietto](https://github.com/remotestorage/armadietto/) :
2022-01-01 16:14:00 +01:00
2022-01-12 01:11:41 +01:00
> #### **Sécurité du stockage**
2022-01-02 02:37:17 +01:00
>
2022-01-01 16:14:00 +01:00
> En production, nous vous recommandons de restreindre autant que possible l'accès aux fichiers gérés par votre serveur armadietto. Ceci est particulièrement vrai si vous hébergez votre stockage sur une machine avec d'autres applications web ; vous devez protéger vos fichiers dans le cas où l'une de ces applications serait exploitée.
>
> Vous devez prendre les mesures suivantes pour assurer la sécurité de votre stockage :
>
2022-01-02 02:37:17 +01:00
> - Choisissez un utilisateur Unix unique pour exécuter votre processus serveur ; aucun autre processus sur la machine ne doit être exécuté sous cet utilisateur : sudo useradd armadietto --system --no-create-home
2022-01-01 16:14:00 +01:00
>
2022-01-02 02:37:17 +01:00
> - Ne lancez pas d'autres applications en tant que root, ou en tant qu'utilisateur qui pourrait accéder à des fichiers appartenant à votre utilisateur armadietto.
2022-01-01 16:14:00 +01:00
>
2022-01-02 02:37:17 +01:00
> - Assurez-vous que le répertoire path/to/storage ne peut être lu, écrit ou exécuté par personne d'autre que cet utilisateur : sudo chmod 0700 /path/to/storage && sudo chown armadietto /path/to/storage
2022-01-01 16:14:00 +01:00
>
2022-01-02 02:37:17 +01:00
> - Ne lancez pas armadietto en tant que root ; si vous avez besoin de vous lier au port 80 ou 443, utilisez un reverse proxy comme nginx, Apache2, caddy, lighttpd ou activez la capacité de liaison : setcap 'cap_net_bind_service=+ep' `which armadietto`.
2022-01-01 16:14:00 +01:00
>
2022-01-02 02:37:17 +01:00
> - Idéalement, exécutez votre stockage dans un conteneur ou sur une machine dédiée.
2022-01-01 16:14:00 +01:00
2022-01-02 02:37:17 +01:00
<br />
2022-01-01 16:14:00 +01:00
2022-01-02 02:37:17 +01:00
### **Notes importantes**
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
- RemoteStorage nécessite un domaine dédié, il faut donc en obtenir un et l'ajouter en utilisant le panneau d'administration de YunoHost. **Domaines -> Ajouter un domaine**.
- Comme RemoteStorage utilise le domaine complet et est installé à la racine, vous pouvez créer un sous-domaine tel que remote.domain.tld.
- N'oubliez pas de mettre à jour vos DNS si vous les gérez manuellement.
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
- RemoteStorage nécessite des certificats SSL approuvés par le navigateur. Si vous disposez de certificats qui ne sont pas émis par [Let's Encrypt](https://letsencrypt.org/), installez-les manuellement comme d'habitude.
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
## TODO
* Toute limitation ou contrainte connue ou tout élément ne fonctionnant pas, tel que (mais non limité à) :
* architectures non prises en charge ?
* L'authentification unique ou l'intégration LDAP ne fonctionnent pas ?
* etc...
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
* D'autres informations que les gens devraient connaître, comme.. :
* toute étape spécifique à effectuer après l'installation (comme terminer manuellement l'installation, des identifiants d'administration spécifiques, ...)
* Comment configurer / administrer l'application si ce n'est pas évident.
* Spécificités, les choses à savoir ?
2021-12-17 11:38:57 +01:00
## Documentations et ressources
2022-01-01 16:14:00 +01:00
* Site officiel de l'app : https://remotestorage.io/
* Dépôt de code officiel de l'app : https://github.com/remotestorage/armadietto
* Documentation YunoHost pour cette app : https://yunohost.org/app_armadietto
* Signaler un bug : https://github.com/YunoHost-Apps/armadietto_ynh/issues
2021-12-17 11:38:57 +01:00
## Informations pour les développeurs
2022-01-01 16:14:00 +01:00
Merci de faire vos pull request sur la [branche testing](https://github.com/YunoHost-Apps/armadietto_ynh/tree/testing).
2021-12-17 11:38:57 +01:00
2022-01-01 16:14:00 +01:00
Pour essayer la branche testing, procédez comme suit.
2021-12-17 11:38:57 +01:00
```
2022-01-01 16:14:00 +01:00
sudo yunohost app install https://github.com/YunoHost-Apps/armadietto_ynh/tree/testing --debug
ou
2022-01-01 16:14:00 +01:00
sudo yunohost app upgrade armadietto -u https://github.com/YunoHost-Apps/armadietto_ynh/tree/testing --debug
2021-12-17 11:38:57 +01:00
```
2022-01-01 16:14:00 +01:00
**Plus d'infos sur le packaging d'applications :** https://yunohost.org/packaging_apps