Wie man Ruby on Rails unter Ubuntu 24.04 installiert

Ruby on Rails (RoR oder Rails) ist ein Ruby-Webanwendungs-Framework mit MVC-Architektur (Model-View-Controller) und Designphilosophien wie Don’t Repeat Yourself (DRY), Convention over Configuration (CoC) und Active Records Pattern. Es ist ein vollwertiges Web-Framework für die Entwicklung von Webanwendungen für Unternehmen.

In diesem Lernprogramm führen wir dich durch die Installation von Ruby on Rails auf Ubuntu 24.04, die Erstellung des ersten Rails-Projekts, die Konfiguration von PostgreSQL als Datenbank für dein Rails-Projekt und die Erstellung eines Gerüsts mit dem Befehl „rails“.

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du Folgendes hast:

• Einen Ubuntu 24.04 Server.
• Einen Nicht-Root-Benutzer mit sudo-Administrator-Rechten.

Installieren der Abhängigkeiten

Um Ruby on Rails auf deinem Ubuntu-System zu installieren, musst du Abhängigkeiten wie Ruby, Node.js, PostgreSQL (optional für die Datenbank), Git und zusätzliche Entwicklungspakete installieren. Diese Pakete sind im Standard-Repository von Ubuntu verfügbar, und du kannst sie mit APT installieren.

Um zu beginnen, aktualisiere dein Ubuntu-Repository mit dem folgenden Befehl:

sudo apt update

Installiere nun die Abhängigkeiten für Ruby on Rails mit dem folgenden Befehl. Damit installierst du Ruby, PostgreSQL, Node.js, Git und einige Entwicklerpakete.

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

Gib Y ein, um mit der Installation fortzufahren.

Nachdem die Installation abgeschlossen ist, überprüfe die Ruby- und Node.js-Version mit folgendem Befehl:

ruby -v
node -v

Du siehst unten, dass Ruby 3.2 und Node.js 18.19 installiert sind.

Als nächstes führst du den folgenden Befehl aus, um Yarn als Node.js-Paketmanager einzurichten. Dadurch wird ein neuer Befehl„yarn“ erstellt und du siehst die Version von Yarn.

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

Überprüfe abschließend den Status des PostgreSQL-Dienstes mit folgendem Befehl:

sudo systemctl is-enabled postgresql
sudo systemctl status postgresql

Der PostgreSQL-Server wird beim Start gestartet und der PostgreSQL-Status mit„active (exited)„.

PostgreSQL-Benutzer anlegen

Nachdem die Abhängigkeiten installiert sind, musst du einen neuen PostgreSQL-Benutzer für dein Rails-Projekt erstellen. Dieser Benutzer muss in der Lage sein, sich anzumelden und eine neue Datenbank auf PostgreSQL zu erstellen.

Melde dich mit dem unten stehenden Befehl am PostgreSQL-Server an.

sudo -u postgres psql

Führe die folgenden Abfragen aus, um einen neuen PostgreSQL-Benutzer„appuser“ mit dem Passwort„AppuserPassword“ zu erstellen. Dieser Benutzer wird in der Lage sein, eine Datenbank und eine Rolle in PostgreSQL zu erstellen.

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

Gib nun quit ein oder drücke Strg+d, um PostgreSQL zu verlassen.

Als Nächstes führst du den folgenden Befehl aus, um dich mit dem Benutzer„appuser“ bei PostgreSQL anzumelden. Gib dein Passwort ein, wenn du dazu aufgefordert wirst.

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

Nachdem du dich angemeldet hast, überprüfe den PostgreSQL-Verbindungsstatus mit folgendem Befehl:

\conninfo

Wie du unten siehst, kann sich der neue Benutzer„appuser“ mit der Passwortauthentifizierung über localhost oder 127.0.0.1 mit dem PostgreSQL-Server verbinden.

Installation von Ruby on Rails

In diesem Abschnitt installierst du das neueste Ruby on Rails in der benutzerspezifischen Umgebung. Daher musst du das Standardverzeichnis GEM_HOME unter deinem Benutzer einrichten.

Melde dich zunächst mit folgendem Befehl bei deinem Benutzer an:

su - user

Erstelle ein neues Verzeichnis ~/.gem und füge die Umgebungsvariable GEM_HOME über die Datei ~/.bashrc hinzu. Damit werden alle Ruby-Gems im Verzeichnis ~/.gem installiert.

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

