So installieren Sie Ruby on Rails auf Debian 12

Ruby on Rails oder RoR ist ein kostenloses und Open-Source-Webanwendungs-Framework, das in Ruby geschrieben und unter der MIT-Lizenz veröffentlicht wurde. Rails ist ein Full-Stack-Web-Framework, das es einfach macht, Anwendungen auf Unternehmensniveau zu erstellen. Rails wird mit verschiedenen Tools geliefert, die es Entwicklern ermöglichen, sowohl Frontend- als auch Backend-Anwendungen einfach zu erstellen. Ruby on Rails verfügt auch über integrierte Sicherheitsfunktionen wie Schutz vor häufigen Angriffen wie SQL-Injection, XSS und CSRF.

Ruby on Rails bietet eine Standardstruktur für die Datenbank, das Rendern von HTML-Vorlagen, einen Webdienst und eine Webseite. Es folgt der Architektur des Model-View-Controller (MVC) und verwendet auch bekannte Designphilosophien wie Don’t Repeat Yourself (DRY), Convention over Configuration (CoC) und das Active-Records-Muster. Ruby on Rails wurde entwickelt, um schnell und einfach zu verwenden und zu lernen zu sein. Einige bemerkenswerte Websites, die mit Rails entwickelt wurden, sind Twitch, Airbnb, Github, Soundcloud usw.

In diesem Leitfaden führen wir Sie durch die Installation von Ruby on Rails auf dem Debian 12-Server. Sie werden Ruby on Rails mit einem PostgreSQL-Datenbankserver und dem Rbenv Ruby-Version-Manager installieren. Sie werden auch ein Scaffold erstellen, die grundlegende Struktur des Rails-Projekts.

Voraussetzungen

Bevor Sie beginnen, bestätigen Sie, dass Sie Folgendes haben:

• Einen Debian 12-Server.
• Einen Nicht-Root-Benutzer mit sudo-Administratorrechten.

Abhängigkeiten installieren

Im ersten Schritt installieren Sie einige grundlegende Abhängigkeiten auf Ihrem Debian-Server. Dazu gehört der PostgreSQL-Datenbankserver, der als Datenbank für Ihr Rails-Projekt verwendet wird, Node.js und der Yarn-Paketmanager, der von Rails verwendet wird, um statische Assets zu kompilieren.

Um zu beginnen, aktualisieren und aktualisieren Sie Ihr Paket-Index, indem Sie den folgenden Befehl apt update ausführen.

sudo apt update

Als Nächstes installieren Sie die Abhängigkeiten mit dem folgenden Befehl apt install. Dazu gehören der PostgreSQL-Datenbankserver, der libpq-Treiber, Node.js, Yarn, Git und einige Systembibliotheken und -tools.

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

Geben Sie y ein, um zu bestätigen und mit der Installation fortzufahren.

Sobald die Abhängigkeiten installiert sind, überprüfen Sie den Status des PostgreSQL-Servers mit dem folgenden Befehl. Dies stellt sicher, dass PostgreSQL auf Ihrem Debian-Rechner läuft und aktiviert ist.

sudo systemctl is-enabled postgresql  
sudo systemctl status postgresql

Wenn PostgreSQL aktiviert ist, sollten Sie die Ausgabe enabled erhalten. Wenn PostgreSQL läuft, sollten Sie die Ausgabe active(running) oder active(exited) erhalten.

Überprüfen Sie schließlich Node.js und den Yarn-Paketmanager, indem Sie den folgenden Befehl ausführen.

node --version  
yarnpkg --version

In diesem Beispiel sind Node.js 18 und Yarn 1.22 installiert.

Rbenv installieren

Nachdem Sie die Paketabhängigkeiten installiert haben, besteht der nächste Schritt darin, Rbenv, den Ruby-Version-Manager für Unix-ähnliche Betriebssysteme, zu installieren. Mit Rbenv können Sie Ihre Ruby-Anwendungsumgebung einfach verwalten und mehrere Ruby-Versionen auf Ihrem System installieren.

Melden Sie sich mit dem folgenden Befehl bei Ihrem Benutzer an.

su - user

Laden Sie den rbenv-Quellcode und das ruby-build-Plugin über den folgenden git-Befehl herunter.

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

Führen Sie jetzt den folgenden Befehl aus, um einen benutzerdefinierten PATH zu Ihrer Shell hinzuzufügen.

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

Laden Sie Ihre ~/.bashrc-Konfiguration neu, um die Änderungen anzuwenden. Nach der Ausführung des Befehls sollte Ihre Rbenv-Installation aktiviert sein.

