Comment installer Ruby on Rails sur Ubuntu 24.04

Ruby on Rails ou RoR ou Rails est un framework d’application web Ruby avec une architecture MVC (Modèle-Vue-Contrôleur), ainsi que des philosophies de conception telles que Ne vous répétez pas (DRY), Convention plutôt que configuration (CoC) et le modèle des enregistrements actifs. C’est un framework web full-stack pour construire des applications web de niveau entreprise.

Dans ce tutoriel, nous vous guiderons à travers le processus d’installation de Ruby on Rails sur Ubuntu 24.04, la création du premier projet Rails, la configuration de PostgreSQL comme base de données pour votre projet Rails, et la génération d’un scaffold avec la commande ‘rails’.

Prérequis

Avant de commencer, assurez-vous d’avoir les éléments suivants :

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

Installation des dépendances

Pour installer Ruby on Rails sur votre système Ubuntu, vous devez installer des dépendances telles que Ruby, Node.js, PostgreSQL (optionnel pour la base de données), Git et des paquets de développement supplémentaires. Ces paquets sont disponibles dans le dépôt par défaut d’Ubuntu, et vous pouvez les installer en utilisant APT.

Pour commencer, mettez à jour votre dépôt Ubuntu avec la commande suivante :

sudo apt update

Maintenant, installez les dépendances pour Ruby on Rails avec la commande ci-dessous. Avec cela, vous installerez Ruby, PostgreSQL, Node.js, git et quelques paquets de développement.

sudo apt install ruby ruby-dev 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 libffi-dev

Entrez Y pour procéder à l’installation.

Après l’installation, vérifiez la version de Ruby et de Node.js avec ce qui suit :

ruby -v  
node -v

Vous pouvez voir ci-dessous que Ruby 3.2 et Node.js 18.19 sont installés.

Ensuite, exécutez la commande ci-dessous pour configurer Yarn comme gestionnaire de paquets Node.js avec la commande ci-dessous. Cela créera une nouvelle commande ‘ yarn ‘ et vous verrez la version de Yarn.

sudo ln -s /usr/bin/yarnpkg /usr/bin/yarn  
yarnpkg -v

Enfin, vérifiez l’état du service PostgreSQL avec ce qui suit :

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

Le serveur PostgreSQL démarrera au démarrage, et l’état de PostgreSQL sera ‘ actif (exité) ‘.

Création d’un utilisateur PostgreSQL

Après l’installation des dépendances, vous allez créer un nouvel utilisateur PostgreSQL pour votre projet Rails. Cet utilisateur doit pouvoir se connecter et créer une nouvelle base de données sur PostgreSQL.

Connectez-vous au serveur PostgreSQL avec la commande ci-dessous.

sudo -u postgres psql

Exécutez les requêtes suivantes pour créer un nouvel utilisateur PostgreSQL ‘ appuser ‘ avec le mot de passe ‘ AppuserPassword ‘. Cet utilisateur pourra créer une base de données et un rôle dans PostgreSQL.

CREATE USER appuser WITH PASSWORD 'AppuserPassword';  
ALTER USER appuser CREATEDB CREATEROLE;

Maintenant, tapez quit ou appuyez sur Ctrl+d pour quitter PostgreSQL.

Ensuite, exécutez la commande suivante pour vous connecter à PostgreSQL avec l’utilisateur ‘ appuser ‘. Entrez votre mot de passe lorsque vous y êtes invité.

su - postgres  
psql -U appuser -h 127.0.0.1 -d postgres

Après vous être connecté, vérifiez l’état de la connexion PostgreSQL avec ce qui suit :

elconninfo

Vous pouvez voir ci-dessous que le nouvel utilisateur ‘ appuser ‘ peut se connecter au serveur PostgreSQL avec l’authentification par mot de passe via localhost ou 127.0.0.1.

Installation de Ruby on Rails

Dans cette section, vous allez installer la dernière version de Ruby on Rails dans l’environnement spécifique à l’utilisateur. Vous devez donc configurer le répertoire GEM_HOME par défaut sous votre utilisateur.

Tout d’abord, connectez-vous à votre utilisateur avec la commande suivante :

su - user

Créez un nouveau répertoire ~/.gem et ajoutez la variable d’environnement GEM_HOME via le fichier ~/.bashrc. Avec cela, tous les gems Ruby seront installés dans le répertoire ~/.gem.

mkdir -p ~/.gem  
echo 'export GEM_HOME=$HOME/.gem' >> $HOME/.bashrc

