Ruby on Rails mit rbenv auf Ubuntu 22.04 installieren – Anleitung

Ruby on Rails ist eines der beliebtesten Frameworks für Entwickler, die Websites und Webanwendungen erstellen möchten. Die Programmiersprache Ruby, kombiniert mit dem Rails-Entwicklungsframework, ermöglicht es Ihnen, skalierbare Anwendungen schnell zu erstellen und bereitzustellen.

Sie können Ruby und Rails mit dem Kommandozeilen-Tool rbenv installieren. Mit rbenv erhalten Sie eine stabile Umgebung für die Entwicklung Ihrer Ruby-on-Rails-Anwendungen und können zwischen verschiedenen Ruby-Versionen wechseln, sodass Ihr gesamtes Team dieselbe Version verwendet. rbenv bietet außerdem Unterstützung für anwendungsspezifische Versionen von Ruby, erlaubt die globale Änderung der Ruby-Version für jeden Benutzer und die Möglichkeit, eine Umgebungsvariable zu verwenden, um die Ruby-Version zu überschreiben.

In diesem Tutorial werden Sie die Installationsprozesse von Ruby und Rails mit rbenv und gem durchlaufen. Zuerst installieren Sie die erforderlichen Pakete, um rbenv und dann Ruby zu installieren. Danach installieren Sie das Plugin ruby-build, um verfügbare Versionen von Ruby zu installieren. Schließlich verwenden Sie gem, um Rails zu installieren, und können dann Ruby on Rails nutzen, um mit der Webentwicklung zu beginnen. Sie lernen auch, wie Sie überprüfen können, ob Ihre rbenv-Version aktuell ist, und wie Sie Ruby-Versionen und rbenv deinstallieren.

Voraussetzungen

Um diesem Tutorial zu folgen, benötigen Sie:

• Einen Ubuntu 22.04-Server, der eingerichtet wurde, einschließlich eines sudo-Benutzers ohne Root-Rechte und einer Firewall.
• Node.js, installiert über das offizielle PPA. Einige Rails-Funktionen, wie die Asset Pipeline, erfordern eine JavaScript-Laufzeitumgebung. Node.js bietet diese Funktionalität.

Schritt 1 – Installation von rbenv und Abhängigkeiten

Ruby basiert auf mehreren Paketen, die Sie über Ihren Paketmanager installieren können. Sobald diese installiert sind, können Sie rbenv installieren und verwenden, um Ruby zu installieren.

Aktualisieren Sie zuerst Ihre Paketliste:

sudo apt update

Installieren Sie anschließend die für die Installation von Ruby erforderlichen Abhängigkeiten:

sudo apt install git curl libssl-dev libreadline-dev zlib1g-dev autoconf bison build-essential libyaml-dev libreadline-dev libncurses5-dev libffi-dev libgdbm-dev

Nach der Installation der Abhängigkeiten können Sie rbenv selbst installieren. Verwenden Sie curl, um das Installationsskript von Github abzurufen, und leiten Sie es direkt an bash weiter, um den Installer auszuführen:

curl -fsSL https://github.com/rbenv/rbenv-installer/raw/HEAD/bin/rbenv-installer | bash

Fügen Sie als Nächstes ~/.rbenv/bin zu Ihrem $PATH hinzu, damit Sie das rbenv-Kommandozeilenprogramm verwenden können. Bearbeiten Sie dazu Ihre Datei ~/.bashrc, damit die Änderungen zukünftige Anmeldesitzungen betreffen:

echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc

Fügen Sie dann den Befehl eval "$(rbenv init -)" zu Ihrer Datei ~/.bashrc hinzu, damit rbenv automatisch geladen wird:

echo 'eval "$(rbenv init -)"' >> ~/.bashrc

Wenden Sie anschließend die Änderungen, die Sie an Ihrer Datei ~/.bashrc vorgenommen haben, auf Ihre aktuelle Shell-Sitzung an:

source ~/.bashrc

