1
0
Fork 0
mirror of https://github.com/YunoHost-Apps/redirect_ynh.git synced 2024-09-03 20:16:10 +02:00
redirect_ynh/README_fr.md
2023-11-02 22:21:40 +00:00

3.6 KiB
Raw Blame History

Redirect pour YunoHost

Niveau d’intégration Statut du fonctionnement Statut de maintenance

Installer Redirect avec YunoHost

Read this readme in english.

Ce package vous permet dinstaller Redirect rapidement et simplement sur un serveur YunoHost. Si vous navez pas YunoHost, regardez ici pour savoir comment linstaller et en profiter.

Vue densemble

Cette application permet d'intégrée une tuile personalisée dans le portail utilisateur de YunoHost. Les cas d'usage typiques sont:

  • redirection 301/302 visible : avoir une tuile d'app "virtuelle" qui se contente de rediriger vers une autre url ou un site externe
  • redirection invisible / reverse-proxy : créer une tuile pour une application locale écoutant sur un port précis, ou bien un conteneur Docker, ou encore une app hébergée sur une autre machine

En terme technique: cette app se contente de rajouter le morceau de configuration NGINX approprié avec soit redirect ou proxy_pass, et la tuile YunoHost + configuration SSOwat correspondante.

Version incluse : 1.0.2~ynh2

Avertissements / informations importantes

Types de redirection

Redirection visible

Le client sera redirigé vers une autre URL ou site externe

  • votre-domaine.com -> un-autre-domaine.net
  • votre-domaine.com/foo -> un-autre-domaine.net/bar

Redirection invisible (a.k.a "reverse-proxy")

L'adresse du client restera inchangé dans le navigateur. Typiquement utilisé pour intéger dans YunoHost une application installée manuellement.

  • you-domain.com/foo -> http://172.0.0.1:8080/app

IMPORTANT: il vous faudra peut-être bricoler manuellement redirect.conf dans la configuration nginx, en fonction de vos besoins.

IMPORTANT: Certaines apps ne supportent pas d'être redirigées depuis un chemin différent à cause du fonctionnement des liens relatifs ... Cela signifie que par exemple une app hébergée sur http://127.0.0.1:5050/app/ DOIT être routé sur http://domaine.tld/app/ et PAS http://domaine.tld/unautrechemin/. Par exemple: un conteneur Docker Odoo tourne sur http://127.0.0.1:8069/. Il ne sera pas capable de fonctionné correctement si il est routé sur http://domaine.tld/odoo/ ! Il faut forcément l'installer à la racine d'un domaine, par exemple http://odoo.domaine.tld/

Documentations et ressources

Informations pour les développeurs

Merci de faire vos pull request sur la branche testing.

Pour essayer la branche testing, procédez comme suit.

sudo yunohost app install https://github.com/YunoHost-Apps/redirect_ynh/tree/testing --debug
ou
sudo yunohost app upgrade redirect -u https://github.com/YunoHost-Apps/redirect_ynh/tree/testing --debug

Plus dinfos sur le packaging dapplications : https://yunohost.org/packaging_apps