Comment installer Ruby on Rails sur Debian 12

Ruby on Rails ou RoR est un framework d’application web gratuit et open-source écrit en Ruby et publié sous la licence MIT. Rails est un framework web full-stack permettant de créer facilement des applications de niveau entreprise. Rails est livré avec différents outils qui permettent aux développeurs de créer facilement des applications frontend et backend. Ruby on Rails dispose également de fonctionnalités de sécurité intégrées, telles que la protection contre les attaques courantes comme l’injection SQL, le XSS et le CSRF.

Ruby on Rails fournit une structure par défaut pour la base de données, le rendu de modèles HTML, un service web et une page web. Il suit l’architecture modèle-vue-contrôleur (MVC) et utilise également des philosophies de conception bien connues telles que Ne pas se répéter (DRY), Convention plutôt que configuration (CoC) et le modèle des enregistrements actifs. Ruby on Rails a été conçu pour être rapide et facile à utiliser et à apprendre. Certains sites notables développés avec Rails incluent Twitch, Airbnb, Github, Soundcloud, etc.

Dans ce guide, nous vous guiderons à travers l’installation de Ruby on Rails sur le serveur Debian 12. Vous installerez Ruby on Rails avec un serveur de base de données PostgreSQL et le gestionnaire de versions Ruby Rbenv. Vous créerez également un scaffold, la structure de base du projet Rails.

Prérequis

Avant de commencer, assurez-vous d’avoir :

• Un serveur Debian 12.
• Un utilisateur non-root avec des privilèges d’administrateur sudo.

Installation des dépendances

Dans la première étape, vous installerez quelques dépendances de base sur votre serveur Debian. Cela inclut le serveur de base de données PostgreSQL qui sera utilisé comme base de données pour votre projet Rails, Node.js et le gestionnaire de paquets Yarn qui sera utilisé par Rails pour compiler des actifs statiques.

Pour commencer, mettez à jour et rafraîchissez votre index de paquets en exécutant la commande apt update ci-dessous.

sudo apt update

Ensuite, installez les dépendances en utilisant la commande apt install suivante. Cela inclut le serveur de base de données PostgreSQL, le pilote libpq, Node.js, Yarn, Git et quelques bibliothèques et outils système.

sudo apt install postgresql libpq-dev nodejs yarnpkg git zlib1g-dev build-essential libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev software-properties-common libffi-dev

Tapez y pour confirmer et procéder à l’installation.

Une fois les dépendances installées, vérifiez l’état du serveur PostgreSQL en utilisant la commande suivante. Cela garantira que PostgreSQL fonctionne et est activé sur votre machine Debian.

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

Si PostgreSQL est activé, vous devriez obtenir la sortie activée. Lorsque PostgreSQL fonctionne, vous devriez obtenir la sortie active(en cours d’exécution) ou active(sortie).

Enfin, vérifiez Node.js et le gestionnaire de paquets Yarn en exécutant la commande ci-dessous.

node --version  
yarnpkg --version

Dans cet exemple, Node.js 18 et Yarn 1.22 sont installés.

Installation de Rbenv

Après avoir installé les dépendances de paquets, l’étape suivante consiste à installer Rbenv, le gestionnaire de versions Ruby pour les systèmes d’exploitation de type Unix. Avec Rbenv, vous pouvez facilement gérer l’environnement de vos applications Ruby, vous pouvez également installer plusieurs versions de Ruby sur votre système.

Connectez-vous à votre utilisateur en utilisant la commande suivante.

su - user

Téléchargez le code source rbenv et le plugin ruby-build via la commande git ci-dessous.

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

Maintenant, exécutez la commande suivante pour ajouter un PATH personnalisé à votre shell.

echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc  
echo 'eval "$(rbenv init -)"' >> ~/.bashrc  
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc

Rechargez votre configuration ~/.bashrc pour appliquer les modifications. Après avoir exécuté la commande, votre installation de rbenv devrait être activée.

source ~/.bashrc

