Comment Installer mod_ruby Sur Diverses Distributions Linux Pour Utiliser Avec ISPConfig (2.2.20 Et Supérieur)

Version 1.0
Auteur : Falko Timme

À partir de la version 2.2.20, ISPConfig a un support intégré pour Ruby. Au lieu d’utiliser CGI/FastCGI, ISPConfig dépend de la disponibilité de mod_ruby dans l’Apache du serveur. Cet article explique comment installer mod_ruby sur diverses distributions prises en charge par ISPConfig.

Je ne garantis pas que cela fonctionnera pour vous !

1 Debian Etch / Ubuntu 7.10

Sur Debian Etch et Ubuntu 7.10, tout ce que nous avons à faire est d’exécuter (en tant que root) :

apt-get install libapache2-mod-ruby

Aucune configuration n’est nécessaire.

2 Fedora 8 / CentOS 5.1

Pour Fedora 8 et CentOS 5.1, il n’y a pas de package mod_ruby disponible, donc nous devons le compiler nous-mêmes. D’abord, nous installons quelques prérequis :

yum install httpd-devel ruby ruby-devel

Ensuite, nous téléchargeons et installons mod_ruby comme suit :

cd /tmp  
wget http://www.modruby.net/archive/mod_ruby-1.2.6.tar.gz  
tar zxvf mod_ruby-1.2.6.tar.gz  
cd mod_ruby-1.2.6/  
./configure.rb --with-apr-includes=/usr/include/apr-1  
make  
make install

Enfin, nous devons ajouter le module mod_ruby à la configuration d’Apache, donc nous créons le fichier /etc/httpd/conf.d/ruby.conf…

vi /etc/httpd/conf.d/ruby.conf

| LoadModule ruby_module modules/mod_ruby.so |

… et redémarrer Apache :

/etc/init.d/httpd restart

3 Mandriva 2008.0

Mandriva 2008.0 a un package mod_ruby que nous pouvons installer comme suit :

urpmi apache-mod_ruby

Ce package vient avec une configuration mod_ruby qui active mod_ruby globalement pour tous les sites web. Par conséquent, nous devons le désactiver maintenant afin qu’il puisse être activé dans ISPConfig sur une base par site web :

vi /etc/httpd/modules.d/20_mod_ruby.conf

Commentez ou supprimez tout dans ce fichier sauf les lignes suivantes :

| LoadModule ruby_module extramodules/mod_ruby.so |

Ensuite, redémarrez Apache :

/etc/init.d/httpd restart

4 OpenSUSE 10.3

OpenSUSE 10.3 n’a pas de package mod_ruby, donc nous devons le compiler manuellement. D’abord, nous installons les prérequis :

yast -i apache2-devel ruby ruby-devel

Ensuite, nous construisons mod_ruby comme suit :

cd /tmp  
wget http://www.modruby.net/archive/mod_ruby-1.2.6.tar.gz  
tar zxvf mod_ruby-1.2.6.tar.gz  
cd mod_ruby-1.2.6/  
./configure.rb --with-apr-includes=/usr/include/apr-1  
make  
make install

Pour activer mod_ruby, nous ouvrons /etc/sysconfig/apache2 et ajoutons ruby à la ligne APACHE_MODULES, par exemple comme ceci :

vi /etc/sysconfig/apache2

| [...] APACHE_MODULES="actions alias auth_basic authn_file authz_host authz_groupfile authz_default authz_user authn_dbm autoindex cgi dir env expires include log_config mime negotiation setenvif ssl suexec userdir php5 rewrite ruby" [...] |

Ensuite, nous exécutons

SuSEconfig

et redémarrons Apache :

/etc/init.d/apache2 restart

5 Utilisation de mod_ruby

Maintenant, supposons que vous ayez créé un site web dans ISPConfig avec le document root /var/www/web1/web. Si vous activez Ruby pour ce site web, ISPConfig ajoute quelque chose comme ceci à la configuration vhost Apache du site web :

| Options +ExecCGI RubyRequire apache/ruby-run #RubySafeLevel 0 SetHandler ruby-object RubyHandler Apache::RubyRun.instance SetHandler ruby-object RubyHandler Apache::RubyRun.instance |

(Si vous n’utilisez pas ISPConfig, alors bien sûr, vous pouvez ajouter cela manuellement à votre configuration vhost, mais n’oubliez pas d’ajuster les chemins et de redémarrer Apache par la suite.)

Pour voir si mod_ruby fonctionne, nous créons le fichier Ruby /var/www/web1/web/hello_world.rb :

vi /var/www/web1/web/hello_world.rb

| # La classe Greeter class Greeter def initialize(name) @name = name.capitalize end def salute puts "Hello #{@name}!" end end # Créer un nouvel objet g = Greeter.new("world") # Afficher "Hello World!" g.salute |

Le fichier doit être exécutable, donc nous exécutons :

chmod 755 /var/www/web1/web/hello_world.rb

Maintenant, vous pouvez appeler le fichier dans un navigateur ; si tout se passe bien, il devrait afficher un message Hello World !.

Comment Installer mod_ruby Sur Diverses Distributions Linux Pour Utiliser Avec ISPConfig (2.2.20 Et Supérieur)