Comment installer Ruby on Rails avec rbenv sur macOS

Introduction

Ruby on Rails est une pile d’applications populaire pour les développeurs souhaitant créer des sites et des applications web. Le langage de programmation Ruby, associé au framework de développement Rails, permet un développement rapide et efficace des applications.

Une façon d’installer Ruby et Rails est d’utiliser l’outil en ligne de commande rbenv. L’utilisation de rbenv vous fournira un environnement bien maîtrisé et robuste pour le développement de vos applications Ruby on Rails, vous permettant de changer facilement la version de Ruby en cours d’utilisation selon vos besoins.

rbenv prend en charge la spécification de versions spécifiques de Ruby pour chaque application, vous permet de changer la version globale de Ruby pour chaque utilisateur, et vous permet d’utiliser une variable d’environnement pour remplacer la version de Ruby.

Dans ce tutoriel, vous utiliserez rbenv pour installer et configurer Ruby on Rails sur votre machine locale macOS.

Prérequis

Pour suivre ce tutoriel, vous aurez besoin de :

• Un ordinateur ou une machine virtuelle avec macOS installé, avec un accès administratif à cette machine et une connexion internet. Ce tutoriel a été testé sur macOS 12.4 Monterey.
• Node.js est installé sur votre machine macOS, comme expliqué dans Comment installer Node.js et créer un environnement de développement local sur macOS. Certaines fonctionnalités de Rails, telles que le Asset Pipeline, dépendent d’un runtime JavaScript. Node.js fournit cette fonctionnalité.
• Le gestionnaire de paquets Homebrew est installé sur votre machine macOS.

Étape 1 — Installation de rbenv

Dans cette étape, vous installerez rbenv et vous assurerez qu’il démarre automatiquement au démarrage. Pour ce faire sur macOS, ce tutoriel utilisera le gestionnaire de paquets Homebrew.

Pour télécharger le paquet rbenv avec Homebrew, exécutez la commande suivante:

brew install rbenv

Cela installera rbenv et le plugin [ruby-build] (https://github.com/rbenv/ruby-build). Ce plugin ajoute la commande rbenv install, qui simplifie le processus d’installation des nouvelles versions de Ruby. Cela peut également installer plusieurs autres dépendances et prendre un certain temps.

Ensuite, vous ajouterez la commande eval "$(rbenv init -)" à votre fichier ~/.bash_profile pour que rbenv se charge automatiquement lorsque vous ouvrez le Terminal. Pour ce faire, ouvrez votre fichier .bash_profile dans nano ou votre éditeur de texte préféré :

nano .bash_profile

Ajoutez la ligne suivante au fichier :

eval "$(rbenv init -)"

Enregistrez et quittez le fichier.

Ensuite, appliquez les modifications apportées à votre fichier ~/.bash_profile à votre session shell actuelle :

source ~/.bash_profile

Pour vérifier que rbenv est configuré correctement, utilisez la commande type, qui affichera plus d’informations sur la commande rbenv :

type rbenv

Votre fenêtre de terminal affichera ce qui suit :

Output
rbenv is a function
rbenv ()
{
    local command;
    command="${1:-}";
    if [ "$#" -gt 0 ]; then
        shift;
    fi;
    case "$command" in
        rehash | shell)
            eval "$(rbenv "sh-$command" "$@")"
        ;;
        *)
            command rbenv "$command" "$@"
        ;;
    esac
}

À ce stade, vous avez à la fois rbenv et ruby-build installés sur votre machine. Cela vous permettra d’installer Ruby depuis la ligne de commande à l’étape suivante.

Étape 2 — Installation de Ruby

Avec le plugin ruby-build maintenant installé, vous pouvez installer n’importe quelle version de Ruby dont vous pourriez avoir besoin via une seule commande. À cette étape, vous choisirez une version de Ruby, l’installerez sur votre machine, puis vérifierez l’installation.

