Nouveau poste de dev

= Activation de la virtualisation CPU dans le bios = Une étape qui ne peut pas être montrée pour des raisons que tous les BIOS sont différents. Il faut que vous vous assureriez que la virtualisation est bien activée dans le BIOS de votre ordinateur, par défaut, cela se trouve dans un menu CPU, et doit se nommer quelques choses virtualization. Si vous ne trouvez pas comment faire, n’hésitez pas à demander à la DSI.

= Logiciel à installer = “‘Avant de commencer, vous devez installer les logiciels suivants, en suivant bien cet ordre d’installation pré-définie par cette liste.”’

(Si l’un des liens n’est plus valide, faites une recherche Google, et mettez à jour le lien dans la fiche wiki, merci :) )

1 - Dernière version de PHPStorm -> https://www.jetbrains.com/phpstorm/

2 - La dernière version de VirtualBox -> https://www.virtualbox.org/wiki/Downloads

3 - La dernière version de Vagrant -> https://www.vagrantup.com/downloads.html

Après l’installation redémarrez votre ordinateur.

Si vous n’avez pas utilisé votre poste depuis un moment, et que vous rencontrez des problèmes pour remonter une dev, merci de mettre à jour les trois logiciels ci-dessus.

= Installation de GIT = {| class=“wikitable” style=“text-align:center; width:100%;” |+ |- |- ! scope=row | Aller sur l’url :http://git-scm.com/download/win et télécharger GIT.

Puis lancer l’installation de GIT sur windows. |- ! scope=row | Continuer l’installation en vous basant sur les screens suivants : |[[Fichier:installGITPart1-2.jpg]] |- ! scope=row | Continuer l’installation en vous basant sur les screens suivants : |[[Fichier:installGITPart1-3.jpg]] |- ! scope=row | Continuer l’installation en vous basant sur les screens suivants (ne rien changer) : |[[Fichier:2016-09-28_10h49_30.png]] |- ! scope=row | Continuer l’installation en vous basant sur les screens suivants : |[[Fichier:installGITPart1-5.jpg]] |- ! scope=row | Continuer l’installation en vous basant sur les screens suivants

(Cocher : Run git from the windows command prompt): |[[Fichier:installGITPart1-6.jpg]] |- ! scope=row | Continuer l’installation en vous basant sur les screens suivants : |[[Fichier:2016-09-28_10h50_35.png]] |- ! scope=row | Continuer l’installation en vous basant sur les screens suivants

(Cocher : Checkout as-is, commit Unix-style line endings) : |[[Fichier:installGITPart1-7.jpg]] |- ! scope=row | Continuer l’installation en vous basant sur les screens suivants : |[[Fichier:2016-09-28_10h51_59.png]] |- ! scope=row | Continuer l’installation en vous basant sur les screens suivants : |[[Fichier:2016-09-28_10h53_05.png]] |- ! scope=row | Continuer l’installation en vous basant sur les screens suivants : |[[Fichier:installGITPart1-8.jpg]] |- ! scope=row | Continuer l’installation en vous basant sur les screens suivants : |[[Fichier:installGITPart1-9.jpg]] |- ! scope=row | Si l’application ne se lance pas, ouvrir Phpstorm.

Cliquer sur Configure. |[[Fichier:conf1.png|600px]] |- ! scope=row | Puis cliquer sur Settings. |[[Fichier:conf2.png|600px]] |- ! scope=row | Puis dans version Control -> Git.
Vérifier que le Path to git Executable est le bon (normalement le même que sur le screen) en cliquant sur Test.

Si ce n’est pas le cas, aller dans le répertoire d’installation de git (choisi lors de l’installation de git) et retrouver le git.exe (normalement dans Git/bin/) pour mettre le bon chemin dans le champ texte de phpstorm.

Puis Apply. |[[Fichier:2016-09-28_10h55_34.png|600px]]
|- ! scope=row | Démarrer ou redémarrer phpStorm afin que les modifications soient prises en compte.

Cliquer sur Check out from Version control > Git. |[[Fichier:InstallGITPart3-1-5.JPG]] |- ! scope=row | Puis paramétrer la fenêtre suivante en fonction du projet que vous souhaitez récupérer (voir les chapitres suivants) :

Attention, si votre machine est sous Windows, le nom de votre dossier doit être le plus court possible afin d’éviter des problèmes de nombre de caractères dans les fichiers (exemple : a).
Puis cliquez sur Clone. |[[Fichier:InstallGITPart3-1-6.JPG]] |- ! scope=row | Sur la fenêtre suivante “Confirm SSh Server Key”, cliquer sur Yes. |[[Fichier:InstallGITPart4-3.png|600px]] |}

