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

Installation - Option 1 - Utilisation des fichiers

Bienvenue sur la documentation pour installer une version personnalisée de Risefor ! Cela nous fais plaisir de vous voir ici.

Niveau en développement nécessaire
Ne pas avoir peur d’ouvrir et d’utiliser la ligne de commande (terminal)
Notre objectif est de simplifier et d’automatiser le processus au maximum

Besoin d’aide pour l’installation ?

N’hésitez pas à entrer en contact avec l’équipe, rendez-vous ici pour retrouver le lien vers le formulaire de contact

Avertissement

Cette section est en cours de rédaction En cas d’éléments manquant, vous pouvez retrouver le process d’installation par ici

1. Positionnement dans le terminal

Ouvrez le terminal et positionnez vous où vous souhaitez installer les fichiers, par exemple

cd
cd Documents/
mkdir Risefor #ce dossier contiendra tout ce qui concerne Risefor
mkdir Risefor/appli # dans ce dossier contiendra le code des déploiements
cd Risefor/

Traduction : Je vais dans le dossier documents, créé le dossier « Risefor », et me déplace dedant

2. Copie des fichiers d’installation

Clonez le dossier avec les scripts d’installation

git clone git@git.risefor.org:installation/installation-script.git
cd installation-script

3. Lancer l’installation

Nous avons fais un script automatisant l’installation des fichiers nécessaire, ainsi que la personnalisation des couleurs.

Pour lancer le script, entrez la commande suivante :

. install/localDeployment.sh

Ensuite vous avez juste à répondre aux questions. Une fois terminée, rendez-vous sur localhost:8000 où vous devriez voir le site tourner :)

Voici un vidéo de demonstration du script :)

Personnalisation Logo/Font/Couleurs: Si vous n’êtes pas sûr, vous pourrez toujours changer ces informations plus tard

4. Optionnel - Créez un compte pour héberger votre code sur git.risefor.org

Si vous souhaitez héberger le code de votre instance sur le git de Risefor, vous etes le.a bienvenue !

Il vous suffit de créer un compte sur notre instance

5. Mettez à jour la source d’hébergement de votre code

Pré-requis

Le script ayant tourné, vous devriez être positionné dans le dossier votre-instance/united4earth.

Pour être sûr de ceci, vous pouvez taper la commande suivante:

senza$ pwd
#ce qui affichera où vous êtes
../votre-instance/united4earth

1. Si l’affichage de pwd ne termine pas par votre-instance/united4earth ou votre-instance, vous devez vos y positionner avant de continuer. Normalement, cette commande devrais faire l’affaire :

cd
cd Documents/Risefor/votre-instance/

  1. Si vous etes dans votre-instance/united4earth veuillez taper :

cd ..

afin d’etre placé au niveau de votre-instance

Maintenant que vous êtes dans le bon dossier, nous pouvons continuer.

Le script d’installation a fait un git clone classique de repo principale. Vous pouvez pousser votre code dessus, avec la syntax risefor_instance/votre-nom

Cependant nous avons évolué vers un processus plus propre, celui d’avoir 1 fork par instance personnalisé, ce qui permet une meilleur gestion de votre code, des mises à jours de votre instance, ansi que votre gestion de projet.

Pour mettre à jour la source de votre code il vous suffit de taper la commande suivante :

git remote set-url origin https://git....

Dans la mise en pratique ci-dessous, nous allons partir du principe que vous avez créé un compte sur git.risefor.org. Dans le cas contraire, remplacez le nom de domaine par votre instance git

Mise à jour du sources « front end »

  1. Mise a jour du fichier config

Pour mettre à jour l’origin du code du front il vous suffit de taper :

git remote set-url origin git@git.risefor.org:votre-nom/risefor-front/

⚠️ Assurez-vous bien de changer votre-nom par le nom de compte que vous avez utilisez sur git ! Vous pouvez retrouver votre nom de compte directement sur git.

  1. Votre premier « push »

Pour vous assurez que tout a bien fonctionné, faite votre premier « git push » en tapant:

git push origin risefor-front/master

Avertissement

C’est normal si vous ne voyez rien en tapant votre mot de passe dans la console. C’est une sécurité supplémentaire, mais ce que vous tapez est bien pris en compte !

Si tout c’est bien passé vous verrez les fichiers sur votre compte ici https://git.risefor.org/votre-nom/risefor-front/

Mise à jour du sources « backend »

  1. Mise a jour du fichier config

Pour mettre à jour l’origin du code du front il vous suffit de taper :

cd risefor-lobbying
git remote set-url origin git@git.risefor.org:votre-nom/risefor-lobbying/

⚠️ Assurez-vous bien de changer votre-nom par le nom de compte que vous avez utilisez sur git ! Vous pouvez retrouver votre nom de compte directement sur git.

  1. Votre premier « push »

Pour vous assurez que tout a bien fonctionné, faite votre premier « git push » en tapant:

git push origin master

Avertissement

C’est normal si vous ne voyez rien en tapant votre mot de passe dans la console. C’est une sécurité supplémentaire, mais ce que vous tapez est bien pris en compte !

Si tout c’est bien passé vous verrez les fichiers sur votre compte ici https://git.risefor.org/votre-nom/risefor-lobbying/

Vous pouvez maintenant personnaliser ce que vous voulez sur votre instance, nous vous demandons juste de respecter les mentions de « Risefor » et ne pas les supprimer.

Pour plus d’information sur la personnalisation de l’instance, rendez-vous sur la page dédié !