Tout d’abord, utilisez le drapeau -l pour lister les versions disponibles de Ruby. Notez que des versions mineures récentes non répertoriées peuvent également être disponibles. Par exemple, si la sortie de cette commande répertorie Ruby 3.0.5, vous pourrez probablement également installer 3.0.4.

rbenv install -l

Output
2.6.10
2.7.6
3.0.4
3.1.2
jruby-9.3.6.0
mruby-3.1.0
picoruby-3.0.0
rbx-5.0
truffleruby-22.1.0
truffleruby+graalvm-22.1.0

La sortie de cette commande sera une longue liste de versions parmi lesquelles vous pourrez choisir celle à installer.

Pour ce tutoriel, nous installerons Ruby 3.1.2 :

rbenv install 3.1.2

L’installation de Ruby peut prendre un certain temps, alors soyez prêt pour que l’installation prenne un certain temps pour se terminer.

Une fois l’installation terminée, définissez-la comme votre version par défaut de Ruby avec la sous-commande global :

rbenv global 3.1.2

Vérifiez que Ruby a été correctement installé en vérifiant son numéro de version :

ruby -v

Votre sortie ressemblera à quelque chose comme ceci :

Output
ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [x86_64-darwin21]

Pour installer et utiliser une version différente de Ruby, exécutez les commandes rbenv avec un numéro de version différent, tel que rbenv install 2.7.6 et rbenv global 2.7.6.

Vous avez maintenant une version de Ruby installée et avez défini votre version de Ruby par défaut. Ensuite, vous vous configurerez pour travailler avec les packages et les bibliothèques Ruby, ou gems, ce qui vous permettra ensuite d’installer Rails.

Étape 3 — Travailler avec les Gems

Les Gems sont des packages de bibliothèques et de programmes Ruby qui peuvent être distribués dans tout l’écosystème Ruby. Vous utilisez la commande gem pour gérer ces gems. Dans cette étape, vous configurerez la commande gem pour préparer l’installation de Rails.

Lorsque vous installez une gem, le processus d’installation génère une documentation locale. Cela peut ajouter une quantité significative de temps à chaque processus d’installation de gemmes. Vous pouvez désactiver la génération de documentation locale en créant un fichier appelé ~/.gemrc qui contient un paramètre de configuration pour désactiver cette fonctionnalité :

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

Une fois cela fait, utilisez la commande gem pour installer Bundler, un outil qui gère les dépendances des gemmes pour les projets. C’est nécessaire pour que Rails fonctionne correctement :

gem install bundler

Vous verrez une sortie comme ceci :

Output
Fetching: bundler-2.3.18.gem
Successfully installed bundler-2.3.18
1 gem installed

Vous pouvez utiliser la commande gem env pour en savoir plus sur l’environnement et la configuration des gemmes. Pour voir l’emplacement des gemmes installées, utilisez l’argument home, comme ceci :

gem env home

Vous verrez une sortie similaire à ceci :

/Users/sammy/.rbenv/versions/3.1.2/lib/ruby/gems/3.1.0

Maintenant que vous avez configuré et exploré votre flux de travail avec les gemmes, vous êtes libre d’installer Rails.

Étape 4 — Installation de Rails

Pour installer Rails, utilisez la commande gem install :

gem install rails

La commande gem installe la gemme que vous spécifiez, ainsi que toutes ses dépendances. Rails est un framework complexe de développement web et a de nombreuses dépendances, donc le processus prendra un certain temps pour se terminer. Vous verrez éventuellement un message indiquant que Rails est installé, ainsi que ses dépendances :

Output
...
Successfully installed rails-7.0.3.1
35 gems installed

gem search '^rails$' --all
gem install rails -v 4.2.7

