Installer JRuby et Rails

Dans ce post, je vais décrire comment installer JRuby. Ensuite je vous montrerai comment faire tourner une application Rails 3 de base avec JRuby.

Tout d'abord, vous allez devoir installer JRuby. Vous pouvez installer directement les exécutables, que vous téléchargez sur le site de JRuby.

Toutefois, si, comme moi, vous utilisez plusieurs versions de Ruby, je vous conseille fortement d'utiliser Ruby Version Manager (RVM).

Une fois que RVM est installé, une seule ligne de commande suffit pour installer JRuby:

rvm install jruby

Ensuite, pour commencer à utiliser JRuby:

rvm use jruby

Quand vous aurez fini, pour revenir à votre version de Ruby par défaut, il suffit de faire:

rvm reset

Vous pouvez vérifier la version de JRuby que vous allez utiliser:

jruby -v

A présent, installons Ruby on Rails:

jruby -S gem install rails

Pour créer une nouvelle application Rails 3:

jruby -S rails new demo_jrails -m http://jruby.org/rails3.rb

Rails 3 inclut toutes les dépendances vers les libraires externes (gems en Ruby) dans un seul fichier Gemfile. Pour installer ces dépendances sur votre machine locale, il suffit de faire:

jruby -S bundle install

Quant à votre fichier de configuration de base de données, il ne dévoilera pas que vous utilisez JDBC et aura l'air tout à fait ordinaire (notez que j'utilise Postgresql):

development:
  adapter: postgresql
  encoding: unicode
  database: demo_jrails_development
  pool: 5
  username: USER
  password: PWD

Si vous avez des problèmes avec la connection à la base de données, commencez par regarder le README d'ActiveRecord JDBC Adapter sur GitHub.

Enfin, si vous voulez utiliser des JARs dans votre JRuby, il convient de créer une variable d'environnement CLASSPATH. J'ai fait pointer la mienne vers le répertoire lib de JRuby:

export CLASSPATH=/~/.rvm/rubies/jruby-1.5.1/lib

Amusez-vous bien avec JRuby et Rails!

Dans un prochain post, nous verrons comment créer un fichier de déploiement Java.