= Se créer un compte sur git.moovapps.com =

Vous devez aller sur le site web : https://git.moovapps.com/ et vous créez un compte et le valider avec votre adresse mail. Lorsque ceci sera ok, vous devez prévenir Mathias POUËSSEL, Saber HAMROUNI ou Jérémy ADOUX pour qu’ils vous donnent les accès au git sur ce serveur.

Une fois cela réalisé, vous aurez accès à tous les projets, et vous allez pouvoir vous servir des informations liées aux différents repository pour récupérer les sources.

= Installation du plugin hostmanager de vagrant =

Ouvrez un invite de commande windows et tapez la commande suivante : 

vagrant plugin install vagrant-hostmanager

Si vous avez un bug tapez ces commandes : 

vagrant plugin install ffi
vagrant plugin uninstall ffi && vagrant plugin install ffi –plugin-version 1.9.8

= Récupérer la clé ssh pour les produit moovapps =

Téléchargez puttygen.exe à cette adresse : http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html puis exécuter le.

Cliquez sur “Generate”, bougez la souris sur la zone blanche pendant la génération (cette action est utilisé par l’outil pour générer de l’aléatoire)

Gardez la fenêtre ouverte

Connectez vous (ou créez un compte) à votre compte git sur https://git.moovapps.com/

Aller dans “profile settings” puis dans “SSH key”

Cliquez sur “add SSH key”

Renseignez le titre comme vous voulez (exemple “poste dev”)

Copiez collez la key obtenu dans puttygen

Validez en cliquant sur “Add Key”

Ouvrez une fenêtre de commande windows

tapez “mkdir .ssh” (cela créer un dossier .ssh dans votre dossier d’utilisateur)

Dans puttygen, cliquez sur Conversions/Export OpenSSH key

Cliquez sur “oui” au warning

Sélectionner le dossier .ssh créer à l’étape précédente

Entrez pour nom “id_rsa” puis enregistrez

Cliquez sur “Save public key”

Entrez pour nom “id_rsa.pub” puis enregistrez

Cliquez sur “Save private key”

Entrez pour nom “id_rsa.ppk” puis enregistrez

= Démarrage de PHPStorm =

Lancez PHPStorm en administrateur (“‘vous pouvez configurer le racourcis pour toujours le lancer en admin”’)

Choisissez “Checkout from version control” -> “Git”

Dans la fenêtre, mettez dans le git repository Url “’ en ssh”‘, l’url du git pour le core produit voir : https://git.moovapps.com/developer-sobizzz/core-sobizzz

”’ /!\ Attention : Votre projet doit se trouver à la racine, exemple : C:\projets\ . Il ne faut pas laisser le chemin avec le workspace PHPStorm, car le chemins vers les fichiers sera trop long, et le checkout ne marchera pas. “’

Puis continuer.

= Récupérer une Conf Spe =

Ensuite, vous devez récupérer une conf spe, voir avec votre scrum master pour savoir quel conf spe récupérer, il doit vous fournir l’information.

Soit vous avez déjà PHPStorm d’ouvert sur le coeur produit, dans ce cas, depuis la toolbars, faites : VCS -> Checkout From Version Control -> Git et remplissez correctement la fenêtre qui va s’ouvrir en vous servant des informations de votre chef de projet et en récupérant le ssh de la conf spé voulue sur https://git.moovapps.com/

Soit vous avez phpstorm avec sa fenêtre de démarrage dans ce cas faites : “Checkout from version control” -> “Git” et remplissez la fenêtre avec les informations de votre Chef de projet et en récupérant le ssh de la conf spé voulue sur https://git.moovapps.com/

= Configurer PHPStorm =

”‘Selon”’ la conf spe que vous avez récupéré, vous pouvez avoir un répertoire : “Installer” et ce répertoire doit contenir un fichier .jar et un à plusieurs fichier .xml.

Ce jar vous permet de récupérer les informations pour uploader les fichiers sur votre docker. S’il n’est pas présent, pas de panique, la configuration est expliquée plus bas.

Depuis votre interface phpstorm, choisissez dans la toolbars : Files -> Import Settings… Une fenêtre s’ouvre vous invitant à choisir un fichier. Aller dans le répertoire workspace de votre conf_spe, puis Installer, puis choisissez le fichier .jar