Überprüfen Sie, ob rbenv ordnungsgemäß eingerichtet ist, indem Sie den Befehl type ausführen. Dieser zeigt weitere Informationen über den rbenv-Befehl an:

type rbenv

Ihr Terminalfenster zeigt die folgende Ausgabe an:

rbenv is a function
{
    local command;
    command="${1:-}";
    if [ "$#" -gt 0 ]; then
        shift;
    };
    case "$command" in
        rehash | shell)
            eval "$(rbenv "sh-$command" "$@")"
        ;;
        *)
            command rbenv "$command" "$@"
        ;;
    esac
}

An diesem Punkt haben Sie sowohl rbenv als auch das Plugin ruby-build installiert. Als nächstes werden Sie Ruby installieren.

Schritt 2 – Ruby mit ruby-build installieren

Mit dem Plugin ruby-build können Sie alle benötigten Ruby-Versionen mit einem einzigen Befehl installieren. Listen Sie zuerst alle verfügbaren Ruby-Versionen auf:

rbenv install -l

Die Ausgabe dieses Befehls listet alle verfügbaren Versionen auf, die Sie installieren können:

2.7.7
3.0.5
3.1.3
3.2.0
jruby-9.4.0.0
mruby-3.1.0
picoruby-3.0.0
truffleruby-22.3.1
truffleruby+graalvm-22.3.1

Installieren Sie jetzt Ruby 3.2.0:

rbenv install 3.2.0

Die Installation von Ruby kann etwas Zeit in Anspruch nehmen, seien Sie also geduldig.

Sobald die Installation abgeschlossen ist, legen Sie diese Version als Standardversion für Ruby mit dem Befehl global fest:

rbenv global 3.2.0

Überprüfen Sie, ob Ruby korrekt installiert wurde, indem Sie die Versionsnummer abfragen:

ruby -v

Wenn Sie die Version 3.2.0 von Ruby installiert haben, gibt dieser Befehl eine Ausgabe wie diese zurück:

ruby 3.2.0 (2022-12-25 revision a528908271) [x86_64-linux]

Sie haben nun mindestens eine Version von Ruby installiert und diese als Standardversion festgelegt. Als nächstes richten Sie Gems und Rails ein.

Schritt 3 – Arbeiten mit Gems

Gems sind die Methode, mit der Ruby-Bibliotheken verteilt werden. Sie verwenden den gem-Befehl, um diese Gems zu verwalten, und installieren Rails mit diesem Befehl.

Bei der Installation eines Gems wird standardmäßig lokale Dokumentation generiert. Dies kann die Installationszeit für jedes Gem erheblich verlängern. Deaktivieren Sie die Generierung lokaler Dokumentation, indem Sie eine Datei namens ~/.gemrc erstellen, die eine Konfigurationseinstellung enthält, um diese Funktion zu deaktivieren:

echo "gem: --no-document" > ~/.gemrc

Bundler ist ein Tool, das Gem-Abhängigkeiten für Projekte verwaltet. Installieren Sie als nächstes das Bundler-Gem, da Rails davon abhängig ist:

gem install bundler

Sie erhalten die folgende Ausgabe:

Fetching bundler-2.4.5.gem
Successfully installed bundler-2.4.5
1 gem installed

Verwenden Sie den Befehl gem env (das Unterkommando env steht für Umgebung), um mehr über die Umgebung und Konfiguration von Gems zu erfahren. Sie können bestätigen, wo Gems installiert werden, indem Sie das Argument home verwenden:

gem env home

Sie erhalten eine Ausgabe ähnlich der folgenden:

/home/benutzer/.rbenv/versions/3.2.0/lib/ruby/gems/3.2.0

Nachdem Sie Gems eingerichtet haben, können Sie Rails installieren.

Schritt 4 – Installation von Rails

Um Rails zu installieren, verwenden Sie den Befehl gem install zusammen mit der -v-Flagge, um die Version anzugeben. Für dieses Tutorial verwenden Sie Version 7.0.4:

gem install rails -v 7.0.4

