Commençons par mettre à jour toutes les applications : apt-get update && apt-get upgrade
1. Créer un nouvel utilisateur
Avant de commencer l’installation de l’espace de développement, créez un utilisateur.
- Connectez-vous en root :
su
ou su root
.
- Pour créer un nouvel utilisateur, utilisez la commande
adduser a312
où a312 est votre username.
Installer sudo
Profitons d’être toujours connecté en root, pour installer sudo. Nous aurons besoin du package sudo pour la commande makefile.
- Installez sudo :
apt-get install sudo
.
- Puis ajoutez l’utilisateur username (ici : a312) :
usermod -aG sudo a312
.
Sauf indication contraire vous ne devez pas utiliser sudo avec les commandes qui suivent.
2. Télécharger le dépôt du zds avec git
Avant de pouvoir télécharger le dépôt, vous devez forker le dépôt en cliquant sur fork.
- Vous êtes encore connecté au compte root, profitez-en pour installer git :
apt-get install git
.
- Connectez-vous au compte username précédemment créé :
su a312
.
- Allez dans votre répertoire :
cd ~
et créez un dossier mkdir zds
puis allez dans le dossier cd zds
.
- Pour télécharger le dépôt :
git clone https://github.com/VOUS/zds-site
. Pour moi, VOUS est le nom de mon compte donc A-312. Plus de détails ici mais vous aurez l’occasion de le lire plus tard.
Avant de continuer vous devez être dans le répertoire git : cd ~/zds/zds-site
.
- Si vous faites
git remote
vous devriez avoir origin.
- Ajoutez le remote :
git remote add upstream https://github.com/zestedesavoir/zds-site
et téléchargez la copie locale : git fetch upstream
.
- Désormais, la commande
git remote
doit afficher deux lignes : origin et upstream.
3. Commencer à installer le back-end
Dans le répertoire zds-site, faites make install-debian
. Pour les autres distributions de linux c’est ici.
Assurez-vous d’être dans le bon répertoire : cd ~/zds/zds-site
.
- Installez python-venv :
sudo apt-get install python3-venv
.
- Puis créez l’environnement zdsenv avec :
python3 -m venv zdsenv
.
Créer un alias pour accéder directement au répertoire et à l’environnement virtuel :
Pour créer un alias, vous devez ajouter une ligne au fichier ~/.bash_aliases avec la commande : echo "alias zdsenv=\"cd ~/zds/zds-site && source zdsenv/bin/activate\"" >> ~/.bash_aliases
.
5. Préparer le terrain pour le front-end
Pour utiliser le front end, il faut : node et yarn. Pour gérer différentes versions de nodejs, nous allons devoir installer nvm.
Installer nvm :
- Commencez par installer curl :
sudo apt install curl
.
- Récupérez la commande de téléchargement sur cette page qui commence par curl et exécutez-là.
- Pour activer nvm, vous devez soit relancer votre terminal, soit copier/coller le script indiqué en dessous de « run the following to use it now: » pour pouvoir utiliser la commande immédiatement. (Bien qu’un simple
source ~/.bashrc
devrait suffire, à confirmer).
- La commande
nvm
devrait afficher l’aide.
Installer nodejs :
- Vous devez vérifier la version actuellement utilisée sur cette page avant de continuer, actuellement c’est la version 8 donc :
nvm install 8.0.0
.
- Nodejs est installé ! Vérifiez avec :
node -v
qui indique v8.0.0.
Installer yarn :
- Installez yarn :
npm install -g yarn
.
- Vous pouvez vérifier l’installation avec
yarn -v
.
6. Installer le front-end
Activez l’environnement virtuel avant de commencer : zdsenv
.
- Confirmez l’utilisation de node 8.0.0 :
nvm use 8.0.0
.
- Installez le front-end avec :
yarn
, cette commande va exécuter make install-front.
- Profitez-en pour build le front avec :
yarn build
.
7. Finir l’installation du back-end
Pour finir l’installation du back-end (en étant dans l’espace virtuel zdsenv
), faites : make install-back && make migrate
. Vous pouvez tester l’installation avec : make run-back
et en allant sur http://127.0.0.1:8000/.
L’installation n’est pas encore prête pour un usage intensif, faites CTRL + C.