Comment installer Ruby on Rails avec Rbenv sur macOS

introduction

https://rubyonrails.org [Ruby on Rails] est une pile d’applications très utilisée par les développeurs cherchant à créer des sites et des applications Web. Le langage de programmation Ruby, associé au cadre de développement Rails, permet un développement rapide et efficace des applications.

L’un des moyens d’installer Ruby and Rails consiste à utiliser l’outil de ligne de commande rbenv. L’utilisation de rbenv vous fournira un environnement bien contrôlé et robuste pour le développement de vos applications Ruby on Rails, vous permettant ainsi de changer facilement de version de Ruby pour l’ensemble de votre équipe en cas de besoin.

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

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

Conditions préalables

Pour suivre ce tutoriel, vous aurez besoin de:

Étape 1 - Installation de rbenv

Dans cette étape, vous allez installer rbenv et vous assurer 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 package + rbenv + avec Homebrew, exécutez la commande suivante:

brew install rbenv

Ceci installera rbenv et le plug-in ruby-build. Ce plugin ajoute la commande + rbenv install +, qui simplifie le processus d’installation pour les nouvelles versions de Ruby.

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 + .bash_profile dans votre éditeur de texte préféré:

nano .bash_profile

Ajoutez la ligne suivante au fichier:

~ / .bash_profile

eval "$(rbenv init -)"

Enregistrez et quittez le fichier.

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

source ~/.bash_profile

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

type rbenv

La fenêtre de votre terminal affichera les informations suivantes:

Outputrbenv 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, rbenv et ruby-build sont installés sur votre machine. Cela vous permettra d’installer Ruby à partir de 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 au moyen d’une seule commande. Dans cette étape, vous allez choisir une version de Ruby, l’installer sur votre ordinateur, puis vérifier l’installation.

Commencez par utiliser l’indicateur + -l + pour répertorier toutes les versions disponibles de Ruby:

rbenv install -l

Le résultat de cette commande sera une longue liste de versions que vous pouvez choisir d’installer.

Pour ce tutoriel, installez Ruby:

rbenv install

L’installation de Ruby peut être un processus long. Soyez donc prêt pour l’installation prend du temps.

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

rbenv global

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

ruby -v

Votre sortie ressemblera à ceci:

Outputruby 2.6.3p62 (2019-04-16 revision 67580) [x86_64-darwin18]

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 + et + + rbenv global +.

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

Étape 3 - Travailler avec des pierres précieuses

Les gems sont des paquets de bibliothèques et de programmes Ruby pouvant être distribués dans l’écosystème Ruby. Vous utilisez la commande + gem + pour gérer ces gems. Dans cette étape, vous allez configurer la commande + gem + pour préparer l’installation de Rails.

Lorsque vous installez une gemme, le processus d’installation génère une documentation locale. Cela peut prendre beaucoup de temps au processus d’installation de chaque gem. Désactivez donc la génération de documentation locale en créant un fichier nommé + ~ / .gemrc + qui contient un paramètre de configuration permettant de désactiver cette fonctionnalité:

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

Ceci fait, utilisez la commande + gem + pour installer Bundler, un outil qui gère les dépendances entre gems pour les projets. Ceci est nécessaire pour que Rails fonctionne correctement:

gem install bundler

Vous verrez la sortie comme ceci:

OutputFetching: bundler-.gem
Successfully installed bundler-
1 gem installed

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

gem env home

Vous verrez une sortie semblable à celle-ci:

/Users//.rbenv/versions//lib/ruby/gems/

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

Étape 4 - Installation des rails

Pour installer Rails, utilisez la commande + gem install avec l’indicateur` + -v` pour spécifier la version. Pour ce tutoriel, nous utiliserons la version + 5.2.3 +:

gem install rails -v

La commande + gem + installe la gem que vous spécifiez, ainsi que toutes les dépendances. Rails est un cadre de développement Web complexe et comporte de nombreuses dépendances. Le processus prendra donc un certain temps. Vous verrez éventuellement un message indiquant que Rails est installé, ainsi que ses dépendances:

Output...
Successfully installed rails-
38 gems installed

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, shims pointe les commandes Ruby vers les fichiers utilisés par la version de Ruby actuellement activée. Par le biais de la sous-commande + rehash +, rbenv conserve des shims dans ce répertoire afin de faire correspondre toutes les commandes Ruby à toutes les versions installées de Ruby sur votre serveur. Chaque fois que vous installez une nouvelle version de Ruby ou une gemme fournissant des commandes, telles que Rails, vous devez utiliser + rehash +.

Pour réorganiser 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 installée:

OutputRails

Une fois Rails installé, vous pouvez commencer à tester votre installation de Ruby on Rails et commencer à développer des applications Web. Dans l’étape suivante, vous apprendrez à mettre à jour et à désinstaller rbenv et Ruby.

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

Lors de la maintenance de projets, il est utile de savoir comment mettre à jour et désinstaller le cas échéant. Dans cette étape, vous allez mettre à niveau rbenv, puis désinstaller Ruby et rbenv de votre ordinateur.

Vous pouvez mettre à niveau rbenv et ruby-build à l’aide de Homebrew en exécutant la commande suivante:

brew upgrade rbenv ruby-build

Si rbenv ou ruby-build doit être mis à jour, Homebrew le fera automatiquement pour vous. Si votre configuration est déjà à jour, vous obtiendrez une sortie semblable à celle-ci:

OutputError: rbenv  already installed
Error: ruby-build  already installed

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

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

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

rbenv uninstall

Avec la commande + rbenv uninstall + vous pouvez nettoyer les anciennes versions de Ruby afin d’en installer plus que ce 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:

~ / .bash_profile

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

Une fois que vous avez supprimé cette ligne, 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 installées de Ruby 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’elle a été désinstallée:

rbenv -v

Vous obtiendrez le résultat suivant:

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

Cela signifie que vous avez correctement supprimé 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 le codage 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 sqlite3 par défaut, qui offre davantage d’évolutivité, de centralisation et de stabilité pour vos applications.