upd: README.md (installation instructions)

This commit is contained in:
xdrm-brackets 2017-11-29 13:50:52 +01:00
parent 6443dbbf7e
commit bad67426a5
1 changed files with 142 additions and 1 deletions

141
README.md
View File

@ -9,3 +9,144 @@
- Guillaume Fauvet - Guillaume Fauvet
- Adrien Marquès - 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 ..**