Conservez toutes les case cocher, et faites ok autant de fois que cela est demandé. Phpstorm devrait redémarrer.

= Configuration du projet = {| class=“wikitable” style=“text-align:center; width:100%;” |+ |- |- ! scope=row | File => Settings (ou Ctrl + Alt + S) |[[Fichier:PhpStorm-image22.jpg]] |- ! scope=row | Aller dans Code Style > PHP
Tab Size : 2
Indent : 2
Continuation indent : 2

Cliquer sur Apply |[[Fichier:PhpStorm-image23.jpg |600px]] |- ! scope=row | Aller dans File Types > PHP files |[[Fichier:PhpStorm-image24.jpg |600px]] |- ! scope=row | Cliquer sur le + et rajouter *.module.
Répéter la manipulation pour ajouter : *.view et *.install

Cliquer sur Apply |[[Fichier:PhpStorm-image25.jpg |600px]] |- ! scope=row | Si votre conf spé ne contenait pas de .jar : recopiez les informations ci-contre pour pouvoir uploader vos sources sur votre docker. mot de passe vagrant. |[[Fichier:2016-09-28_10h06_11.png]] |- ! scope=row | Choisissez l’instance sur laquelle vous devez travailler, et remplissez la case Deployement path tel que définit dans le screen. Puis cliquez sur USe this server as default. |[[Fichier:Etape1postedev.png]] |- ! scope=row | Remplissez la zone tel que définit dans le screenshot. |[[Fichier:Etape2postedev.png]] |}

= Utilisation de Vagrant = Commencez par regarder si le plugin vagrant est déjà présent dans votre PHPStorm ou non. Faites Tools et vérifier que vous avez le menu “Vagrant” tout à la fin. Si c’est le cas, pas besoin de l’installer.
Récupérer le plugin Vagrant de PHPStorm. Pour se faire depuis la toolbars PHPStorm, faites Files -> Settings. Dans la fenêtre qui s’est ouverte, choisissez “Plugins” puis “Install jetBrains Plugins”. Dans le formulaire de recherche, tapez “Vagrant” et installer le plugin Vagrant.

PHPstorm va redémarrer.

Vous devez avoir dans la Toolbars : Tools -> Vagrant.

Voici le descriptif des commandes que vous pouvez utiliser (celle qui ne sont pas décrites, ne sont pas à utiliser).
Vagrant up : S’occupe de lancer votre machine virtuelle
Vagrant halt : S’occupe de stopper votre machine virtuelle
Vagrant provision : S’occupe de mettre à jour votre machine virtuelle
Vagrant destroy : Efface la machine virtuelle de votre disque dur

= Une fois l’installation terminée = Contacter, Mathias POUËSSEL, Saber HAMROUNI ou Jérémy ADOUX, qui s’occuperont de vérifier l’installation et de finaliser quelques petites choses.

= Docker Integration (facultatif)= PhpStorm 10 permet de gérer ses conteneurs Docker depuis l’IDE.

== Conf sur la dev ==

Sur votre dev, editez le fichier /etc/init/docker.conf, rechercher “DOCKER_OPTS” et modifier la ligne ainsi : 

DOCKER_OPTS=‘-H tcp://0.0.0.0:4243 -H unix:///var/run/docker.sock’
Cette action permet d’accéder à l’API restfull de Docker via un port TCP. redémarez Docker 
service docker restart
Ce redémarrage coupe tous vos conteurs. Redémarrez les avec 
/etc/init.d/docker_restart restart

== Conf PhpStorm == Version complète ici : http://blog.jetbrains.com/phpstorm/2015/10/docker-support-in-phpstorm/

Activez le module Docker Integration dans Settings > Plugins. Un redémarrage de PhpStorm peut être nécessaire.

RDV dans Settings > Build,Execution,Deployement > Clouds. Ajouter un nouveau (+)

Dans API url, entrez http://ip_de_votre_vm:4243 (une bonne méthode peut être de bind 4243 sur localhost avec Vagrant)

Vous pouvez accéder à Docker depuis l’onglet “Application Serverr”, par défaut, dans la barre d’état en bas de PhpStorm

Pour paramétrer le débugger XDebug : https://mediawiki.sobizzz.com/index.php/Utilisation_de_debuguer_-_Xdebug

== Utilisation == Pour tous les détails, consultez le blog de Jetbrains sur ce sujet : http://blog.jetbrains.com/phpstorm/2015/10/docker-support-in-phpstorm/