# Projet Corpus de la parole

## Prérequis
La plateforme de dévelopement visée est MacOS et Linux.
Les éléments suivant sont des prérequis:
  - php >= 5.6
  - Vagrant
  - Ansible.
  - node

### php

### node

### Vagrant
Vagrant est utilisé pour le développement du back-office et la contruction des pacquets RPM.

### Ansible
Ansible n'est nécessaire que pour lancer l'environement de contruction des RPM.
Ansible sera soit installé globalement, soit installé dans un environement virtuel. dans ce cas, `virtualenv-wrapper` doit être installé et l'environement virtuel doit avoir le nom `ansible`.

## Lancement VM dev
- `cd /dev`
- `cp provisioning/custom.yaml.tmpl provisioning/custom.yaml`
- édition de `provisioning/custom.yaml`
- `vagrant up` (nécessite une connexion internet)
- url : http://vhost/corpus
- accès sesame workbench : http://vhost:8080/openrdf-workbench
- chargement des données dans `corpus` et `corpus_raw`

## Lancement VM de build
- Activation Ansible
- `cd /build`
- `vagrant up`

## Initialisation env de dev
- `cd /server/bo_client`
- `npm install`
- `./node_modules/.bin/bower install`
- `cd /server/src`
- télécharger composer.phar (https://getcomposer.org/) et le mettre dans le répertoire server/src
- `php composer.phar install`
- `npm install`
- `./node_modules/.bin/bowerbower install`

## Commandes bo_client
- `ember serve`
- `ember build` -> résultat dans `server/bo_client/dist`


## Commandes serveur php
- Compilation css/js : `gulp` -> cette commande lance `ember build` de `/server/bo_client`
- `php artisan serve`

## Creation de version
- mettre à jour le numéro de version. Pour cela lancer le script `build/set-version.sh "x.y.z"`, avec "x.y.z" le numéro de version
- Dans le répertoire `build`, lancer la commande `./build.sh -p && ./build_puppet.sh`


### Création du RPM contenant les fichiers `puppet`
- lancer le script `build/build_puppet.sh`.
- le fichier rpm se trouvera dans `/build/dist` sous le nom `puppet-corpusdelaparole-<version>-<iteration>.rpm`

### Création du RPM de l'application
- lancer le script `build/build.sh`. options:
    - `-d`: build debug
    - `-p`: build de production
- le fichier rpm se trouvera dans `/build/dist` sous le nom `corpusdelaparole-<version>-<iteration>.rpm`

### Étapes du processus de build
- mettre à jour le fichier version `server/src/config/config/version.php`
- mettre à jour le fichier version `cms/app-client/package.json`
- `cd /server/src`
- s'assurer que les sources sont à jour: `php composer.phar install` + `npm install` + `bower install`
- `gulp copy-build`
- `cd /cms/app-client`
- `npm install`
- `bower install`
- `ember build --prod` ou `ember build`
- `cd /cms`
- `npm install` pour installer gulp + dépendances
- `gulp copy-build`
- `cd /build`
- `vagrant ssh -c "/vagrant/build_rpm.sh"`
- le fichier rpm se trouvera dans `/build/dist`


## installation rpm sur serveur
- 1ère installation: `rpm -i /path/to/corpusdelaparole-<version>-<iteration>.rpm`
- Mise à jour: `rpm -U /path/to/corpusdelaparole-<version>-<iteration>.rpm`
- ensuite : création du fichier `/etc/www/corpus_env.conf`
- après un update : drush cc all