157 lines
4.4 KiB
ReStructuredText
Executable File
157 lines
4.4 KiB
ReStructuredText
Executable File
|
|
*************
|
|
Environnement
|
|
*************
|
|
|
|
Préparation
|
|
===========
|
|
|
|
On prépare l'environement pour accueillir notre application Django. On considère que le serveur est un système GNU/Linux, basé sur une distribution Debian ou Ubuntu. Si vous vous basez sur un autre système d'exploitation ou une autre distribution, adaptez en fonction.
|
|
|
|
Il faut d'abord rajouter certains paquets qui seront nécessaires pour compiler certains module Python:
|
|
|
|
.. code-block:: shell
|
|
|
|
$$$ aptitude install libpq-dev python3-dev
|
|
|
|
On créé un utilisateur dédié, pour limiter les accès au serveur dans le cas où notre application serait piratée.
|
|
|
|
.. code-block:: shell
|
|
|
|
$$$ groupadd --system webapps
|
|
$$$ useradd --system --gid webapps --shell /bin/bash --home /webapps/gwift gwift
|
|
|
|
Ensuite, on crée le repertoire où se trouvera notre application et on lui attribue le bon utilisateur:
|
|
|
|
.. code-block:: shell
|
|
|
|
$$$ mkdir -p /webapps/gwift
|
|
$$$ chown gwift:webapps /webapps/gwift
|
|
|
|
Puis on crée notre environement virtuel:
|
|
|
|
.. code-block:: shell
|
|
|
|
$$$ su - gwift
|
|
gwift@gwift:~$ mkvirtualenv -p /usr/bin/python3 gwift
|
|
Already using interpreter /usr/bin/python3
|
|
Using base prefix '/usr'
|
|
New python executable in gwift/bin/python3
|
|
Also creating executable in gwift/bin/python
|
|
Installing setuptools, pip...done.
|
|
(gwift)gwift@gwift:~$
|
|
|
|
|
|
On peut maintenant cloner notre projet:
|
|
|
|
.. code-block:: shell
|
|
|
|
(gwift)gwift@gwift:~$ git clone git@framagit.org:Grimbox/gwift.git
|
|
|
|
Et installer les dépendances:
|
|
|
|
.. code-block:: shell
|
|
|
|
(gwift)gwift@gwift:~$ pip install -r requirements/production.txt
|
|
|
|
|
|
Le fichier ``production.txt`` contient les librairies pour gunicorn et PostgreSQL:
|
|
|
|
.. code-block:: shell
|
|
|
|
-r base.txt
|
|
|
|
gunicorn
|
|
psycopg2
|
|
setproctitle
|
|
|
|
Configuration
|
|
=============
|
|
|
|
Il ne nous reste plus qu'à mettre à jour la DB. On commance par créer le fichier de configuration de l'application en production:
|
|
|
|
.. code-block:: shell
|
|
|
|
(gwift)gwift@gwift:~$ touch gwift/gwift/settings/local.py
|
|
|
|
Et le contenu de local.py, avec la clé secrète, les paramètres pour se connecter à la DB et l'endroit où mettre les fichiers statics (voir point suivant):
|
|
|
|
.. code-block:: python
|
|
|
|
from .production import *
|
|
|
|
# SECURITY WARNING: don't run with debug turned on in production!
|
|
DEBUG = False
|
|
|
|
# SECURITY WARNING: keep the secret key used in production secret!
|
|
SECRET_KEY = 'strong_secret_key'
|
|
|
|
# Allowed host needed to be defined in production
|
|
ALLOWED_HOSTS = ["sever_name.com", "www.sever_name.com"]
|
|
|
|
# Be sure to force https for csrf cookie
|
|
CSRF_COOKIE_SECURE = True
|
|
|
|
# Same for session cookie
|
|
SESSION_COOKIE_SECURE = True
|
|
|
|
# DB
|
|
DATABASES = {
|
|
'default': {
|
|
'ENGINE': 'django.db.backends.postgresql_psycopg2',
|
|
'NAME': 'gwift',
|
|
'USER': 'gwift_user',
|
|
'PASSWORD': 'gwift user password',
|
|
'HOST': 'localhost',
|
|
'PORT': '', # Set to empty string for default.
|
|
}
|
|
}
|
|
|
|
# Add static root
|
|
STATIC_ROOT = "/webapps/gwift/gwift/static"
|
|
|
|
STATICFILES_DIRS = [
|
|
os.path.join(BASE_DIR, "static"),
|
|
]
|
|
|
|
Finalement, on peut mettre à jour la DB et créer un super utilisateur:
|
|
|
|
.. code-block:: shell
|
|
|
|
(gwift)gwift@gwift:~$ python manage.py migrate
|
|
(gwift)gwift@gwift:~$ python manage.py createsuperuser
|
|
|
|
Fichiers statics
|
|
================
|
|
|
|
Django n'est pas fait pour servir les fichiers statics. Tous les fichiers statics doivent donc être déplacés dans un répertoire pour que Nginx puisse les servir facilement.
|
|
|
|
On commence par créer le répertoire où mettre les fichiers statics comme configuré dans le fichier local.py:
|
|
|
|
.. code-block:: shell
|
|
|
|
(gwift)gwift@gwift:~$ mkdir /webapps/gwift/gwift/static
|
|
|
|
Et on utilise django pour copier tous les fichiers statics au bon endroit:
|
|
|
|
.. code-block:: shell
|
|
|
|
(gwift)gwift@gwift:~$ python manage.py collectstatic
|
|
|
|
|
|
Test
|
|
====
|
|
|
|
On peut tester si tout fonctionne bien en lançant le serveur avec Django:
|
|
|
|
.. code-block:: shell
|
|
|
|
(gwift)gwift@gwift:~$ python manage.py runserver sever_name.com:8000
|
|
|
|
Et en se rendant sur server_name.com:8000/admin, on obtient:
|
|
|
|
.. image:: production/admin_without_static.png
|
|
:align: center
|
|
|
|
Comme on peut le voir, il n'y a pas de mise en forme de la page car les fichiers statics ne sont pas encore servis. Ils le seront par Nginx.
|