rbenv fonctionne en créant un répertoire de shims, ou des bibliothèques qui interceptent les appels et les modifient ou les redirigent. Dans ce cas, les shims pointent les commandes Ruby vers les fichiers utilisés par la version Ruby actuellement activée. Grâce à la sous-commande rehash, rbenv maintient des shims dans ce répertoire pour correspondre à chaque commande Ruby sur chaque version installée de Ruby sur votre serveur. Chaque fois que vous installez une nouvelle version de Ruby ou un gemme qui fournit des commandes, telles que Rails, vous devriez utiliser rehash.

Pour actualiser le répertoire des shims, exécutez la commande suivante:

rbenv rehash

Vérifiez votre installation de Rails en imprimant sa version avec cette commande:

rails -v

Vous verrez la version de Rails qui a été installée:

Output
Rails 7.0.3.1

Avec Rails installé avec succès, vous pouvez commencer à tester votre installation Ruby on Rails et commencer à développer des applications web. À l’étape suivante, vous apprendrez comment mettre à jour et désinstaller rbenv et Ruby.

Étape 5 — Mise à jour et désinstallation de rbenv et Ruby

Lors de la maintenance de projets, il est utile de savoir comment mettre à jour et désinstaller lorsque cela est nécessaire. À cette étape, vous allez mettre à niveau rbenv, puis désinstaller Ruby et rbenv de votre machine.

Vous pouvez mettre à niveau rbenv et ruby-build en utilisant Homebrew en exécutant la commande suivante :

brew upgrade rbenv ruby-build

Si rbenv ou ruby-build doivent être mis à jour, Homebrew le fera automatiquement pour vous. Si votre configuration est déjà à jour, vous obtiendrez une sortie similaire à ce qui suit :

Output
Warning: rbenv 1.2.0 already installed
Warning: ruby-build 20220713 already installed

Cela garantira que nous utilisons la version la plus récente de rbenv disponible.

En téléchargeant des versions supplémentaires de Ruby, vous pouvez accumuler plus de versions que vous ne le souhaiteriez dans votre répertoire ~/.rbenv/versions. En utilisant la sous-commande uninstall du plugin ruby-build, vous pouvez supprimer ces versions précédentes.

Par exemple, exécutez ce qui suit pour désinstaller la version Ruby 2.1.3 :

rbenv uninstall 2.1.3

Avec la commande rbenv uninstall, vous pouvez nettoyer les anciennes versions de Ruby afin de ne pas en avoir plus installées que celles que vous utilisez actuellement.

Si vous avez décidé de ne plus utiliser rbenv, vous pouvez le supprimer de votre système.

Pour ce faire, ouvrez d’abord votre fichier ~/.bash_profile dans votre éditeur :

nano ~/.bash_profile

Recherchez et supprimez la ligne suivante du fichier pour empêcher rbenv de démarrer lorsque vous ouvrez le Terminal :

...
eval "$(rbenv init -)"

Une fois cette ligne supprimée, enregistrez le fichier et quittez l’éditeur.

Exécutez la commande suivante pour appliquer les modifications à votre shell :

source ~/.bash_profile

Ensuite, supprimez rbenv et toutes les versions de Ruby installées avec cette commande :

rm -rf `rbenv root`

Enfin, supprimez le paquet rbenv lui-même avec Homebrew :

brew uninstall rbenv

Vérifiez la version de rbenv pour vous assurer qu’il a été désinstallé :

rbenv -v

Vous obtiendrez la sortie suivante :

Output
-bash: /usr/local/bin/rbenv: No such file or directory

Cela signifie que vous avez réussi à supprimer rbenv de votre machine.

Conclusion

Dans ce tutoriel, vous avez installé Ruby on Rails avec rbenv sur macOS. À partir de là, vous pouvez en apprendre davantage sur la programmation en Ruby avec notre série Comment Coder en Ruby. Vous pouvez également explorer comment utiliser Ruby on Rails avec PostgreSQL plutôt que sa base de données par défaut sqlite3, ce qui offre plus de scalabilité, de centralisation et de stabilité pour vos applications.