Come installare Ruby on Rails su Debian 12

Ruby on Rails o RoR è un framework per applicazioni web gratuito e open-source scritto in Ruby e rilasciato sotto la licenza MIT. Rails è un framework web full-stack per costruire facilmente applicazioni di livello enterprise. Rails è fornito con diversi strumenti che consentono agli sviluppatori di creare facilmente sia applicazioni frontend che backend. Ruby on Rails ha anche funzionalità di sicurezza integrate come la protezione contro attacchi comuni come SQL injection, XSS e CSRF.

Ruby on Rails fornisce una struttura predefinita per il database, il rendering di modelli HTML, un servizio web e una pagina web. Segue l’architettura model-view-controller (MVC) e utilizza anche filosofie di design ben note come Non Ripeterti (DRY), Convenzione su Configurazione (CoC) e pattern di record attivi. Ruby on Rails è stato progettato per essere veloce e facile da usare e da apprendere. Alcuni siti notevoli sviluppati con Rails includono Twitch, Airbnb, Github, Soundcloud, ecc.

In questa guida, ti guideremo attraverso l’installazione di Ruby on Rails sul server Debian 12. Installerai Ruby on Rails con un server di database PostgreSQL e il gestore di versioni Ruby Rbenv. Creerai anche uno scaffold, la struttura di base del progetto Rails.

Prerequisiti

Prima di iniziare, conferma di avere:

• Un server Debian 12.
• Un utente non root con privilegi di amministratore sudo.

Installazione delle dipendenze

Nel primo passaggio, installerai alcune dipendenze di base sul tuo server Debian. Questo include il server di database PostgreSQL che sarà utilizzato come database per il tuo progetto Rails, node.js e il gestore di pacchetti Yarn che sarà utilizzato da Rails per compilare risorse statiche.

Per iniziare, aggiorna e aggiorna l’indice dei pacchetti eseguendo il comando apt update qui sotto.

sudo apt update

Successivamente, installa le dipendenze utilizzando il seguente comando apt install. Questo include il server di database PostgreSQL, il driver libpq, Node.js, Yarn, Git e alcune librerie e strumenti di sistema.

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

Digita y per confermare e procedere con l’installazione.

Una volta installate le dipendenze, controlla lo stato del server PostgreSQL utilizzando il seguente comando. Questo garantirà che PostgreSQL sia in esecuzione e abilitato sulla tua macchina Debian.

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

Se PostgreSQL è abilitato, dovresti ottenere l’output abilitato. Quando PostgreSQL è in esecuzione, dovresti ottenere l’output attivo(in esecuzione) o attivo(uscito).

Infine, controlla il gestore di pacchetti Node.js e Yarn eseguendo il comando qui sotto.

node --version  
yarnpkg --version

In questo esempio, Node.js 18 e Yarn 1.22 sono installati.

Installazione di Rbenv

Dopo aver installato le dipendenze dei pacchetti, il passaggio successivo è installare Rbenv, il gestore di versioni Ruby per sistemi operativi simili a Unix. Con Rbenv, puoi gestire facilmente l’ambiente delle tue app Ruby e installare più versioni di Ruby sul tuo sistema.

Accedi al tuo Utente utilizzando il seguente comando.

su - user

Scarica il codice sorgente di rbenv e il plugin ruby-build tramite il comando git qui sotto.

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

Ora esegui il seguente comando per aggiungere un PATH personalizzato alla tua 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

Ricarica la tua configurazione ~/.bashrc per applicare le modifiche. Dopo aver eseguito il comando, la tua installazione di rbenv dovrebbe essere attivata.

source ~/.bashrc

Verifica rbenv eseguendo il comando rbenv qui sotto. Se l’installazione di rbenv è riuscita, dovresti vedere i comandi/opzioni rbenv disponibili.

rbenv commands

Installazione di Ruby tramite Rbenv

Con Rbenv installato, ora puoi installare Ruby sul tuo sistema. Con Rbenv, installerai Ruby solo nel tuo ambiente attuale, senza influenzare l’intero sistema. Installerai Ruby 3.2.2 nel tuo ambiente utente attuale.

Esegui il comando rbenv install qui sotto per installare Ruby 3.2.2 sul tuo sistema.

rbenv install 3.2.2

Durante l’installazione, dovresti vedere questo:

Una volta installato Ruby, esegui il seguente comando per impostare la versione predefinita di Ruby su 3.2.2.

rbenv global 3.2.2

Infine, verifica la versione di Ruby sul tuo sistema utilizzando il comando qui sotto.

ruby -v

Se tutto va bene, dovresti vedere Ruby 3.2.2 installato.

Installazione di Ruby on Rails

A questo punto, il tuo sistema è configurato e pronto per installare Ruby on Rails sulla tua macchina Debian. In questo esempio, installerai Ruby on Rails 7.0 e controllerai l’elenco delle versioni disponibili di Rails sul sito ufficiale.

Esegui i comandi gem qui sotto per installare il bundler, quindi installa Ruby on Rails 7.0.7.2.

gem install bundler  
gem install rails -v 7.0.7.2

Durante l’installazione, dovresti vedere un output simile al seguente:

Ora esegui il comando rebenv qui sotto per rehash e ricaricare il tuo ambiente attuale.

rbenv rehash

Infine, esegui il comando rails qui sotto per assicurarti che Ruby on Rails sia installato.

rails version  
rails -h

