envdev/README

INSTALLATION INFRASTRUCTURE DE DEVELOPEMENT
===========================================

Si vous êtes ici, c'est que vous avez installé Eclipse, importé le projet "envdev" depuis Git

Objectif
--------

Le but est d'avoir un environnement reflétant un serveur de production. Cette 
infrastructure doit fonctionner sur tout système d'exploitation (Windows, Ubuntu, Mac OS X)
Nous utiliserons des machines virtuels (VirtualBox) controlées par Vagrant.
La machine virtuelle devra partager ces fichiers avec la machine host.


Outils
------

NotePad++  : http://www.notepad-plus-plus.org
VirtualBox : http://www.virtualbox.org
Vagrant    : http://www.vagrantup.com
PuTTy      : http://www.putty.org
Eclipse    : http://eclipse.org


Conventions pour l'infrastructure de dev
----------------------------------------
Espace de dev 		: *.sd.dev
Espace de recette 	: *.sd.lan

Base de données des applications MariaDB (App DB)
 - Accès : pma.sd.lan
 - Admin User/Password : admin/scores
 - IP   : (voir dans phpmyadmin)
 - Port : 3307

Base de données Métier MariaDB (BigData)
 - Accès : pma.sd.lan
 - Admin User/Password : admin/scores
 - IP   : (voir dans phpmyadmin)
 - Port : 3306
 
Moteur de recherche Sphinx : 192.168.78.249:9306,9312

Espace de travail : workspace

Windows : C:\Users\<user>\workspace
Ubuntu 	: /home/<user>/workspace
MacOS 	: ...


Installation serveur de dev
---------------------------

Installer virtualbox et vagrant

- Ubuntu 16.04 (au 24/06/2016) installer le .deb depuis le site officiel plutot que depuis apt


Utilisation de vagrant et virtualbox
------------------------------------

Le repertoire "envdev" de votre workspace contient les machines virtuelles et leur configuration,
chacune dans un répertoire

 - lamp-precise64 		: Ubuntu 12.04, php, apache (mod_php) 
 - lamp-trusty64 		: Ubunut 14.04, php, apache (mod_php)
 - lamp-trusty64-fpm 	: Ubuntu 14.04, php-fpm, apache (mod_proxy_fcgi)
 - lamp-xenial64-fpm 	: Ubuntu 16.04 - travail en cours 

La machine lamp-trusty64-fpm est la version actuelle à utiliser

. Windows

	Executer cmd.exe
	cd C:\Users\<your user>\workspace\envdev\<def name>
	vagrant up
	La machine se créer, s'installe et se configure.
 

. Ubuntu

	cd workspace/envdev/<def name>
	vagrant up


. Installer les additions 
	
	vagrant plugin install vagrant-vbguest
	vagrant halt
	vagrant up

	Vous avez maintenant un serveur opérationel accessible sur l'IP 192.168.33.10
	
	Sur windows, utilisez PuTTY pour se connecter à la machine (User: vagrant, Password: vagrant)
	Sur ubuntu, vagrant ssh
	

. Utilisation avec les projets

	Dans le repertoire <workspace>/<def name>/vhosts, il est possible d'ajouter ces propres vhosts 
	pour chaque projet.
	
	"vagrant provision" met à jour les vhosts et redémarre apache

	Pour voir la configuration de apache, php voir dans le fichier boostrap.sh ou directement 
	dans la machine.

	Pour mettre à jour les logiciels dans la machine virtuelle, lacer un fichier "action.upgrade" 
	à la racine de la machine puis "vagrant provision" pour effectuer les actions.
	Et supprimer le fichier.

	DNS
	Windows : Modifier le fichier, en mode administrateur, C:\Windows\System32\drivers\etc\hosts	
	Ubuntu : Modifier le fichier /etc/hosts
	
	Définir les domaines suivants (automatiquement créée lors de la première install)
	192.168.33.10	test.sd.dev
	192.168.33.10	phpmyadmin.sd.dev
	
	Puis pour chaque projet web, ...


Configuration Eclipse
---------------------

Eclipse PHP

Dans Eclipse, Windows > Preferences 
PHP > Code style > Formatter > Choose PSR-2 in active profile
PHP > Editor > Save Actions > Remove trailing whitespace on "All lines"


Faire le tour des préférences

Importer les projets
--------------------
 - Importer le projet depuis Git
 - Configurer le projet (voir la doc du projet)
 - Effectuer le composer install (ajouter sa clef ssh dans la vagrant pour pouvoir récupérer le projet library)
 - Créer le vhost (voir la doc du projet)
 - Provisionner vagrant