Skip to content

Latest commit

 

History

History
117 lines (77 loc) · 4.96 KB

INSTALL-atelier-2016-05-24-phptour.md

File metadata and controls

117 lines (77 loc) · 4.96 KB
Raw

Bonjour,

Introduction

Pour l'atelier de mardi, nous aurons environ 3h devant nous. Pour en profiter au maximum, je vous propose d'effectuer une partie de l'installation avant de venir, cela nous permettra d'attaquer efficacement dès le début de la journée.

Pour réduire les différences entre les différents postes de chacun, nous travaillerons dans une machine virtuelle. Pour faciliter la mise en place de celle-ci, nous utiliserons Vagrant, avec un script de provisionning qui installera tout ce dont nous avons besoin pour commencer l'atelier.

Si vous êtes à l'aise avec l'installation et la configuration de docker et que vous avez un nginx + php-fpm fonctionnel, vous pouvez faire tourner ailleurs (sur votre machine, par exemple) les composants décrits ci-dessous. Veillez toutefois à avoir un environnement avec ces composants fonctionnels pour l'atelier ; et, en cas de besoin, à vous de savoir dépanner votre environnement ;-)

Checklist

Pour résumer les grandes lignes :

Installation de VirtualBox

La machine virtuelle avec laquelle nous travaillerons tourne sous VirtualBox. Vous devez donc télécharger et installer VirtualBox.

Attention : vous devez être sous VirtualBox 5 (la version 4 ne permet pas de faire fonctionner ce dont nous aurons besoin)

Installez aussi le Oracle VM VirtualBox Extension Pack.

Note : cette opération peut être à effectuer en root.

Installation Vagrant

Nous ne manipulerons pas cette VM à la main et utiliserons Vagrant pour automatiser. Vous devez donc télécharger et installer Vagrant.

Note : cette opération peut être à effectuer en root.

Plugin vbguest

Vous aurez également besoin du plugin vagrant-vbguest, que vous devez installer avec la commande suivante :

vagrant plugin install vagrant-vbguest

Note : cette opération peut être à effectuer en root.

Obtention des sources du projet

Le script de provisionning et les fichiers de configuration qu'il utilise sont disponibles par le biais du projet Github suivant : pmartin/php-evaluator

Vous devez donc obtenir ce projet :

  • Soit en utilisant git clone en ligne de commande
  • Soit en utilisant un outil graphique comme le client GitHub Desktop

Une fois les sources obtenues, vous devriez notamment avoir :

  • Un fichier Vagrantfile, sur lequel Vagrant se basera à l'étape suivante
  • Un répertoire vagrant-files qui contient notamment le script que Vagrant lancera pour installer la VM

Vous n'avez pas besoin de fouiller dans les sources et exemples : c'est le contenu de l'atelier, sur lequel nous nous baserons mardi ;-)

Lancer le provisionning

Une fois les sources obtenues, placez-vous, en ligne de commandes, dans le répertoire les contenant, puis lancez la commande vagrant up (à vous d'adapter le chemin dans la commande ci-dessous) :

cd c:\dev\php-evaluator
vagrant up

Ceci va créer la machine virtuelle et lancer son script d'installation, qui téléchargera et installera pas mal de choses dedans (nous en parlerons rapidement mardi). Cette opération peut durer plusieurs minutes (et encore plus si vous n'aviez pas déjà la box ubuntu/xenial64 en local, puisqu'elle sera alors automatiquement téléchargée).

Vérifier le bon fonctionnement de la machine virtuelle

Une fois le provisionning terminé, la machine virtuelle est lancée ; vérifiez que vous pouvez vous y connecter en SSH :

vagrant ssh

Depuis votre poste de développement, vous devez aussi avoir accès en HTTP à une page dans la machine : phpinfo.php

Eteindre la machine virtuelle

Il ne vous reste plus qu'à éteindre la machine virtuelle :

cd c:\dev\php-evaluator
vagrant halt

Et maintenant ?

Si vous avez des questions ou rencontrez des difficultés, n'hésitez pas à me faire signe, soit par mail, soit en DM sur @pascal_martin si vous n'avez pas mon mail.

Dans tous les cas, à mardi !