Maintenant, exécutez la commande ci-dessous pour recharger votre shell actuel et vérifier la variable d’environnement GEM_HOME. Vous verrez que GEM_HOME pointe vers le répertoire ~/.gem.

source ~/.bashrc  
echo $GEM_HOME

Ensuite, exécutez la commande gem ci-dessous pour installer le bundler sur votre système.

gem install bundler

Après cela, installez Ruby on Rails avec la commande gem suivante. Vous pouvez installer la dernière version de Ruby on Rails ou choisir une version spécifique en utilisant l’option -v.

gem install rails  
gem install rails -v 7.1.0

Lorsque l’installation est terminée, vérifiez la version de Ruby on Rails avec la commande ci-dessous :

rails --version  
rails --help

Comme montré ci-dessous, la dernière version de Ruby on Rails 7.1.3 est installée, et vous pouvez également voir l’utilisation de base de la commande ‘ rails ‘.

Création d’un projet avec Ruby on Rails et PostgreSQL

Maintenant que vous avez installé Ruby on Rails. Dans cette section, vous allez créer votre premier projet Rails avec PostgreSQL comme base de données par défaut.

Exécutez la commande ‘rails’ ci-dessous pour créer un nouveau projet Rails. Dans cet exemple, vous allez créer un nouveau projet testapp avec la base de données par défaut PostgreSQL.

rails new testapp -d postgresql

Vous pouvez voir ci-dessous que l’application Rails est générée, y compris le git initialisé.

Maintenant, déplacez-vous dans le répertoire ~/testapp et éditez le fichier de configuration de la base de données ‘ config/database.yml ‘.

cd ~/testapp/  
nano config/database.yml

Changez les détails de la base de données pour les environnements développement, test et production comme suit. La base de données pour chaque environnement sera créée automatiquement lors de la migration.

développement:  
 <<: *default  
 base de données: testapp_development  
 nom d'utilisateur: appuser  
 mot de passe: AppuserPassword  
 hôte: localhost  
 port: 5432  
  
test:  
 <<: *default  
 base de données: testapp_test  
 nom d'utilisateur: appuser  
 mot de passe: AppuserPassword  
 hôte: localhost  
 port: 5432  
  
production:  
 <<: *default  
 base de données: testapp_production  
 nom d'utilisateur: appuser  
 mot de passe: <%= ENV["TESTAPP_DATABASE_PASSWORD"] %>

Une fois terminé, enregistrez le fichier et quittez.

Ensuite, exécutez la commande ‘ rails ‘ suivante pour configurer et migrer la base de données.

rails db:setup  
rails db:migrate

Après que la migration de la base de données soit terminée, exécutez votre projet Rails avec ce qui suit :

rails server -b 0.0.0.0

Vous pouvez voir ci-dessous que votre projet Rails fonctionne sur le port par défaut 3000.

Visitez l’adresse IP de votre serveur http://192.168.5.30:3000/ à l’aide de votre navigateur web. Si votre installation de Rails est réussie, vous devriez obtenir l’index par défaut de Rails suivant :

Génération avec Scaffolding

Ruby on Rails fournit un moyen facile de construire votre application pour les débutants. Vous pouvez utiliser un scaffold pour 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 suivante pour générer un scaffold pour une application simple ‘ site ‘ avec deux entrées utilisateur ‘ nom ‘ et ‘ url ‘.

rails g scaffold site name:string url:string

Ci-dessous se trouve le modèle, le contrôleur et la vue générés par Rails pour votre application.

Après que le scaffold soit généré, exécutez la commande suivante pour migrer votre base de données Rails.

rails db:migrate

Vous pouvez voir ci-dessous que la base de données pour Rails a été migrée.

Maintenant, exécutez votre projet Rails avec la commande suivante.

rails server -b 0.0.0.0

Enfin, visitez l’adresse IP de votre serveur http://192.168.5.30:3000/sites pour accéder à l’application ‘ site ‘. Vous pouvez soumettre un nouveau nom de données et une url. Ensuite, vous pouvez voir ci-dessous un exemple après que de nouvelles données aient été soumises.

Conclusion

Félicitations ! Vous avez terminé l’installation de Ruby on Rails sur Ubuntu 24.04. Vous avez créé un projet Rails avec PostgreSQL comme base de données. Enfin, vous avez également appris comment générer des applications de base sur Rails en utilisant la fonctionnalité scaffold.