Vérifiez rbenv en exécutant la commande rbenv ci-dessous. Si l’installation de rbenv est réussie, vous devriez voir les commandes/options rbenv disponibles.

rbenv commands

Installation de Ruby via Rbenv

Avec Rbenv installé, vous pouvez maintenant installer Ruby sur votre système. Avec Rbenv, vous installerez Ruby uniquement sur votre environnement actuel, ce qui n’affecte pas l’ensemble du système. Vous installerez Ruby 3.2.2 dans votre environnement utilisateur actuel.

Exécutez la commande rbenv install ci-dessous pour installer Ruby 3.2.2 sur votre système.

rbenv install 3.2.2

Pendant l’installation, vous devriez voir ceci :

Une fois Ruby installé, exécutez la commande suivante pour définir la version par défaut de Ruby sur 3.2.2.

rbenv global 3.2.2

Enfin, vérifiez la version de Ruby sur votre système en utilisant la commande ci-dessous.

ruby -v

Si tout se passe bien, vous devriez voir Ruby 3.2.2 installé.

Installation de Ruby on Rails

À ce stade, votre système est configuré et prêt à installer Ruby on Rails sur votre machine Debian. Dans cet exemple, vous installerez Ruby on Rails 7.0 et vérifierez la liste des versions disponibles de Rails sur le site officiel.

Exécutez les commandes gem ci-dessous pour installer le bundler, puis installez Ruby on Rails 7.0.7.2.

gem install bundler  
gem install rails -v 7.0.7.2

Pendant l’installation, vous devriez voir une sortie comme suit :

Maintenant, exécutez la commande rebenv ci-dessous pour rehash et recharger votre environnement actuel.

rbenv rehash

Enfin, exécutez la commande rails ci-dessous pour vous assurer que Ruby on Rails est installé.

rails version  
rails -h

Si l’installation est réussie, vous devriez voir votre version actuelle de Rails et la page d’aide de la commande rails.

Création du premier projet Rails

Dans cette section, vous apprendrez à créer votre premier projet avec Ruby on Rails. Vous utiliserez PostgreSQL comme base de données par défaut pour votre projet Rails. Pour y parvenir, vous devez compléter les étapes suivantes :

• Préparer l’utilisateur PostgreSQL pour l’application.
• Créer le premier projet Rails.

Préparer l’utilisateur de la base de données

Tout d’abord, vous devez créer un nouvel utilisateur PostgreSQL qui sera utilisé pour votre application Rails. Cet utilisateur doit avoir des privilèges pour créer des bases de données et des utilisateurs.

Retournez à votre compte utilisateur et connectez-vous au serveur PostgreSQL en utilisant la commande ci-dessous.

sudo su  
sudo -u postgres psql

Maintenant, créez un nouvel utilisateur bob avec le mot de passe p4sswordbob. Ensuite, attribuez de nouveaux privilèges pour créer une base de données et des rôles à l’utilisateur bob.

CREATE USER bob WITH PASSWORD 'p4sswordbob';  
ALTER USER bob CREATEDB CREATEROLE;

Vérifiez la liste des utilisateurs et des privilèges sur votre serveur PostgreSQL en utilisant la commande ci-dessous.

du

Vous devriez voir l’utilisateur bob avec les privilèges CREATEDB et CREATEROLE.

Tapez \q pour vous déconnecter du serveur PostgreSQL.

Enfin, connectez-vous à votre utilisateur et exécutez la commande psql suivante pour vous connecter au serveur PostgreSQL en tant que nouvel utilisateur bob.

su - user  
psql -U bob -h 127.0.0.1 -d postgres

Une fois connecté au serveur PostgreSQL, exécutez la requête suivante pour vérifier vos informations de connexion.

\conninfo

Vous devriez voir que vous êtes connecté au serveur PostgreSQL en tant qu’utilisateur bob.

Tapez \q pour quitter le serveur PostgreSQL.

Création du projet Rails

