Commit 021bb310 authored by Rémy Lebrun's avatar Rémy Lebrun

Update installation_stretch.rst

parent adf1172d
......@@ -39,7 +39,7 @@ Clonage du dépot dbChiro[web]
C'est la méthode recommandée pour faciliter les mises à jour.
**dbchiroweb** sera installé dans le dossier `/var/www/dbchiro`, il est conseiller de conserver cet emplacement sous peine de devoir adapter la suite de l'installation (chemins et configuration de apache2).
**dbchiroweb** sera installé dans le dossier ``/var/www/dbchiro``, il est conseiller de conserver cet emplacement sous peine de devoir adapter la suite de l'installation (chemins et configuration de apache2).
.. code-block:: sh
......@@ -151,16 +151,11 @@ Initialisation de la base de données
Pour ce projet, deux configurations de ``settings`` sont possibles:
* ``production`` pour le serveur en production
* ``dev`` pour le développement. Avec notamment le mode de débogage et l'appli django-debug-toolbar
* ``production`` pour le serveur en production, qui force l'utilisation du httpS et désactive le mode ``DEBUG``,
* ``dev`` pour le développement, qui ne force pas le httpS et active le mode de débogage ainsi que l'appli django-debug-toolbar.
Les instruction suivantes sont donnée pour le ``dev`` mais il est possible de remplacer ``dev`` par ``production`` pour un déploiement en production.
Notez que la dernière instruction lance le serveur, mentionner l'adresse IP de votre serveur et le port 8000 (qui doit être renseigné dans le fichier de configuration CUSTOM_HOSTS).
.. Attention::
En configuration ``dev``, les fichiers statiques (css, js, images) sont servis par Django alors qu'en configuration ``production`` (quand DEBUG=False), c'est **apache2** qui doit prendre le relais.
De plus, sans certificat SSL, une erreur apparaitre côté web : **Échec de la connexion sécurisée**.
Les instructions ci-dessous permettent de tester l'application en mode ``dev``.
Notez que la dernière instruction lance le serveur, mentionner l'adresse IP de votre serveur et le port 8000.
.. code-block:: sh
......@@ -192,6 +187,15 @@ Le terminal devrait alors renvoyer le résultat suivant:
Vous pouvez donc tester l'application à cette adresse : http://123.456.789.10:8000/
Les requêtes apparaitrons en temps réel dans le terminal. Cela permet de tester le bon fonctionnement de l'application avant de la placer en production.
Pour quitter, faire ``Ctrl+c``, Django stope alors le serveur et l'application n'est plus accessible.
Si tout fonctionne en mode ``dev``, on peut alors passer en déploiement ``production``
.. Attention::
Si vous reproduisez le code ci-dessus avec la configuration ``production``, vous obtiendrez sans doute des erreurs à cause du httpS.
En effet, ``runserver`` exécute un environnement de développement en http alors que la configuration ``production`` force le httpS.
De plus, en configuration ``dev``, les fichiers statiques (css, js, images) sont servis par Django alors qu'en configuration ``production`` (quand DEBUG=False), c'est **apache2** qui doit prendre le relais.
Par défaut, ``wsgi.py`` utilise la configuration ``production``, la configuration ``apache2`` plus bas permet
Intégration des données initiales (dictionnaires et geodata)
============================================================
......@@ -223,6 +227,11 @@ Plus d'informations sur cette commande ici: http://bostongis.com/pgsql2shp_shp2p
shp2pgsql -s 2154:4326 -a datas/shapefiles/territory.shp public.geodata_territory | psql -h localhost -U dbchiropguser dbchirodb
shp2pgsql -s 2154:4326 -a datas/shapefiles/municipality.shp public.geodata_municipality | psql -h localhost -p 5432 -U dbchiropguser dbchirodb
Déploiement de l'environnement en production
============================================================
Personnalisation du logo
-----------------------
Le logo du bandeau supérieur du site est à placer dans le dossier des fichiers statiques ``core/static/img/logo_site.png``. Le logo du projet est fourni par défaut. Pour l'installer, il suffit d’exécuter la commande suivante:
......@@ -245,15 +254,15 @@ Ce sont les fichiers ``*.css``, ``*.js`` et les images qui font le thème et le
L'ensemble des fichiers statiques sont collectés dans le dossier ``static`` sous l'arborescence ``dbchiroweb``.
Configuration du serveur apache
===============================
Configuration du serveur apache pour la production
-----------------------------------
Crééez le fichier de configuration du serveur apache. Cela par du principe que le domaine, ou sous-domaine, dispose d'une redirection vers l'adresse IP du présent serveur.
Plus d'informations à cette adresse: https://docs.djangoproject.com/fr/1.11/howto/deployment/wsgi/modwsgi/
.. code-block:: sh
# Activation du module wsgi
# Activation du module wsgi (normalement déjà activé)
a2enmod wsgi
# Copiez l'exemple de fichier de configuration apache pour dbChiro dans le dossier des sites disponibles d'apache et adaptez le à votre installation (remplacer ``mondomaine.org`` par votre nom de domaine et ``admin@dbchiro.org`` par votre adresse email).
cd /var/www/dbchiro/dbchiroweb
......@@ -286,7 +295,7 @@ Voici à quoi doit ressembler le fichier.
ErrorLog /var/www/dbchiro/error.log
</VirtualHost>
Vérifier la syntaxe de votre configuration apache2, qui doit retourner uniquement ``Syntax OK``, si ce n'est pas le cas, revoyez votre fichier :
Vérifier la syntaxe de votre configuration ``apache2``, qui doit retourner uniquement ``Syntax OK``, si ce n'est pas le cas, revoyez votre fichier :
.. code-block:: sh
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment