Come installare Ruby on Rails su Ubuntu 24.04

Ruby on Rails o RoR o Rails è un framework per applicazioni web in Ruby con architettura MVC (Model-View-Controller), oltre a filosofie di design come Non Ripeterti (DRY), Convenzione su Configurazione (CoC) e pattern di record attivi. È un framework web full-stack per costruire applicazioni web di livello enterprise.

In questo tutorial, ti guideremo attraverso il processo di installazione di Ruby on Rails su Ubuntu 24.04, creando il primo progetto Rails, configurando PostgreSQL come database per il tuo progetto Rails e generando uno scaffold con il comando ‘rails’.

Prerequisiti

Prima di iniziare, assicurati di avere i seguenti requisiti:

• Un server Ubuntu 24.04.
• Un utente non root con privilegi di amministratore sudo.

Installazione delle dipendenze

Per installare Ruby on Rails sul tuo sistema Ubuntu, devi installare dipendenze come Ruby, Node.js, PostgreSQL (opzionale per il database), Git e pacchetti di sviluppo aggiuntivi. Questi pacchetti sono disponibili nel repository predefinito di Ubuntu e puoi installarli usando APT.

Per iniziare, aggiorna il tuo repository Ubuntu con il seguente comando:

sudo apt update

Ora installa le dipendenze per Ruby on Rails con il comando qui sotto. Con questo, installerai Ruby, PostgreSQL, Node.js, git e alcuni pacchetti per sviluppatori.

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

Inserisci Y per procedere con l’installazione.

Dopo che l’installazione è completata, controlla la versione di Ruby e Node.js con il seguente comando:

ruby -v  
node -v

Puoi vedere qui sotto che Ruby 3.2 e Node.js 18.19 sono installati.

Successivamente, esegui il comando qui sotto per impostare Yarn come gestore di pacchetti Node.js con il comando qui sotto. Questo creerà un nuovo comando ‘ yarn ‘ e vedrai la versione di Yarn.

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

Infine, controlla lo stato del servizio PostgreSQL con il seguente comando:

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

Il server PostgreSQL si avvierà all’avvio, e lo stato di PostgreSQL sarà ‘ attivo (uscito) ‘.

Creazione di un utente PostgreSQL

Dopo aver installato le dipendenze, creerai un nuovo utente PostgreSQL per il tuo progetto Rails. Questo utente deve essere in grado di accedere e creare un nuovo database su PostgreSQL.

Accedi al server PostgreSQL con il comando qui sotto.

sudo -u postgres psql

Esegui le seguenti query per creare un nuovo utente PostgreSQL ‘ appuser ‘ con la password ‘ AppuserPassword ‘. Questo utente sarà in grado di creare un database e un ruolo in PostgreSQL.

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

Ora digita quit o premi Ctrl+d per uscire da PostgreSQL.

Successivamente, esegui il seguente comando per accedere a PostgreSQL con l’utente ‘ appuser ‘. Inserisci la tua password quando richiesto.

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

Dopo aver effettuato l’accesso, controlla lo stato della connessione PostgreSQL con il seguente comando:

\conninfo

Puoi vedere qui sotto che il nuovo utente ‘ appuser ‘ può connettersi al server PostgreSQL con l’autenticazione della password tramite localhost o 127.0.0.1.

Installazione di Ruby on Rails

In questa sezione, installerai l’ultima versione di Ruby on Rails nell’ambiente specifico per l’utente. Quindi devi impostare la directory predefinita GEM_HOME sotto il tuo utente.

Prima, accedi al tuo utente con il seguente comando:

su - user

Crea una nuova directory ~/.gem e aggiungi la variabile d’ambiente GEM_HOME attraverso il file ~/.bashrc. Con questo, tutti i gem Ruby saranno installati nella directory ~/.gem.

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

Ora esegui il comando qui sotto per ricaricare la tua shell attuale e controlla la variabile d’ambiente GEM_HOME. Vedrai che GEM_HOME punta alla directory ~/.gem.