Se l’installazione ha avuto successo, dovresti vedere la tua versione attuale di Rails e la pagina di aiuto del comando rails.

Creazione del primo progetto Rails

In questa sezione, imparerai come creare il tuo primo progetto con Ruby on Rails. Utilizzerai PostgreSQL come database predefinito per il tuo progetto Rails. Per raggiungere questo obiettivo, devi completare i seguenti passaggi:

• Preparare l’utente PostgreSQL per l’applicazione.
• Creare il primo progetto Rails.

Preparare l’utente del database

Per prima cosa, devi creare un nuovo utente PostgreSQL che sarà utilizzato per la tua applicazione Rails. Questo utente deve avere privilegi per creare database e utenti.

Torna al tuo account utente e accedi al server PostgreSQL utilizzando il comando qui sotto.

sudo su  
sudo -u postgres psql

Ora crea un nuovo utente bob con la password p4sswordbob. Quindi, assegna nuovi privilegi per creare un database e ruoli all’utente bob.

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

Verifica l’elenco degli utenti e dei privilegi sul tuo server PostgreSQL utilizzando il comando qui sotto.

\du

Dovresti vedere l’utente bob con privilegi CREATEDB e CREATEROLE.

Digita \q per disconnetterti dal server PostgreSQL.

Infine, accedi al tuo utente ed esegui il seguente comando psql per accedere al server PostgreSQL come nuovo utente bob.

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

Una volta connesso al server PostgreSQL, esegui la seguente query per verificare le tue informazioni di connessione.

\conninfo

Dovresti vedere che ti sei connesso al server PostgreSQL come utente bob.

Digita \q per uscire dal server PostgreSQL.

Creazione del progetto Rails

Dopo aver creato un utente PostgreSQL, ora puoi iniziare a creare un nuovo progetto Rails tramite l’utilità da riga di comando rails.

Per creare un nuovo progetto rails, esegui il comando rails qui sotto. In questo esempio, creerai un nuovo progetto testapp con il database predefinito PostgreSQL.

rails new testapp -d postgresql

L’output del comando dovrebbe apparire così:

Dopo che il progetto è stato creato, verrà creata anche la nuova directory ~/testapp. Spostati nella directory ~/testapp e apri la configurazione del database config/database.yml utilizzando il tuo editor di testo preferito.

cd testapp/  
nano config/database.yml

Modifica le impostazioni del database predefinito per sviluppo, test e produzione. Assicurati di inserire il tuo nome utente e la tua password PostgreSQL.

development:  
  <<: *default  
  database: testapp_development  
  
  # Il ruolo del database specificato viene utilizzato per connettersi a postgres.  
  # Per creare ruoli aggiuntivi in postgres vedere `$ createuser --help`.  
  # Quando lasciato vuoto, postgres utilizzerà il ruolo predefinito. Questo è  
  # lo stesso nome dell'utente del sistema operativo che esegue Rails.  
  username: bob  
  
  # La password associata al ruolo postgres (nome utente).  
  password: p4sswordbob  
  
  # Connetti su un socket TCP. Omitto per impostazione predefinita poiché il client utilizza un  
  # socket di dominio che non richiede configurazione. Windows non ha  
  # socket di dominio, quindi decommenta queste righe.  
  host: localhost  
  
  # La porta TCP su cui il server ascolta. Predefinito a 5432.  
  # Se il tuo server gira su un numero di porta diverso, cambia di conseguenza.  
  port: 5432

Salva e chiudi il file quando hai finito.

Ora esegui il comando rails qui sotto per migrare il database. Questo creerà automaticamente un nuovo database per il tuo progetto testapp.

rails db:setup  
rails db:migrate

Di seguito dovresti vedere l’output durante la migrazione del database del progetto testapp.

Dopo che il database è stato migrato, esegui il comando rails qui sotto per eseguire il progetto testapp. Questo eseguirà testapp all’interno del tuo indirizzo IP sulla porta 3000.

rails server -b 192.168.10.15

Nell’output seguente, dovresti vedere che testapp è in esecuzione.

Ora avvia il tuo browser web preferito e visita il tuo indirizzo IP del server seguito dalla porta 3000, come http://192.168.10.15:3000/. Se la tua installazione ha avuto successo, dovresti vedere la pagina index.html predefinita di Ruby on Rails.

Premi Ctrl+c per terminare la tua applicazione Rails.

Scaffolding di Rails per il kit di avviamento

Uno scaffold è un modo automatico per generare la struttura di base di un progetto Rails, che include un controller, un modello e una vista.

Esegui il comando rails qui sotto per creare uno scaffold books con tre campi title, author e publication_year.

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

Ora migra il database per applicare le modifiche utilizzando il comando rails qui sotto.

rails db:migrate

Successivamente, esegui il tuo progetto Rails eseguendo il comando server rails qui sotto.

rails server -b 192.168.10.15

Una volta che testapp è in esecuzione, controlla lo scaffold dei libri tramite il percorso URL /books, come http://192.168.10.15:3000/books. Se tutto va bene, dovresti vedere lo scaffold generato come segue:

Ora puoi inserire nuovi dati nello scaffold dei libri come segue:

Conclusione

In conclusione, hai completato l’installazione di Ruby on Rails con il server di database PostgreSQL e Rbenv sul server Debian 12. Hai anche imparato come generare scaffolds per le strutture di base per il progetto Rails.