Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:install_khaganat_web [2018/11/07 14:43] – zatalyz
+++ fr:install_khaganat_web [2021/12/03 18:19] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 30: / Ligne 30: @@
   cd khaganat-web
-Puis modifier les variables d'environnement :
+Puis modifier les variables d'environnement en créant le fichier ''.env'' dans le dossier ''khaganat-web'' :
   nano .env
-Adaptez le fichier suivant. Les deux variables KHAGANAT_SECRET_KEY, KHAGANAT_HOSTNAMES et KHAGANAT_STATIC_ROOT doivent impérativement être remplies :
+Adaptez le fichier avec les paramètres suivants. Les deux variables KHAGANAT_SECRET_KEY, KHAGANAT_HOSTNAMES et KHAGANAT_STATIC_ROOT doivent impérativement être remplies :
 <code>
 # KHAGANAT_SECRET_KEY (required)='' Django's secret key, keep it secret (tip='' generate one using openssl rand -base64 42).
@@ Ligne 76: / Ligne 76: @@
 </code>
+==== Collecter les static ou non ====
-Le script collectstatic concerne les véritables déploiements, ce n'est pas nécessaire si vous utilisez runserver.
+Le script collectstatic concerne les véritables déploiements, ce n'est pas nécessaire si vous utilisez runserver (la façon de gérer les choses en développement). ''collectstatic'' va gérer les fichiers "statiques" : css, images des thèmes. Il va les rassembler dans un répertoire dédié, où un serveur web pourra ensuite les trouver. Si vous souhaitez le mettre en place (et on insiste, c'est inutile en prod), modifiez la valeur ''KHAGANAT_STATIC_ROOT='' dans le fichier .env afin de pointer vers un dossier vide lors du premier déploiement, et accessible au serveur web (''/var/www/html'' par défaut sur Debian+Apache, par exemple).
-Avant d'aller plus loin il faut paramétrer apache ou nginx ; le readme se base sur nginx donc on va adapter à Debian :
+Lancez ensuite la commande suivante :
+  pipenv run ./manage.py collectstatic --clear --noinput
+==== Le serveur web ====
+Avant d'aller plus loin il faut paramétrer apache ou nginx.
+<WRAP center round todo 60%>
+Ce qui suit est à travailler/adapter afin que ça corresponde à votre installation (et à la notre...)
+</WRAP>
+Dans le cas d'un déploiement en mode développement (pas de la production !) on va utiliser un utilitaire fourni avec Django, appelé "runserver". Ce dernier va lancer Django en utilisant un port. Si vous utilisez un serveur simple, il suffira de paramétrer [[fr:lamp|Apache]] ou Nginx de façon basique, puis de se rendre à l'adresse "monsite.com:8000" (par défaut) après avoir lancé la commande suivante :
+  pipenv run ./manage.py runserver 0:8000
+  * 0 permet qu'on y accède même si ce n'est pas sur le réseau local (par défaut, c'est localhost)
+  * 8000 est le port utilisé, qu'on peut changer
+  * Pensez à lancer le runserver dans un shell à part, c'est un serveur donc il ne s'arrêtera pas de tourner tant que qu'on ne l'aura pas quitté (CTRL+C) ou fait planter.
+L'intérêt de runserver, c'est que vous pouvez faire des modifications dans les fichiers Django, recharger la page et "ça marche" ! En production, avec une vraie configuration, il faudra lancer des commandes pour que ce soit pris en compte. Mais de toute façon, personne ne modifie un serveur en production directement.
+<WRAP center round info 90%>
+Si comme nous, vous êtes derrière un proxy, il faudra modifier sur la config du proxy afin que cela point vers le port de votre VM.
+Sur la VM du proxy, config apache (''/etc/apache2/site-enabled/monsite.conf'') :
+<code>[...]
+ProxyPass / http://192.168.20.13:8000/
+ProxyPassReverse / http://192.168.20.13:8000/
+ProxyRequests off
+ProxyPreserveHost on
+                <Proxy *>
+                Options FollowSymLinks MultiViews
+                AllowOverride All
+                Order allow,deny
+                allow from all
+                </Proxy>
+[...]</code>
+Et sur la VM où Django est installé :
+<code>[...]
+ProxyRequests off
+ProxyPreserveHost on
+       ProxyPass / http://192.168.20.13:8000/
+        <Location />
+            ProxyPassReverse http://192.168.20.13:8000/
+            Require all granted
+        </Location>
+[...]</code>
+Ensuite la commande suivante fonctionnera :
+  pipenv run ./manage.py runserver 0:8000
+</WRAP>
+Je déconseille de pointer ailleurs qu'à la racine, à moins de savoir changer les comportements de Django.
+<WRAP center round todo 60%>
+Le readme se base sur nginx. Il faudrait adapter à Debian, à notre installation avec proxy/apache, etc.
+Paquets à installer sous Debian.
   sudo apt install nginx-extras uwsgi uwsgi-plugin-python3
+</WRAP>
+==== Premier lancement ====
+Au premier lancement, il n'y a pas de page créé sur la racine du site, ce qui fait peur (pleins d'erreurs !).
+Il suffit de se rendre à l'adresse monsite.net/admin/ (ou monsite.net:8000/admin/ si vous n'avez pas de reverse proxy), de vous connecter avec les identifiants renseignés à la partie "création d'un super admin", de sélectionner le module des pages et d'ajouter une page d'accueil. Et voilà !
+==== Récupérer le détail de Khaganat ====
+<WRAP center round todo 60%>
+Pour le moment, ce n'est pas sur un dépôt public.
+Suffit de copier la base de donnée :
+  scp cipra.khaganat.net:/var/www/khaganat-web/db.sqlite3 db.sqlite3
+</WRAP>
+==== Yakalfr lié : faire le css ====
+[[taf>fr:taf:web:ergonomie:cipra|C'est ici]] sur le taf, le détail de ce qu'il faut faire pour que Cipra aie un css qui donne une identité à Khaganat.
+===== Astuces et trucs utiles =====
+==== Exporter la navbar ====
+Pour exporter la navbar, afin de l'intégrer dans un thème Dokuwiki par exemple :
+<code>
+cd /var/www/khaganat-web
+‎pipenv run ./manage.py navbar_export --lang fr --docuwiki
+</code>
+Le résultat sera dans ''build/navbar/''.
-==== Démarrer le service ====
+pour lister toutes les option d'export :
+‎  pipenv run ./manage.py navbar_export -h
-  pipenv run ./manage.py runserver
-Pensez à lancer le runserver dans un shell à part, c'est un serveur donc il ne s'arrêtera pas de tourner tant que qu'on le n'aura pas quité ou fait planter.
 {{tag>Tutoriel Brouillon Programmation Serveur Web}}