Installer Ruby avec RBenv sur Ubuntu ou Debian

La fonction de rbenv est de gérer plusieurs environnements Ruby pour vous permettre de passer rapidement d’une version de Ruby à l’autre, soit répertoire par répertoire, soit à l’échelle du système.

Un tel outil de gestion des versions de Ruby est essentiel lorsque l’on travaille sur plusieurs projets qui nécessitent différentes versions de Ruby.

Cet article vous montrera comment installer Ruby avec rbenv et gérer différentes versions de Ruby.

Désinstaller des paquets Ruby de votre distro

Si vous avez installé Ruby via les paquets de votre distribution linux, il est important de les désinstaller pour avoir une installation propre et laisser gérer l’ensemble de l’environnement Ruby par rbenv.

$ sudo apt-get remove ruby

Installer rbenv

Nous allons installer rbenv à partir de git, vous devrez donc installer quelques dépendances :

$ sudo apt update

$ sudo apt install git curl libssl-dev libreadline-dev zlib1g-dev autoconf bison build-essential libyaml-dev libreadline-dev libncurses5-dev libffi-dev libgdbm-dev

Il existe un script d’installation pour l’installation de rbenv, mais je vais vous montrer la méthode manuelle, qui consiste en 2 commandes. De cette façon, vous pouvez comprendre comment rbenv est installé sur votre système, ce qui facilitera les mises à jour ultérieures.

Installez rbenv :

$ git clone https://github.com/sstephenson/rbenv.git ~/.rbenv

Installez également le plugin ruby-build qui permet l’accès à chaque version de ruby :

$ git clone https://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build

Configurez votre système pour initialiser rbenv :

$ echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc

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

Initialisez votre système, soit en fermant et en ouvrant votre terminal, soit en tapant :

$ source ~/.bashrc

Vérifiez l’installation :

$ rbenv -v
rbenv 1.1.2-40-g62d7798

Installer une version de Ruby

L’installation d’une version de Ruby peut prendre quelques minutes le temps de la compilation, mais est très simple :

$ rbenv install 3.0.0
Downloading ruby-3.0.0.tar.gz...
-> https://cache.ruby-lang.org/pub/ruby/3.0/ruby-3.0.0.tar.gz
Installing ruby-3.0.0...
Installed ruby-3.0.0 to /opt/rbenv/versions/3.0.0

Vous pouvez vérifier quelles versions de Ruby qui sont installées sur votre système :

$ rbenv versions
  system
  2.6.0
  2.6.4
  2.6.5
  2.7.1
* 2.7.2 (set by ~/.rbenv/version)
  3.0.0

Notez que si vous essayez d’installer une version de Ruby et que rbenv ne la trouve pas, vous devrez mettre à jour le plugin ruby-build.

Changer de version de Ruby avec rbenv

Rbenv permet de définir quelle version de Ruby est à utiliser pour l’ensemble du système. Voici comment faire :

$ rbenv global 3.0.0

Si vous voulez que certains répertoires et tout ce qu’ils contiennent utilisent une autre version de Ruby, vous devez l’indiquer à rbenv de cette façon :

$ cd /path/to/project

$ rbenv local 2.6.0

Cette dernière commande génère un fichier .ruby-version qui indique à rbenv quelle version de ruby utiliser localement.

La gem bundler

Bundler est un outil qui vous permet d’installer facilement des dépendances sur vos projets. Il est utilisé par les projets Ruby on Rails.

Note : si vous voulez gagner du temps lors de l’installation et ne voulez pas générer la documentation, tapez la commande suivante avant d’installer le bundler :

$ echo "gem: --no-document" > ~/.gemrc

Installer bundler :

$ gem install bundler
Fetching bundler-2.2.7.gem
Successfully installed bundler-2.2.7
1 gem installed

Mise à jour de rbenv

La mise à jour de rbenv n’a pas besoin d’être faite souvent, mais la mise à jour du plugin ruby-build est nécessaire à chaque fois qu’une nouvelle version de Ruby a été publiée et que vous souhaitez l’installer.

Mettre à jour rbenv :

$ cd ~/.rbenv

$ git pull

Mettre à jour ruby-build :

$ cd ~/.rbenv/plugins/ruby-build

$ git pull