upd: README.md (installation instructions)

2017-11-29 13:50:52 +01:00 · 2017-11-29 13:50:52 +01:00 · bad67426a5
parent 6443dbbf7e
commit bad67426a5
1 changed files with 142 additions and 1 deletions
--- a/README.md
+++ b/README.md
@ -8,4 +8,145 @@
    - Lucas Mascaro
    - Guillaume Fauvet
    - Adrien Marquès
-```
+```
+
+
+# Installation
+
+### 1. Clonage des sources
+
+Placez vous dans le dossier qui contiendra le projet
+
+```bash
+> git clone https://git.xdrm.io/ndli1718/main.git ndli1718-web;
+```
+
+Si le clonage a fonctionné, il doit maintenant contenir un nouveau dossier `ndli1718-web` contenant les sources.
+
+### 2. Créer un lien pour Apache/nginx
+
+Toujours dans le dossier parent (celui qui contient `ndli1718-web`)
+
+##### 1. Sous apache
+
+```bash
+> ln -s ndli1718-web /var/www/ndli1718-web;
+```
+
+##### 2. Sous Nginx
+
+```bash
+> ln -s ndli1718-web /usr/local/nginx/html/ndli1718-web;
+```
+
+
+### 3-1. Configuration Apache
+
+> Si vous n'avez pas apache
+> ```bash
+> sudo apt-get install apache2 libapache2-mod-php mysql-server php-mysql php;
+> ```
+
+##### 1. Créer l'hôte virtuel
+
+Créer le fichier `/etc/apache2/sites-available/ndli1718.conf`
+
+```xml
+<VirtualHost *:80>
+	ServerName ndli1718
+
+	ServerAdmin mail@example.com
+	DocumentRoot /var/www/ndli1718-web
+
+	ErrorLog ${APACHE_LOG_DIR}/ndli1718-error.log
+	CustomLog ${APACHE_LOG_DIR}/ndli1718-access.log combined
+
+	#Include conf-available/serve-cgi-bin.conf
+</VirtualHost>
+```
+
+
+##### 2. Enregistrer le nom de domaine local
+
+Ajouter la ligne suivante dans le fichier `/etc/hosts`
+
+```txt
+127.0.0.1	ndli1718
+```
+
+Cela permettra à apache au lieu de chercher le nom de domaine `ndli1718` (qui n'existe pas) de rediriger directement vers vous-même. (Localhost au lieu de passer par des serveurs DNS).
+
+##### 3. Corriger les permissions
+
+Dans le dossier des sources (ndli1718-web):
+
+```bash
+> source /etc/apache2/envvars;
+> sudo chown -R $USER:$APACHE_RUN_USER .;
+> sudo chmod -R 775 .;
+> sudo chmod -R g+s .;
+```
+
+
+##### 4. Activer l'hôte virtuel
+
+```bash
+> sudo a2ensite ndli1718.conf;
+> sudo service apache2 reload;
+```
+
+
+##### 5. Test de la configuration
+
+Ouvrer le navigateur de votre choix avec l'URL `http://ndli1718/`.
+
+Si la page ne fonctionne pas, vérifiez dans les logs d'apache de quoi il s'agit.
+
+```bash
+> tail -f /var/log/apache2/ndli1718-error.log;
+```
+
+
+
+### 3-2. Configuration nginx
+
+**TODO**
+
+
+### 4. Installation webpack / vuejs
+
+##### 1. Installation de nodejs+npm
+
+Installation de node js (ajout du repository officiel)
+```bash
+> curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash -
+> sudo apt-get install -y nodejs
+```
+
+##### 2. Mise à jour de npm
+
+```bash
+> npm install -g npm@latest;
+```
+
+*Attention:* Si vous n'avez pas les permissions et qu'il vous demande d'être **root**, suivez ce [tuto](https://docs.npmjs.com/getting-started/fixing-npm-permissions).
+
+
+##### 3. Installation de vue-cli
+
+```bash
+> npm install -g vue-cli;
+```
+
+##### 4. Construction du projet
+
+Dans le dossier du projet `ndli1718-web`, lancez les commandes suivantes:
+
+```bash
+> npm install;
+> touch ./public_html/js/bundle@a.{js,js.map};
+> npm run build;
+```
+
+
+**.. voila ..**