Führe nun den folgenden Befehl aus, um deine aktuelle Shell neu zu laden und die Umgebungsvariable GEM_HOME zu überprüfen. Du wirst sehen, dass GEM_HOME auf das Verzeichnis ~/.gem verweist.

source ~/.bashrc
echo $GEM_HOME

Als Nächstes führst du den unten stehenden gem-Befehl aus, um den Bundler auf deinem System zu installieren.

gem install bundler

Danach installierst du Ruby on Rails mit dem folgenden gem-Befehl. Du kannst die neueste Version von Ruby on Rails installieren oder eine bestimmte Version mit der Option -v auswählen.

gem install rails
gem install rails -v 7.1.0

Wenn die Installation abgeschlossen ist, überprüfe die Ruby on Rails-Version mit dem folgenden Befehl:

rails --version
rails --help

Wie unten zu sehen ist, ist die neueste Version von Ruby on Rails 7.1.3 installiert, und du kannst auch die grundlegende Verwendung des Befehls„rails“ sehen.

Projekt mit Ruby on Rails und PostgreSQL erstellen

Jetzt hast du Ruby on Rails installiert. In diesem Abschnitt wirst du dein erstes Rails-Projekt mit PostgreSQL als Standarddatenbank erstellen.

Führe den Befehl „rails“ aus, um ein neues Rails-Projekt zu erstellen. In diesem Beispiel wirst du ein neues Projekt testapp mit der Standarddatenbank PostgreSQL erstellen.

rails new testapp -d postgresql

Unten siehst du, wie die Rails-Anwendung erstellt wird, einschließlich der Initialisierung von git.

Wechsle nun in das Verzeichnis ~/testapp und bearbeite die Datenbankkonfigurationsdatei„config/database.yml„.

cd ~/testapp/
nano config/database.yml

Ändere die Datenbankdetails für die Entwicklungs-, Test- und Produktionsumgebung wie folgt. Die Datenbank für jede Umgebung wird während der Migration automatisch erstellt.

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"] %>

Wenn du fertig bist, speichere die Datei und beende sie.

Als Nächstes führst du den folgenden„rails„-Befehl aus, um die Datenbank einzurichten und zu migrieren.

rails db:setup
rails db:migrate

Nachdem die Datenbankmigration abgeschlossen ist, führe dein Rails-Projekt mit folgendem Befehl aus:

rails server -b 0.0.0.0

Unten siehst du, dass dein Rails-Projekt auf dem Standardport 3000 läuft.

Rufe die IP-Adresse deines Servers http://192.168.5.30:3000/ mit deinem Webbrowser auf. Wenn deine Rails-Installation erfolgreich war, solltest du den folgenden Standard-Rails-Index erhalten:

Generieren mit Scaffolding

Ruby on Rails bietet Anfängern eine einfache Möglichkeit, ihre Anwendung zu erstellen. Du kannst ein Scaffold verwenden, um die Grundstruktur eines Rails-Projekts zu erstellen, das einen Controller, ein Model und eine View enthält.

Führe den folgenden Befehl aus, um ein Gerüst für eine einfache Anwendung„site“ mit zwei Benutzereingaben„name“ und„url“ zu erstellen.

rails g scaffold site name:string url:string

Unten siehst du das Model, den Controller und die View deiner Anwendung, die Rails generiert.

Nachdem das Gerüst erstellt wurde, führe den folgenden Befehl aus, um deine Rails-Datenbank zu migrieren.

rails db:migrate

Unten siehst du, dass die Datenbank für Rails migriert wurde.

Starte nun dein Rails-Projekt mit dem folgenden Befehl.

rails server -b 0.0.0.0

Rufe schließlich deine Server-IP-Adresse http://192.168.5.30:3000/sites auf, um auf die Anwendung„site“ zuzugreifen. Du kannst einen neuen Datennamen und eine neue URL eingeben. Unten siehst du ein Beispiel, nachdem die neuen Daten übermittelt wurden.

Fazit

Herzlichen Glückwunsch! Du hast die Installation von Ruby on Rails auf Ubuntu 24.04 abgeschlossen. Du hast ein Rails-Projekt mit PostgreSQL als Datenbank erstellt. Außerdem hast du gelernt, wie du mit dem Scaffold-Feature einfache Anwendungen auf Rails erstellen kannst.