source ~/.bashrc

Überprüfen Sie Rbenv, indem Sie den folgenden Rbenv-Befehl ausführen. Wenn die Rbenv-Installation erfolgreich ist, sollten Sie verfügbare Rbenv-Befehle/Optionen sehen.

rbenv commands

Ruby über Rbenv installieren

Mit installiertem Rbenv können Sie jetzt Ruby auf Ihrem System installieren. Mit Rbenv installieren Sie Ruby nur in Ihrer aktuellen Umgebung, was das gesamte System nicht beeinflusst. Sie werden Ruby 3.2.2 in Ihrer aktuellen Benutzerumgebung installieren.

Führen Sie den Rbenv-Installationsbefehl unten aus, um Ruby 3.2.2 auf Ihrem System zu installieren.

rbenv install 3.2.2

Während der Installation sollten Sie Folgendes sehen:

Sobald Ruby installiert ist, führen Sie den folgenden Befehl aus, um die Standard-Ruby-Version auf 3.2.2 festzulegen.

rbenv global 3.2.2

Überprüfen Sie schließlich die Ruby-Version auf Ihrem System mit dem folgenden Befehl.

ruby -v

Wenn alles gut läuft, sollten Sie sehen, dass Ruby 3.2.2 installiert ist.

Ruby on Rails installieren

An diesem Punkt ist Ihr System konfiguriert und bereit, Ruby on Rails auf Ihrem Debian-Rechner zu installieren. In diesem Beispiel werden Sie Ruby on Rails 7.0 installieren und die Liste der verfügbaren Rails-Versionen auf der offiziellen Website überprüfen.

Führen Sie die folgenden gem-Befehle aus, um den Bundler zu installieren, und installieren Sie dann Ruby on Rails 7.0.7.2.

gem install bundler  
gem install rails -v 7.0.7.2

Während der Installation sollten Sie eine Ausgabe wie die folgende sehen:

Führen Sie jetzt den Rbenv-Befehl unten aus, um Ihre aktuelle Umgebung neu zu hashen und neu zu laden.

rbenv rehash

Führen Sie schließlich den Rails-Befehl unten aus, um sicherzustellen, dass Ruby on Rails installiert ist.

rails version  
rails -h

Wenn die Installation erfolgreich ist, sollten Sie Ihre aktuelle Rails-Version und die Hilfeseite des Rails-Befehls sehen.

Erstes Rails-Projekt erstellen

In diesem Abschnitt lernen Sie, wie Sie Ihr erstes Projekt mit Ruby on Rails erstellen. Sie werden PostgreSQL als Standarddatenbank für Ihr Rails-Projekt verwenden. Um dies zu erreichen, müssen Sie Folgendes abschließen:

• Vorbereiten des PostgreSQL-Benutzers für die Anwendung.
• Erstellen des ersten Rails-Projekts.

Datenbankbenutzer vorbereiten

Zuerst müssen Sie einen neuen PostgreSQL-Benutzer erstellen, der für Ihre Rails-Anwendung verwendet wird. Dieser Benutzer muss Berechtigungen zum Erstellen von Datenbanken und Benutzern haben.

Wechseln Sie zurück zu Ihrem Benutzerkonto und melden Sie sich mit dem folgenden Befehl beim PostgreSQL-Server an.

sudo su  
sudo -u postgres psql

Erstellen Sie nun einen neuen Benutzer bob mit dem Passwort p4sswordbob. Weisen Sie dann dem Benutzer bob neue Berechtigungen zum Erstellen einer Datenbank und von Rollen zu.

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

Überprüfen Sie die Liste der Benutzer und Berechtigungen auf Ihrem PostgreSQL-Server mit dem folgenden Befehl.

du

Sie sollten den Benutzer bob mit den Berechtigungen CREATEDB und CREATEROLE sehen.

Geben Sie \q ein, um sich vom PostgreSQL-Server abzumelden.

Melden Sie sich schließlich bei Ihrem Benutzer an und führen Sie den folgenden psql-Befehl aus, um sich als neuer Benutzer bob beim PostgreSQL-Server anzumelden.

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

Sobald Sie mit dem PostgreSQL-Server verbunden sind, führen Sie die folgende Abfrage aus, um Ihre Verbindungsinformationen zu überprüfen.

\conninfo

Sie sollten sehen, dass Sie sich als Benutzer bob mit dem PostgreSQL-Server verbunden haben.

Geben Sie \q ein, um den PostgreSQL-Server zu verlassen.

Rails-Projekt erstellen

