Document installation in production

README.md

@@ -62,7 +62,69 @@ accessible depuis l'ensemble de votre réseau, pratique pour tester le rendu
 de la note sur un téléphone !
 
 ## Installation d'une instance de production
-TODO
+
+**En production on souhaite absolument utiliser les modules Python packagées
+dans le gestionnaire de paquet.** Cela permet de mettre à jour facilement les
+dépendances critiques telles que Django. L'installation d'une instance de
+production néccessite **une installation de Debian Bullseye**.
+
+1.  **Installation des dépendances APT.**
+    On tire les dépendances le plus possible à partir des dépôts de Debian.
+
+    ```
+    $ sudo apt install nginx git gettext uwsgi python3-venv \
+        python3-certbot-nginx python3-django python3-django-crispy-forms \
+        python3-django-taggit python3-pil python3-exifread
+    ```
+
+2.  **Clonage du dépot dans `/var/www/photos/photo21`**
+
+    ```
+    # on se place dans /var/www/photos/
+    $ sudo git clone https://gitlab.crans.org/bde/photo21.git && cd photo21
+    $ sudo mkdir static media
+    $ sudo chown www-data:www-data -R static media
+    $ sudo chmod g+rwx -R static media
+    ```
+
+3.  **Création d'un environment de travail Python décorrélé du système.**
+
+    ```bash
+    $ python3 -m venv venv --system-site-packages
+    $ source venv/bin/activate  # entrer dans l'environnement
+    (env)$ pip3 install -r requirements.txt
+    (env)$ deactivate  # sortir de l'environnement
+    ```
+
+
+4.  **Configuration de UWSGI et NGINX.**
+
+    ```bash
+    $ sudo cp docs/uwsgi_photos.ini /etc/uwsgi/apps-available/uwsgi_photos.ini
+    $ sudo ln -s /etc/uwsgi/apps-available/uwsgi_photos.ini /etc/uwsgi/apps-enabled/
+    $ sudo cp docs/nginx_photos /etc/nginx/sites-available/photos.crans.org
+    $ sudo ln -s /etc/nginx/sites-available/photos.crans.org /etc/nginx/sites-enabled/
+    ```
+
+5.  **Base de données.**
+    En production on utilise PostgreSQL. 
+
+    ```bash
+    $ sudo apt install postgresql postgresql-contrib
+    $ sudo -u postgres psql
+    postgres=# CREATE USER photo21 WITH PASSWORD 'un_mot_de_passe_sur';
+    postgres=# CREATE DATABASE photo21 OWNER photo21;
+    ```
+
+6.  **Migrations et collecte des fichiers statiques**,
+
+    ```
+    $ sudo -u www-data ./venv/bin/python ./manage.py collectstatic
+    $ sudo -u www-data ./venv/bin/python ./manage.py check
+    $ sudo -u www-data ./venv/bin/python ./manage.py migrate
+    ```
+
+7.  *Enjoy \o/*
 
 ## Documentation