Tutoriel : comment installer Ruby, Ruby on Rails et utiliser RubyGems

Vous avez probablement déjà entendu parler de Ruby on Rails et de la facilité avec laquelle on peut développer rapidement des applications fonctionnelles. Cependant, créer un nouveau logiciel nécessite quelques briques de base et une bonne compréhension de la manière de les utiliser efficacement.

La première étape consiste bien sûr à installer Ruby lui‑même. Comme le nombre de vos projets va probablement augmenter rapidement, gérer plusieurs versions de Ruby peut vite devenir pénible. Pour simplifier cela, la communauté open source a créé plusieurs gestionnaires de versions, les plus populaires étant rbenv et rvm.

Comment installer Ruby sur Mac ?

rvm et rbenv sont disponibles pour macOS et les distributions Linux populaires; l’installation se résume donc à coller quelques lignes de commande dans le terminal.

rbenv

1. Avec Homebrew installé, lancez init dans votre Terminal (et si vous ne l’avez pas, vous pouvez installer rbenv via un checkout GitHub) :

$ brew install rbenv

2. Une fois l’installation terminée, tapez :

$ rbenv init

3. Cela affichera un guide pour configurer votre shell. En général, il suffit d’ajouter une ligne à .zshrc ou .bash_profile :

$ echo 'eval "$(rbenv init -)"' >> ~/.zshrc

4. Désormais, à chaque ouverture du Terminal, rbenv sera prêt à l’emploi.

$ source  ~/.zshrv

5. Il est temps d’installer Ruby. Il suffit d’indiquer le numéro de version après la commande install :

$ rbenv install 2.7.0
$ rbenv global 2.7.0

6. Pour définir la version locale à utiliser, tapez simplement :

$ rbenv local 2.7.0

rvm

Si vous avez déjà installé Ruby avec rbenv, vous avez terminé. rvm est un outil alternatif qui fait la même chose et, en général, il n’est pas conseillé de les utiliser tous les deux en même temps — d’ailleurs, cela n’a pas vraiment d’intérêt.

L’installation de rvm est assez similaire à rbenv; là encore, il suffit d’exécuter quelques commandes dans la console :

1. Commençons par ajouter les clés PGP :

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3

2. Puis récupérez rvm et installez la dernière version de Ruby dans la foulée :

$ curl -sSL https://get.rvm.io | bash -s stable --ruby

3. Vous pouvez télécharger et installer rapidement d’autres versions de Ruby avec la commande install, par exemple :

$ rvm install 2.7.0

À noter que, dans le répertoire de votre projet, vous pouvez créer un fichier .ruby-version (un simple fichier texte contenant le numéro de version de Ruby). À partir de ce fichier, rbenv comme rvm utiliseront la bonne version de Ruby ou proposeront d’installer celle qui manque.

Comment installer Ruby sous Windows ?

Si vous utilisez Windows, la meilleure option est d’utiliser RubyInstaller. Téléchargez simplement le fichier .exe pour la version souhaitée de Ruby et lancez l’installation. RubyInstaller peut être combiné avec MSYS2 (un port de l’outillage de développement Unix) et les bibliothèques MinGW, offrant un excellent environnement de développement.

Vérifier l’installation de Ruby

Après l’installation, vous pouvez vérifier la version avec :

$ ruby -v

Et voir où se trouve l’interpréteur :

$ which ruby

Ruby est un langage interprété. Pour exécuter du code, il suffit de pointer vers le fichier .rb et de lancer :

$ ruby app.rb

Ruby est fourni avec l’Interactive Ruby Shell (irb), qui exécute les commandes Ruby au fur et à mesure que vous les tapez, en temps réel :

$ irb
irb(main):001:0> 2+2
=> 4

Qu’est-ce que RubyGems ?

L’installation standard de Ruby inclut la Ruby Core API et la Standard Library API, utilisées pour écrire des applications Ruby. On peut coder une application simple à partir de zéro avec ces APIs, mais pour quelque chose de plus complexe, il est préférable d’utiliser des packages Ruby fournis via un gestionnaire de paquets. Celui de Ruby s’appelle RubyGems et les packages sont appelés gems. 

RubyGems est livré avec un utilitaire en ligne de commande nommé gem. Il installe des gems depuis des dépôts publics ou privés. À noter aussi https://rubygems.org/, qui héberge de très nombreuses gems de la communauté Ruby. En général, une gem fournit de nouvelles bibliothèques avec des fonctionnalités spécifiques et, parfois, des outils en ligne de commande. 

RubyGems fait partie de l’installation standard de Ruby : rien d’autre à installer.

Comment utiliser les gems Ruby ?

Voyons comment travailler avec les gems. Cette commande affiche la configuration de RubyGems, notamment l’emplacement d’installation des gems :

$ gem env

