Jenkins et symfony2
L’intégration continue est une des bonnes bases à mettre en place au début d’un projet.
(Ce post me sert principalement de mémo, n’hésitez pas à commenter ou me contacter si besoin)
(Note : j’ai installé les outils en phar dans le répertoire de jenkins, il serait bien de voir si il y a moyen de tous les gérer avec composer)
Je choisis Jenkins que je vais installer sur mon serveur de dev, de cette manière, lorsque je ferais un push sur github, Jenkins lancera un build, puis déploiera mon application en préproduction.
Le développement et l’avancement du projet seront complètement transparents, ce qui est une bonne chose, pour (la future) équipe, et les associés.
Pour l’installation basique sous debian :
Pour la suite, il faut bien penser à installer git et curl :
[pastacode lang= »bash » message= » » highlight= » » provider= »manual »]
apt-get install curl git
[/pastacode]
Sécurité Globale, pour définir un mode d’authentification :
Je choisis de gérer les users Jenkins à part, il y en aura peu au début.
Ensuite, je choisis de donner le contrôle de Jenkins aux users, c’est surtout pour protéger le serveur des accès extérieurs non autorisés.
Après avoir valider je vais créer mon user :
Dans la « Gestion des utilisateurs » -> « Créer un utilisateur »
Une fois inscrit, je préfère supprimer la possibilité de s’inscrire, retour dans le sécurité globale, pour décocher la case «
Prochaine étape installer et configurer les plugins nécessaires et les configurer.
Pour faire mon setup j’ai utilisé les infos de plusieurs sources :
- http://les-tilleuls.coop/chaine-dintegration-continue-pour-les-applications-symfony/
- Le wiki de Jenkins
- http://fr.slideshare.net/hhamon/intgration-continue-des-projets-php-avec-jenkins
Pour avoir un mot de passe pour l’utilisateur Jenkins et pouvoir faire certaines manips :
http://stackoverflow.com/questions/6234016/jenkins-user-on-apt-get-install-installation
Sous debian 8, je suis logué en root, j’ai donc fait :
[pastacode lang= »bash » message= » » highlight= » » provider= »manual »]
passwd jenkins
[/pastacode]
Maintenant que je peux faire un su jenkins, et me loguer.
J’ai choisis d’utiliser Github pour mon projet,
j’ai configuré jenkins pour lancer un build quand je push.
Reste à faire :
- code check, duplicator, php mess detector
- configurer mage.php pour déployer ma preprod à la fin si le build est ok
Pour cela il y a ce tuto : http://blog.lazycloud.net/utiliser-jenkins-pour-un-projet-symfony2/
Cependant je vais installer les outils en .phar dans le répertoire de jenkins (puisque j’ai commencé comme ça) :
Pdepend : (site officiel)
[pastacode lang= »bash » message= » » highlight= » » provider= »manual »]
wget http://static.pdepend.org/php/latest/pdepend.phar
chmod +x pdepend.phar
[/pastacode]
Dans Jenkins : « Administrer jenkins » -> « gestion des plugins » -> onglet « Disponibles » -> Jdepend
J’ajoute dans le script shell du build :
[pastacode lang= »bash » message= » » highlight= » » provider= »manual »]
#pdepend - Calculate software metrics using PHP_Depend
php ~/pdepend.phar --jdepend-xml=build/logs/jdepend.xml --jdepend-chart=build/pdepend/dependencies.svg --overview-pyramid=build/pdepend/overview-pyramid.svg ./src || status=$((status+$?))
[/pastacode]
(Voir le lien vers le tuto les-tilleuls.coop plus faut pour le script shell)
Ensuite, il faut configurer après le build :
Php mess detector : (site officiel download)
[pastacode lang= »bash » message= » » highlight= » » provider= »manual »]
wget -c http://static.phpmd.org/php/latest/phpmd.phar
chmod +x phpmd.phar
[/pastacode]
- ajouter une ligne au script shell
- ajouter une action après le build pour montrer le résultat
[pastacode lang= »bash » message= » » highlight= » » provider= »manual »]
php ~/phpmd.phar ./src xml --reportfile build/pmd/phpmd.xml cleancode, codesize, design, naming, unusedcode || status=$((status+$?))
[/pastacode]
Php Code sniffer : (le github)
[pastacode lang= »bash » message= » » highlight= » » provider= »manual »]
curl -OL https://squizlabs.github.io/PHP_CodeSniffer/phpcs.phar
php phpcs.phar -h
curl -OL https://squizlabs.github.io/PHP_CodeSniffer/phpcbf.phar
php phpcbf.phar -h
chmod +x phpcs.phar phpcbf.phar
#installation des standards symfony
#je le met dans le répertoire de jenkins
mkdir -p CodeSniffer/Standards
#J'ai utilisé ce repo, n'hésitez pas à commenter si vous en avez d'autres, mieux...
git clone git://github.com/escapestudios/Symfony2-coding-standard.git Symfony2
#config phpcs pour l'ajout du standard symfony
./phpcs.phar --config-set installed_paths CodeSniffer/Standards
[/pastacode]
Dans le script shell :
[pastacode lang= »bash » message= » » highlight= » » provider= »manual »]
#phpcs-ci Find coding standard violations using PHP_CodeSniffer creating a log file for the continuous integration server
php ~/phpcs.phar --report=checkstyle --report-file=build/logs/checkstyle.xml --standard=Symfony2 ./src || status=$((status+$?))
[/pastacode]
Ensuite dans les plugins jenkins, il faut ajouter : « Checkstyle plugin »
Pour finir la config de l’affichage avec le plugin après le build:
(un tuto spécifique a code sniffer : http://www.theodo.fr/blog/2014/06/easily-comply-with-symfony2-coding-style-using-codesniffer-and-phpstorm-code-inspection/ )
Pour le déploiement automatique de la preprod, juste un cp ou un rsync à la fin du script shell peut faire l’affaire, il faut penser à ajouter l’utilisateur « jenkins » au groupe « www-data » pour pouvoir écrire dans le répertoire web. Un symlink ou bien un vhost configuré sur le répertoire workspace de Jenkins aurait fonctionné, mais Jenkins utilise l’env de test le symfony2 pour lancer les tests unitaires, et je préfère que ma preprod soit indépendante le Jenkins.
De plus, à termes, je prévois d’utiliser un outil comme Magallanes (pour l’instant il ne gère pas le deploy local)