IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)

Déploiement d'une application Rails avec Capistrano

Capistrano est un outil de déploiement d'application web qui permet d'automatiser la mise en production d'une nouvelle version.
Nous allons voir ici un exemple d'utilisation de cet outil.

Article lu   fois.

L'auteur

Profil ProSite personnel

Liens sociaux

Viadeo Twitter Facebook Share on Google+   

I. Introduction et prérequis

L'exemple ci-dessous est adapté à mon hébergement chez Dreamhost, à vous de le modifier selon vos besoins.

Capistrano est un outil de déploiement d'application web qui permet d'automatiser la mise en production d'une nouvelle version.
Les possibilités sont énormes, voir le site officiel pour tous les détails, dans cet article je vous vais vous décrire un exemple d'utilisation de Capistrano pour déployer chez votre hébergeur votre application Rails développée en local sur le serveur WEBrick (serveur de développement inclus dans rails).

Il y a un prérequis, vous devez versionner votre projet avec Subversion, car le déploiement va se faire du serveur Subversion vers le serveur web, l'hébergeur Dreamhost inclus Subversion dans son offre de base, mais vous pouvez très bien héberger vous même le serveur Subversion sur votre propre machine.

Dans un premier temps, vous devez versionner correctement votre projet, car se sont les fichiers qui se trouvent dans votre « subversion repository » qui seront envoyés sur votre serveur web.

II. Versionnement du projet

Import initial du projet sur le serveur Subversion :

 
Sélectionnez
svn import monprojet/ http://svn.mondomaine.com/monprojet -m
    "Import initial"


Checkout du projet pour créer votre copie de travail en local :

 
Sélectionnez
svn checkout http://svn.mondomaine.com/monprojet monprojet


On se place à la racine de l'application :

 
Sélectionnez
cd monprojet


On supprime les fichiers de log dans Subversion pour ne pas les déployer sur le serveur de production et on les ignore :

 
Sélectionnez
svn remove log/*
svn commit -m 'suppression des fichiers de log de subversion'
svn propset svn:ignore "*.log" log/
svn update log/
svn commit -m 'on ignore les fichiers du répertoire /log/ qui se terminent par .log'


On ignore le contenu du répertoire /tmp/ :

 
Sélectionnez
svn remove tmp/*
svn propset svn:ignore "*" tmp/
svn update tmp/
svn commit -m "ignore contenu de tmp/ "


Pour les fichiers qui doivent être différents en local et sur le serveur, par exemple le fichier de configuration de la librairie auth_generator, je versionne une version de production et une version de développement (auth_generator.yml.prd et auth_generator.yml.dev) nous verrons pourquoi dans la configuration de Capistrano.

Je fais également la même chose avec le .htaccess du répertoire /public (la ligne -> « RewriteRule ^(.*)$ dispatch.fcgi [QSA,L] » sur le serveur diffère de la version de développement « RewriteRule ^(.*)$ dispatch.cgi [QSA,L] » ) :

 
Sélectionnez
svn remove auth_generator.yml
svn propset svn:ignore auth_generator.yml
svn commit -m "ignore auth_generator.yml"
svn remove .htaccess
svn propset svn:ignore .htaccess
svn commit -m "ignore .htaccess"

III. Capistrano

Installation de Capistrano :

 
Sélectionnez
gem install capistrano

Attention ! Sous Linux, il faut être root pour pouvoir lancer cette commande.


Création des fichiers Capistrano :

 
Sélectionnez
cap -A


Modification du fichier config/deploy.rb (voir mon exemple).
Création de la structure de répertoire sur votre hébergement :

 
Sélectionnez
rake remote:exec ACTION=setup


Nous allons également modifier les lignes suivantes dans le fichier config/deploy.rb :

 
Sélectionnez
task :restart, :roles => :app do
    run "ruby #{current_path}/script/process/reaper -dispatcher=dispatch.fcgi"
end

En :

 
Sélectionnez
task :restart, :roles => :app do
    run "ruby #{current_path}/script/process/reaper -a graceful -dispatcher=dispatch.fcgi"
end


Encore une petite précision, de temps en temps j'exécute la commande « rake remote:cleanup » ce qui a pour effet de supprimer toutes les anciennes versions des déploiements précédents en ne conservant que les cinq plus récentes.

IV. Déploiement de l'application

 
Sélectionnez
rake deploy


C'est tout, si il n'y a pas d'erreur dans le fichier deploy.rb la nouvelle version de votre application est en ligne, ça peut paraître un peu fastidieux en début de projet, mais tellement simple par la suite que l'on ne peut plus s'en passer.

Si vous faites une erreur lors d'une nouvelle version, il existe la commande « rake rollback » qui vous permettra de revenir à la version précédente.

V. Conclusion

Cet article est un exemple rapide d'utilisation, je vous conseille de vous documenter davantage sur le site officiel pour bien comprendre le fonctionnement.

Si vous avez des questions, n'hésitez pas à aller les poser directement à l'auteur sur son blog.

Vous avez aimé ce tutoriel ? Alors partagez-le en cliquant sur les boutons suivants : Viadeo Twitter Facebook Share on Google+   

Les sources présentées sur cette page sont libres de droits et vous pouvez les utiliser à votre convenance. Par contre, la page de présentation constitue une œuvre intellectuelle protégée par les droits d'auteur. Copyright © 2006 Frédéric Bollon. Aucune reproduction, même partielle, ne peut être faite de ce site ni de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.