C’est un sujet récurrent lorsqu’on souhaite se mettre au Ruby on Rails: comment installer un environnement Ruby on Rails sur sa machine ?
Il existe de nombreux tutoriels pour installer Ruby on Rails mais les outils changent et s’améliorent au fil du temps. Les documentations sont donc parfois obsolètes.
Cet article couvre l’installation sous Mac uniquement. Elle a été testée depuis une machine virtuelle vierge sous Mountain Lion, mais devrait fonctionner tout aussi bien sur des versions plus anciennes d’OSX.
Si vous souhaitez suivre cette installation de ruby on rails sur mac en vidéo, rendez vous sur la vidéo associées sur Hackademy.
XCode ne vous servira pas en temps que tel mais vous permettra d’installer simplement les outils de devéloppement (gcc…) nécessaires à la compilation de ruby.
Vous pouvez l’installer depuis l’app store.
Il y a quelques temps 2 gestionnaires de paquets étaient disponibles sous Mac OS X: Fink et MacPorts.
Si vous utilisez l’un des deux assurez vous de le désinstaller.
À l’heure actuelle c’est Homebrew qui est le plus maintenu. Qui plus est, les formules permettant d’installer des packages sont écrites en ruby, ne boudons pas notre plaisir.
Pour installer brew, votre compte a besoin des privilèges administrateur:
ruby -e "$(curl -fsSkL raw.github.com/mxcl/homebrew/go)"
Git est un élément central de tous les outils que nous allons utiliser. C’est un outil de versioning de code source.
brew install git
Les derniers OS X sont livrés avec ruby mais en version 1.8.7, alors que la version actuelle est la 1.9.3.
Rbenv permet d’installer plusieurs versions de ruby et d’en changer de façon transparente selon le projet, et donc de suivre les versions les plus à jour pour les projets les plus récents.
Mettons d’abord à jour les formules de Homebrew afin d’installer les dernières versions des outils voulus.
brew update
puis installons rbenv:
brew install rbenv
rbenv va nous permettre d’utiliser plusieurs versions de ruby mais n’inclut pas de base l’outil pour installer des versions spécifiques de ruby. C’est ruby-build qui s’en charge:
brew install ruby-build
Afin que rbenv soit disponible dans notre shell, il a besoin de s’initialiser au lancement du shell:
echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
Une fois réalisé, ouvrez un nouvel onglet dans le terminal pour que le paramétrage soit pris en compte.
Maintenant que rbenv est installé, nous allons pouvoir installer la version de ruby voulue.
rbenv install 1.9.3-p194
Définissons cette version comme la version par défaut plutôt que la version 1.8.7 du système:
rbenv global 1.9.3-p194
L’environnement ruby est composé de gems, qui sont des libs, voire plus, packagées. Bundler est un outil permettant de gérer les dépendances et les versions de ces gems.
gem install bundler
Installons la dernière version de rails:
gem install rails
Au besoin nous pouvons installer une version spécifique, par exemple:
gem install rails -v=3.1
On le voit à l’installation, Ruby on Rails dépend de nombreuses gems.
Quand vous installez une gem qui mettra à disposition une commande,
il est important de faire un rbenv rehash.
Une fois installée, la commande est disponible, vous êtes prêt à créer votre première application Ruby on Rails:
rails new app
Indiquer la version de ruby utilisée est très simple, il suffit de créer un fichier .rbenv-version dans le projet, contenant le numéro de version.
Si je me déplace dans un dossier contenant ce fichier, c’est la version définie qui prendra le pas sur la version globale.
Si par exemple dans mon projet je crée un fichier avec la dernière version sortie (1.9.3-p286),
ruby -v m’indiquera que la version n’est pas installée.
Nous espérons que ce pas à pas vous permettra de débuter sous Rails. Pour toute question n’hésitez pas à laisser un commentaire.
L’équipe Synbioz.
Libres d’être ensemble.