source ~/.bashrc  
echo $GEM_HOME

Successivamente, esegui il comando gem qui sotto per installare il bundler nel tuo sistema.

gem install bundler

Dopo di che, installa Ruby on Rails con il seguente comando gem. Puoi installare l’ultima versione di Ruby on Rails o scegliere una versione specifica utilizzando l’opzione -v.

gem install rails  
gem install rails -v 7.1.0

Quando l’installazione è completata, controlla la versione di Ruby on Rails con il comando qui sotto:

rails --version  
rails --help

Come mostrato qui sotto, l’ultima versione di Ruby on Rails 7.1.3 è installata, e puoi anche vedere l’uso di base del comando ‘ rails ‘.

Creazione di un progetto con Ruby on Rails e PostgreSQL

Ora che hai installato Ruby on Rails. In questa sezione, creerai il tuo primo progetto Rails con PostgreSQL come database predefinito.

Esegui il comando ‘rails’ qui sotto per creare un nuovo progetto Rails. In questo esempio, creerai un nuovo progetto testapp con il database predefinito PostgreSQL.

rails new testapp -d postgresql

Puoi vedere qui sotto che l’applicazione Rails è stata generata, incluso il git inizializzato.

Ora spostati nella directory ~/testapp e modifica il file di configurazione del database ‘ config/database.yml ‘.

cd ~/testapp/  
nano config/database.yml

Cambia i dettagli del database per gli ambienti development, test e production come segue. Il database per ogni ambiente sarà creato automaticamente durante la migrazione.

development:  
 <<: *default  
 database: testapp_development  
 username: appuser  
 password: AppuserPassword  
 host: localhost  
 port: 5432  
  
test:  
 <<: *default  
 database: testapp_test  
 username: appuser  
 password: AppuserPassword  
 host: localhost  
 port: 5432  
  
production:  
 <<: *default  
 database: testapp_production  
 username: appuser  
 password: <%= ENV["TESTAPP_DATABASE_PASSWORD"] %>

Quando hai finito, salva il file ed esci.

Successivamente, esegui il seguente comando ‘ rails ‘ per impostare e migrare il database.

rails db:setup  
rails db:migrate

Dopo che la migrazione del database è completata, esegui il tuo progetto Rails con il seguente comando:

rails server -b 0.0.0.0

Puoi vedere qui sotto che il tuo progetto Rails è in esecuzione sulla porta predefinita 3000.

Visita l’indirizzo IP del tuo server http://192.168.5.30:3000/ utilizzando il tuo browser web. Se l’installazione di Rails è andata a buon fine, dovresti ottenere il seguente indice predefinito di Rails:

Generazione con Scaffolding

Ruby on Rails offre un modo semplice per costruire la tua applicazione per i principianti. Puoi utilizzare uno scaffold per generare la struttura di base di un progetto Rails, che include un controller, un modello e una vista.

Esegui il seguente comando per generare uno scaffold per una semplice applicazione ‘ site ‘ con due input utente ‘ name ‘ e ‘ url ‘.

rails g scaffold site name:string url:string

Qui sotto è il modello, il controller e la vista generati per la tua applicazione Rails.

Dopo che lo scaffold è stato generato, esegui il seguente comando per migrare il tuo database Rails.

rails db:migrate

Puoi vedere qui sotto che il database per Rails è stato migrato.

Ora esegui il tuo progetto Rails con il seguente comando.

rails server -b 0.0.0.0

Infine, visita l’indirizzo IP del tuo server http://192.168.5.30:3000/sites per accedere all’applicazione ‘ site ‘. Puoi inviare un nuovo nome e url dei dati. Poi, puoi vedere qui sotto un esempio dopo che i nuovi dati sono stati inviati.

Conclusione

Congratulazioni! Hai completato l’installazione di Ruby on Rails su Ubuntu 24.04. Hai creato un progetto Rails con PostgreSQL come database. Infine, hai anche imparato come generare applicazioni di base su Rails utilizzando la funzionalità di scaffold.