.. note::

   Cette documentation est en cours de redaction. Pour toutes questions n'hésitez pas à nous envoyer un email sur `community@risefor.org <community@risefor.org/>`_
   ou à ouvrir un ticket `directement sur git <https://git.risefor.org/installation/>`_

**********************
3. Déploiement sur le serveur
**********************

.. contents:: Table des matières
    :local:
    :depth: 2


==============
Etape 1 - Installation des pré-requis
==============


==============
Etape 2 - Installation des fichiers Risefor
==============

==============
Etape 3 - Mise en place de la base de données
==============

==============
Etape 4 - Parametrage de nginx et uwsgi
==============


==============
Etape 5 - Mise en place des process automatisés (crontab)
==============

==============
Etape 5 - Validations
==============


==============
Utilisation service Risefor
==============

.. warning::
   Le service Risefor fait parti de la v2 de l'installation.
   
   Cette dernière est toujours en cours de développement.



Étape 1 : Placer les fichiers
---------------

1. Positionnez vous dans le dossier `/var/risefor-server-configs`` directory:

.. code-block:: shell

   cd /var/risefor-server-configs
   git checkout v2

2. Déplacez les fichiers de configuration au bon endroit

.. tips::
   
   En cas d'erreur de permission, lancez les commandes en ``sudo``, ou faites ``sudo -i`` avant de commencer.

.. code-block:: shell

   cp services/systemd/risefor.service /etc/systemd/system/
   cp services/systemd/risefor.target /etc/systemd/system/
   #if not created
   mkdir -p /etc/risefor/scripts/
   cp services/systemd/risefor_custom_handler.sh /etc/risefor/scripts/risefor_custom_handler.sh

Étape 2 : Gestion des permissions
---------------

Nous partons du principe que votre utilisateur publique est ``www-data``. Si votre configuration est différentes veuillez adapter les commandes en conséquence.

.. code-block:: shell
   
   # ownership
   chown -R www-data:www-data /etc/risefor/
   # allow execusion
   chmod +x /etc/risefor/scripts/risefor_custom_handler.sh

Étape 3 : Redemarrez systemd et activez/démarrez les services
---------------

1. Rechargez systemd

.. code-block:: shell

   sudo systemctl daemon-reload

2. Activez ``risefor.target`` pour déclarer la commande ``risefor``

.. code-block:: shell

   sudo systemctl enable risefor.target
   sudo systemctl start risefor.target


Étape 4 : Redemarrez les services liés, si besoin
---------------

.. tips::
   Si vous n'avez pas choisi l'utilisation de ``postfix`` et ``postgresql`` lors de votre installation, veuillez les supprimer dans la commande si dessous.


.. code-block:: shell

   sudo systemctl restart uwsgi nginx postfix pgsql



Vérification 
---------------

La commande ``risefor`` devrait être disponible pour gérer les services associés.

Pour tester vous pouvez faire un  ``risefor test``, si tout c'est bien passé vous devriez voir :

.. code-block:: console

   Hey you ! the risefor command works fine.


Commandes disponibles 
---------------

^^^^^^^^^^^^^^
Affichages des logs
^^^^^^^^^^^^^^

Vous pouvez affichez les logs liés aux services directement via la commande

``risefor logs [uwsgi|nginx|postfix|pgsql]``

Exemples : 

.. code-block:: shell
   
   risefor logs uwsgi -f
   #displays uwsgi log in realtime

   risefor logs -f
   #displays realtime logs of all services


^^^^^^^^^^^^^^
Gestions des services liés
^^^^^^^^^^^^^^
Vous pouvez gérer les services liés à votre instance avec la commande 

``risefor [reload|restart|start|stop] [uwsgi|nginx|postfix|pgsql]``

Exemples : 

.. code-block:: shell
   
   risefor uwsgi restart
   #uwsgi restarting

   risefor nginx reload
   #nginx reloading

^^^^^^^^^^^^^^
Affichages services liés
^^^^^^^^^^^^^^

Pour afficher les services liés à votre installation Risefor il vous suffit d'utiliser la commande ``packages``


.. code-block:: bash

   risefor packages
   #display des package liés, équivalent à la commande systemctl list-units --full --all | grep risefor