Der Befehl gem installiert das angegebene Gem sowie alle Abhängigkeiten. Rails ist ein komplexes Webentwicklungs-Framework mit vielen Abhängigkeiten, daher wird die Installation einige Zeit in Anspruch nehmen. Schließlich erhalten Sie eine Meldung, dass Rails zusammen mit seinen Abhängigkeiten installiert wurde:

...
Successfully installed rails-7.0.4
35 gems installed

Hinweis: Wenn Sie eine andere Version von Rails installieren möchten, können Sie mit dem folgenden Befehl die gültigen Versionen durchsuchen. Dies gibt eine Liste möglicher Versionen aus. Sie können dann eine bestimmte Version installieren, z. B. 4.2.7:

gem search '^rails$' --all
gem install rails -v 4.2.7

Wenn Sie die neueste Version von Rails installieren möchten, führen Sie den Befehl ohne Versionsangabe aus:

gem install rails

rbenv erstellt ein Verzeichnis mit sogenannten Shims, die auf die Dateien verweisen, die von der aktuell aktivierten Ruby-Version verwendet werden. Über das Unterkommando rehash aktualisiert rbenv die Shims in diesem Verzeichnis, sodass sie mit jedem Ruby-Befehl übereinstimmen, der in jeder installierten Version von Ruby auf Ihrem Server verfügbar ist. Jedes Mal, wenn Sie eine neue Version von Ruby oder ein Gem installieren, das wie Rails Befehle bereitstellt, sollten Sie den folgenden Befehl ausführen:

rbenv rehash

Überprüfen Sie, ob Rails ordnungsgemäß installiert wurde, indem Sie die Version mit dem folgenden Befehl abfragen:

rails -v

Wenn Rails korrekt installiert wurde, gibt der folgende Befehl die installierte Version von Rails zurück:

Rails 7.0.4

Schritt 5 – Aktualisierung von rbenv

Da Sie rbenv manuell mit Git installiert haben, können Sie Ihre Installation jederzeit mit dem git pull-Befehl im Verzeichnis ~/.rbenv auf die neueste Version aktualisieren:

cd ~/.rbenv
git pull

Damit stellen Sie sicher, dass Sie die aktuellste Version von rbenv verwenden.

Schritt 6 – Deinstallation von Ruby-Versionen

Wenn Sie zusätzliche Versionen von Ruby herunterladen, können sich im Verzeichnis ~/.rbenv/versions mehr Versionen ansammeln, als Sie benötigen. Verwenden Sie das Unterkommando uninstall des Plugins ruby-build, um diese vorherigen Versionen zu entfernen.

Der folgende Befehl deinstalliert Ruby Version 3.2.0:

rbenv uninstall 3.2.0

Mit dem Befehl rbenv uninstall können Sie alte Versionen von Ruby entfernen, sodass Sie nicht mehr Versionen installiert haben, als Sie derzeit verwenden.

Schritt 7 – Deinstallation von rbenv

Falls Sie sich entscheiden, rbenv nicht mehr zu verwenden, können Sie es von Ihrem System entfernen.

Öffnen Sie dazu Ihre Datei ~/.bashrc in Ihrem bevorzugten Texteditor. In diesem Beispiel verwenden wir nano:

nano ~/.bashrc

Suchen und entfernen Sie die folgenden zwei Zeilen aus der Datei:

export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"

Speichern Sie nach dem Entfernen dieser Zeilen die Datei und schließen Sie den Editor. Wenn Sie nano verwendet haben, können Sie den Editor mit CTRL + X, dann Y und ENTER verlassen.

Entfernen Sie dann rbenv und alle installierten Ruby-Versionen mit folgendem Befehl:

rm -rf `rbenv root`

Melden Sie sich ab und wieder an, um die Änderungen auf Ihre Shell anzuwenden.

Fazit

In diesem Tutorial haben Sie rbenv und gem verwendet, um das gesamte Ruby-on-Rails-Framework zu installieren. Ab hier können Sie mit der Erstellung Ihrer Webentwicklungsprojekte beginnen.