Installer / désinstaller des gems

Pour installer ou désinstaller des gems, tapez :

$ gem install gem_name (-v version pour spécifier la version de la gem)
$ gem uninstall gem_name

Mettre à jour des gems

Pour mettre à jour une gem spécifique, exécutez :

$ gem update gem_name

Ou toutes les gems :

$ gem update

Lister les gems

Les gems sont installées dans un dépôt local. Pour lister les gems installées, tapez :

$ gem list

Lors de l’installation, toutes les dépendances sont installées avec la gem.

Ruby Bundler

Au fil du développement, votre projet peut nécessiter de plus en plus de gems. Les installer manuellement avec la commande gem rendrait la gestion des dépendances laborieuse, voire impossible. Il existe un outil dédié pour gérer toutes les gems d’un projet — Bundler.

Installer Bundler et déclarer les gems du projet

Bundler est lui‑même une gem, installez‑la d’abord :

$ gem install bundler

Ensuite, créez un Gemfile à la racine de votre projet avec le contenu suivant :

source ‘https://rubygems.org’ gem ‘rails’, ’6.0.2.1’ gem ‘rspec’

Installer les gems avec Bundler

Pour installer, tapez :

$ bundle install

Bundler installera toutes les gems avec les versions spécifiées ainsi que leurs dépendances. Si vous souhaitez utiliser une autre gem dans votre projet, ajoutez‑la au Gemfile puis relancez le bundle install.

Mettre à jour les gems avec Bundler

Pour mettre à jour certaines gems de votre projet, modifiez la version dans le Gemfile puis exécutez à nouveau :

$ bundle install

Pour mettre à jour une gem précise, exécutez :

$ bundle update gem_name

Ou toutes les gems :

$ bundle update

Dans tous les cas, Bundler résoudra les dépendances.

Comment utiliser Ruby on Rails ?

Une fois l’installation et la configuration terminées, il est temps de démarrer un nouveau Ruby on Rails projet et de régler quelques points. 

Installer Rails

Sans surprise — Rails s’installe via une gem :

$ gem install rails

Cela installera la dernière version de Rails ainsi que les gems dont il dépend. Rails propose aussi un utilitaire en ligne de commande pour créer une nouvelle application Ruby on Rails.

Vérifiez la version et les messages d’aide qui décrivent les options de création d’une nouvelle appli.

$ rails -v
$ rails -h

Nouvelle application Rails

Pour créer un projet Rails avec les options par défaut, tapez :

$ rails new my_amazing_rails_app

Cette commande génère toute la structure du projet dans le répertoire my_amazing_rails_app. Vous verrez la création des fichiers de l’application, puis Bundler installera toutes les dépendances du Gemfile fraîchement créé. 

Ensuite, entrez dans le répertoire my_amazing_rails_app et lancez un serveur Rails.

$ cd my_amazing_rails_app
$ rails server

Cela lancera le serveur web Puma, utilisé par défaut par les applications Rails. Le port par défaut est 3000. Ouvrez votre navigateur à l’adresse http://localhost:3000 et vous devriez voir la page d’accueil de Rails.

Comment configurer un environnement de développement Ruby on Rails ?

La base de données par défaut utilisée par Rails est SQLite. Si vous souhaitez utiliser une autre base dès le départ, vous pouvez le préciser avec l’option suivante :

$ rails new my_amazing_rails_app —database postgresql

La configuration de la base de données se trouve dans le fichier config/database.yml. Rails exécute l’application dans un environnement donné (pour un lancement local, l’environnement “development” est utilisé par défaut). Pour définir vos paramètres de base, éditez la section development dans config/database.yml. 

Une autre option fréquemment utilisée est api, qui configure l’application avec un middleware réduit, uniquement pour des applications de type API.

$ rails new my_amazing_rails_app —api

Rails génère de nombreux fichiers. Dans le répertoire app se trouvent les fichiers principaux de l’application. Rails suit le pattern MVC (Model‑View‑Controller) : vous y trouverez donc des fichiers pour les models, controllers et views dans les répertoires adéquats. Dans le répertoire config se trouvent les fichiers de configuration de l’application, des environnements, de la base, des routes, etc. Dans le répertoire db se trouvent le schéma de la base et les fichiers de migration.

Où aller ensuite ?

Il existe de nombreux tutoriels et guides sur Rails. À commencer par https://guides.rubyonrails.org/, qui décrit la plupart des fonctionnalités de Rails avec des exemples. Les APIs de Ruby et de Rails sont bien documentées. Créez simplement une nouvelle appli, un model, un controller et une view associés — vous pourriez bien tomber amoureux de Rails !

Si le développement Ruby on Rails vous intéresse, lisez notre article pour découvrir pourquoi cela vaut la peine d’apprendre Ruby on Rails.