Après avoir créé un utilisateur PostgreSQL, vous pouvez maintenant commencer à créer un nouveau projet Rails via l’utilitaire en ligne de commande rails.

Pour créer un nouveau projet rails, exécutez la commande rails ci-dessous. Dans cet exemple, vous créerez un nouveau projet testapp avec la base de données par défaut PostgreSQL.

rails new testapp -d postgresql

La sortie de la commande devrait ressembler à ceci :

Après la création du projet, le nouveau répertoire ~/testapp sera également créé. Déplacez-vous dans le répertoire ~/testapp et ouvrez la configuration de la base de données config/database.yml à l’aide de votre éditeur de texte préféré.

cd testapp/  
nano config/database.yml

Modifiez les paramètres de base de données par défaut pour le développement, le test et la production. Assurez-vous d’entrer votre nom d’utilisateur et votre mot de passe PostgreSQL.

development:  
  <<: *default  
  database: testapp_development  
  
  # Le rôle de base de données spécifié est utilisé pour se connecter à postgres.  
  # Pour créer des rôles supplémentaires dans postgres, voir "$ createuser --help".  
  # Lorsqu'il est laissé vide, postgres utilisera le rôle par défaut.  
  # C'est le même nom que l'utilisateur du système d'exploitation exécutant Rails.  
  username: bob  
  
  # Le mot de passe associé au rôle postgres (nom d'utilisateur).  
  password: p4sswordbob  
  
  # Se connecter sur un socket TCP. Omitted par défaut puisque le client utilise un  
  # socket de domaine qui n'a pas besoin de configuration. Windows n'a pas de  
  # sockets de domaine, donc décommentez ces lignes.  
  host: localhost  
  
  # Le port TCP sur lequel le serveur écoute. Par défaut, c'est 5432.  
  # Si votre serveur fonctionne sur un numéro de port différent, changez-le en conséquence.  
  port: 5432

Enregistrez et quittez le fichier lorsque vous avez terminé.

Maintenant, exécutez la commande rails ci-dessous pour migrer la base de données. Cela créera automatiquement une nouvelle base de données pour votre projet testapp.

rails db:setup  
rails db:migrate

Vous devriez voir la sortie pendant la migration de la base de données du projet testapp.

Après la migration de la base de données, exécutez la commande rails ci-dessous pour exécuter le projet testapp. Cela exécutera testapp sur votre adresse IP sur le port 3000.

rails server -b 192.168.10.15

Dans la sortie suivante, vous devriez voir que testapp est en cours d’exécution.

Maintenant, lancez votre navigateur web préféré et visitez l’adresse IP de votre serveur suivie du port 3000, comme http://192.168.10.15:3000/. Si votre installation est réussie, vous devriez voir la page index.html par défaut de Ruby on Rails.

Appuyez sur Ctrl+c pour terminer votre application Rails.

Scaffolding Rails pour le kit de démarrage

Un scaffold est un moyen automatique de générer la structure de base d’un projet Rails, qui comprend un contrôleur, un modèle et une vue.

Exécutez la commande rails ci-dessous pour créer un scaffold books avec trois champs title, author et publication_year.

rails g scaffold books title:string author:string publication_year:integer

Maintenant, migrez la base de données pour appliquer les modifications en utilisant la commande rails ci-dessous.

rails db:migrate

Ensuite, exécutez votre projet Rails en exécutant la commande rails server ci-dessous.

rails server -b 192.168.10.15

Une fois testapp en cours d’exécution, vérifiez le scaffold books via le chemin d’URL /books, comme http://192.168.10.15:3000/books. Si tout se passe bien, vous devriez voir le scaffold généré comme suit :

Vous pouvez maintenant insérer de nouvelles données dans le scaffold books comme suit :

Conclusion

En conclusion, vous avez terminé l’installation de Ruby on Rails avec le serveur de base de données PostgreSQL et Rbenv sur le serveur Debian 12. Vous avez également appris à générer des scaffolds pour les structures de base du projet Rails.