Note

Cette documentation est en cours de redaction. Pour toutes questions n’hésitez pas à nous envoyer un email sur community@risefor.org ou à ouvrir un ticket directement sur git

3. Déploiement sur le serveur

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 

Avertissement

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 

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

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

Déplacez les fichiers de configuration au bon endroit

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.

# 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 

Rechargez systemd

sudo systemctl daemon-reload

Activez risefor.target pour déclarer la commande risefor

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

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

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 :

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 :

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

Exemples :

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

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