Déployer votre projet Symfony en production via rsync

Tim — Wed, 01 Apr 2009 10:08:53 +0000

Vous venez de boucler votre projet symfony en local et êtes impatients de le tester sur votre hébergement réel. Personnellement cette opération ne m’enchante jamais car les lettres FTP sonnent comme une évidence, or jamais un client FTP ne m’aura convaincu surtout quand un jour on a pu goûter au rsync.

Ce petit logiciel libre permet en effet d’exporter très efficacement (rien à avoir avec le FTP) une arborescence vers une destination locale ou distante (utilise le ssh dans ce cas là) mais surtout ne copie que les éléments qui auront été modifiés (!). Évidemment, une fois votre première version en prod, vous aurez des modifications à faire, et il est toujours délicat de se rappeler les fichiers que l’on a modifiés. Cette problématique disparait avec rsync!

Et comme à son habitude, Symfony fait bien les choses car il intègre par défaut une option de déploiement basé sur cette technologie. Pour l’utiliser, il suffit de disposer de rsync sur les serveurs source et final. En général il suffit d’un:

apt-get install rsync

Ensuite, éditez votre fichier config/properties.ini comme ceci, en remplaçant les paramètres selon vos informations:

[preprod]
  host=192.168.10.202                   #ip du serveur de destination
  port=22                               #port utilisé pour la connexion ssh, 22 est le port par défaut
  user=root                             #utilisateur qui se connectera au serveur de destination
  dir=/var/www/vhosts/monsite/httpdocs  #dossier qui recevera le projet symfony sur le serveur de destination
  type=rsync                            #le type de deploiement
  pass=                                 #indique qu'il y a un mot de passe (il faudra le taper lors de la connexion)

Un autre fichier config/rsync_exclude.txt permet d’exclure certains fichiers ou groupe de fichiers

.svn
/web/uploads/*
/cache/*
/log/*
/web/*_dev.php
.DS_Store
.cache
.project
.settings
/web/*Plugin

Personnellement, une fois le projet déployé une fois, j’y ajoute également config/ProjectConfiguration.class.php contenant le lien vers votre installation de symfony, qui diffère parfois entre dev et prod.
Concernant la règle /web/*Plugin qui regroupe les dossiers web des plugins, le problème vient des liens symboliques qui doivent être changés si le chemin de l’installation de symfony n’est pas identique en dev et en prod. Je les exclus donc du rsync et les republie après le rsync sur le serveur de prod via la ligne:

php symfony plugin:publish-assets

Voilà, c’est fini, il suffit maintenant de lancer la commande suivante à la racine de votre projet:

php symfony project:deploy preprod

preprod étant le nom que vous lui aurez donné le fichier ini. Cette commande ne fait qu’une simulation du transfert, pas d’inquiétude. Si tout se passe bien, vous pouvez lancer la commande finale:

php symfony project:deploy preprod --go

Et vous assistez alors à la copie quasi instantanée de votre projet.

Amicalement Web - Astuces et Bons plans dans le développement web » rsync

Déployer votre projet Symfony en production via rsync