Nachdem Sie einen PostgreSQL-Benutzer erstellt haben, können Sie jetzt ein neues Rails-Projekt über das Rails-Befehlszeilen-Utility erstellen.

Um ein neues Rails-Projekt zu erstellen, führen Sie den folgenden Rails-Befehl aus. In diesem Beispiel werden Sie ein neues Projekt testapp mit der Standarddatenbank PostgreSQL erstellen.

rails new testapp -d postgresql

Die Ausgabe des Befehls sollte wie folgt aussehen:

Nachdem das Projekt erstellt wurde, wird auch das neue Verzeichnis ~/testapp erstellt. Wechseln Sie in das Verzeichnis ~/testapp und öffnen Sie die Datenbankkonfiguration config/database.yml mit Ihrem bevorzugten Texteditor.

cd testapp/  
nano config/database.yml

Ändern Sie die Standardeinstellungen der Datenbank für Entwicklung, Test und Produktion. Stellen Sie sicher, dass Sie Ihren PostgreSQL-Benutzernamen und Ihr Passwort eingeben.

development:  
  <<: *default  
  database: testapp_development  
  
  # Die angegebene Datenbankrolle wird verwendet, um sich mit postgres zu verbinden.  
  # Um zusätzliche Rollen in postgres zu erstellen, siehe `$ createuser --help`.  
  # Wenn leer gelassen, verwendet postgres die Standardrolle. Dies ist  
  # derselbe Name wie der Betriebssystembenutzer, der Rails ausführt.  
  username: bob  
  
  # Das Passwort, das mit der postgres-Rolle (Benutzername) verknüpft ist.  
  password: p4sswordbob  
  
  # Über TCP-Socket verbinden. Standardmäßig weggelassen, da der Client ein  
  # Domain-Socket verwendet, das keine Konfiguration benötigt. Windows hat keine  
  # Domain-Sockets, also kommentieren Sie diese Zeilen aus.  
  host: localhost  
  
  # Der TCP-Port, auf dem der Server lauscht. Standardmäßig 5432.  
  # Wenn Ihr Server auf einer anderen Portnummer läuft, ändern Sie dies entsprechend.  
  port: 5432

Speichern Sie die Datei und beenden Sie sie, wenn Sie fertig sind.

Führen Sie jetzt den Rails-Befehl unten aus, um die Datenbank zu migrieren. Dies erstellt automatisch eine neue Datenbank für Ihr testapp-Projekt.

rails db:setup  
rails db:migrate

Unten sollten Sie die Ausgabe während der Datenbankmigration des testapp-Projekts sehen.

Nachdem die Datenbank migriert wurde, führen Sie den Rails-Befehl unten aus, um das testapp-Projekt auszuführen. Dies wird testapp innerhalb Ihrer IP-Adresse auf Port 3000 ausführen.

rails server -b 192.168.10.15

In der folgenden Ausgabe sollten Sie sehen, dass testapp läuft.

Starten Sie jetzt Ihren bevorzugten Webbrowser und besuchen Sie Ihre Server-IP-Adresse, gefolgt von Port 3000, z. B. http://192.168.10.15:3000/. Wenn Ihre Installation erfolgreich ist, sollten Sie die Standardseite index.html von Ruby on Rails sehen.

Drücken Sie Ctrl+c, um Ihre Rails-Anwendung zu beenden.

Rails Scaffolding für Starter Kit

Ein Scaffold ist eine automatische Möglichkeit, die grundlegende Struktur eines Rails-Projekts zu generieren, die einen Controller, ein Modell und eine Ansicht umfasst.

Führen Sie den Rails-Befehl unten aus, um ein Scaffold books mit drei Feldern title, author und publication_year zu erstellen.

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

Migrieren Sie jetzt die Datenbank, um die Änderungen mit dem Rails-Befehl unten anzuwenden.

rails db:migrate

Führen Sie als Nächstes Ihr Rails-Projekt aus, indem Sie den Rails-Server-Befehl unten ausführen.

rails server -b 192.168.10.15

Sobald testapp läuft, überprüfen Sie das Books-Scaffold über den URL-Pfad /books, z. B. http://192.168.10.15:3000/books. Wenn alles gut läuft, sollten Sie das generierte Scaffold wie folgt sehen:

Sie können jetzt neue Daten in das Books-Scaffold eingeben, wie folgt:

Fazit

Zusammenfassend haben Sie die Installation von Ruby on Rails mit dem PostgreSQL-Datenbankserver und Rbenv auf dem Debian 12-Server abgeschlossen. Sie haben auch gelernt, wie man Scaffolds für grundlegende Strukturen für das Rails-Projekt generiert.