So installieren Sie Ruby on Rails mit rbenv auf macOS

Einführung

Ruby on Rails ist ein beliebter Anwendungsstapel für Entwickler, die Websites und Webanwendungen erstellen möchten. Die Programmiersprache Ruby, in Kombination mit dem Rails-Entwicklungsframework, ermöglicht eine schnelle und effiziente App-Entwicklung.

Ein Weg, um Ruby und Rails zu installieren, ist die Verwendung des Befehlszeilenwerkzeugs rbenv. Die Verwendung von rbenv bietet Ihnen eine gut kontrollierte und robuste Umgebung für die Entwicklung Ihrer Ruby on Rails-Anwendungen und ermöglicht es Ihnen, Ihre Arbeitsversion von Ruby bei Bedarf einfach zu wechseln.

Rbenv bietet Unterstützung für die Angabe anwendungsspezifischer Versionen von Ruby, ermöglicht das Ändern des globalen Rubys für jeden Benutzer und erlaubt es Ihnen, eine Umgebungsvariable zu verwenden, um die Ruby-Version zu überschreiben.

In diesem Tutorial verwenden Sie rbenv, um Ruby on Rails auf Ihrem lokalen macOS-Computer zu installieren und einzurichten.

Voraussetzungen

Um diesem Tutorial folgen zu können, benötigen Sie:

• Einen Computer oder eine virtuelle Maschine mit macOS installiert, mit administrativem Zugriff auf diese Maschine und eine Internetverbindung. Dieses Tutorial wurde auf macOS 12.4 Monterey getestet.
• Node.js ist auf Ihrem macOS-Rechner installiert, wie in Wie installiert man Node.js und erstellt eine lokale Entwicklungsumgebung auf macOS erklärt. Einige Rails-Funktionen, wie der Asset-Pipeline, sind von einer JavaScript-Laufzeitumgebung abhängig. Node.js bietet diese Funktionalität.
• Der Homebrew-Paketmanager ist auf Ihrem macOS-Rechner installiert.

Schritt 1 – Installation von rbenv

In diesem Schritt werden Sie rbenv installieren und sicherstellen, dass es beim Start automatisch ausgeführt wird. Um dies auf macOS zu tun, wird dieses Tutorial den Paketmanager Homebrew verwenden.

Um das rbenv-Paket mit Homebrew herunterzuladen, führen Sie den folgenden Befehl aus:

brew install rbenv

Dies installiert rbenv und das [ruby-build] (https://github.com/rbenv/ruby-build) Plugin. Dieses Plugin fügt den Befehl rbenv install hinzu, der den Installationsprozess für neue Versionen von Ruby vereinfacht. Dies kann einige andere Abhängigkeiten installieren und einige Zeit in Anspruch nehmen.

Als nächstes fügen Sie den Befehl eval "$(rbenv init -)" zu Ihrer Datei ~/.bash_profile hinzu, damit rbenv automatisch geladen wird, wenn Sie das Terminal öffnen. Öffnen Sie dazu Ihre Datei .bash_profile in nano oder Ihrem bevorzugten Texteditor:

nano .bash_profile

Fügen Sie die folgende Zeile zur Datei hinzu:

eval "$(rbenv init -)"

Speichern und beenden Sie die Datei.

Führen Sie als Nächstes die Änderungen, die Sie an Ihrer Datei ~/.bash_profile vorgenommen haben, in Ihrer aktuellen Shell-Sitzung aus:

source ~/.bash_profile

Um zu überprüfen, ob rbenv ordnungsgemäß eingerichtet ist, verwenden Sie den Befehl type, der weitere Informationen über den Befehl rbenv anzeigt:

type rbenv

Ihr Terminalfenster zeigt nun folgendes an:

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

Zu diesem Zeitpunkt haben Sie sowohl rbenv als auch ruby-build auf Ihrem Rechner installiert. Dies ermöglicht es Ihnen, Ruby in den nächsten Schritt über die Befehlszeile zu installieren.

Schritt 2 — Ruby installieren

Mit dem jetzt installierten ruby-build-Plugin können Sie jede benötigte Ruby-Version über einen einzigen Befehl installieren. In diesem Schritt wählen Sie eine Ruby-Version aus, installieren sie auf Ihrem Rechner und überprüfen dann die Installation.

Verwenden Sie zunächst die Flagge -l, um die verfügbaren Ruby-Versionen aufzulisten. Beachten Sie, dass auch nicht aufgeführte, aktuelle Nebenversionen verfügbar sein können. Wenn zum Beispiel die Ausgabe dieses Befehls Ruby 3.0.5 auflistet, können Sie wahrscheinlich auch 3.0.4 installieren.

rbenv install -l

Output
2.6.10
2.7.6
3.0.4
3.1.2
jruby-9.3.6.0
mruby-3.1.0
picoruby-3.0.0
rbx-5.0
truffleruby-22.1.0
truffleruby+graalvm-22.1.0

Die Ausgabe dieses Befehls wird eine lange Liste von Versionen sein, aus der du wählen kannst, um sie zu installieren.

Für dieses Tutorial werden wir Ruby 3.1.2 installieren:

rbenv install 3.1.2

Die Installation von Ruby kann ein zeitaufwändiger Prozess sein, also sei darauf vorbereitet, dass die Installation einige Zeit in Anspruch nehmen wird, um abgeschlossen zu werden.

Sobald die Installation abgeschlossen ist, setze sie als deine Standardversion von Ruby mit dem Unterbefehl global:

rbenv global 3.1.2

Überprüfe, ob Ruby ordnungsgemäß installiert wurde, indem du seine Versionsnummer überprüfst:

ruby -v

Deine Ausgabe wird ungefähr so aussehen:

Output
ruby 3.1.2p20 (2022-04-12 revision 4491bb740a) [x86_64-darwin21]

Um eine andere Version von Ruby zu installieren und zu verwenden, führe die rbenv-Befehle mit einer anderen Versionsnummer aus, wie zum Beispiel rbenv install 2.7.6 und rbenv global 2.7.6.

Du hast jetzt eine Version von Ruby installiert und deine Standard-Ruby-Version festgelegt. Als nächstes wirst du dich darauf einstellen, mit Ruby-Paketen und Bibliotheken, oder Gems, zu arbeiten, was es dir ermöglichen wird, Rails zu installieren.

Schritt 3 — Arbeiten mit Gems

Gems sind Pakete von Ruby-Bibliotheken und Programmen, die im Ruby-Ökosystem verteilt werden können. Du verwendest den gem-Befehl, um diese Gems zu verwalten. In diesem Schritt wirst du den gem-Befehl konfigurieren, um dich auf die Rails-Installation vorzubereiten.

Wenn Sie ein Gem installieren, generiert der Installationsprozess lokale Dokumentation. Dies kann zu einer erheblichen Verlängerung des Installationsprozesses für jedes Gem führen. Sie können die Generierung der lokalen Dokumentation deaktivieren, indem Sie eine Datei namens ~/.gemrc erstellen, die eine Konfigurationseinstellung enthält, um dieses Feature zu deaktivieren:

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

Wenn dies erledigt ist, verwenden Sie den Befehl gem, um Bundler zu installieren, ein Tool zur Verwaltung von Gem-Abhängigkeiten für Projekte. Dies wird benötigt, damit Rails korrekt funktioniert:

gem install bundler

Sie werden eine Ausgabe wie diese sehen:

Output
Fetching: bundler-2.3.18.gem
Successfully installed bundler-2.3.18
1 gem installed

Sie können den Befehl gem env verwenden, um mehr über die Umgebung und Konfiguration von Gems zu erfahren. Verwenden Sie das Argument home, um den Speicherort der installierten Gems anzuzeigen, wie folgt:

gem env home

Sie werden eine ähnliche Ausgabe wie diese sehen:

/Users/sammy/.rbenv/versions/3.1.2/lib/ruby/gems/3.1.0

Jetzt, da Sie Ihren Gem-Workflow eingerichtet und erkundet haben, können Sie Rails installieren.

Schritt 4 – Rails installieren

Verwenden Sie den Befehl gem install, um Rails zu installieren:

gem install rails

Der Befehl gem installiert das von Ihnen angegebene Gem sowie alle Abhängigkeiten. Rails ist ein komplexes Webentwicklungsframework und hat viele Abhängigkeiten, daher dauert der Prozess einige Zeit, um abzuschließen. Schließlich sehen Sie eine Meldung, dass Rails zusammen mit seinen Abhängigkeiten installiert ist.

Output
...
Successfully installed rails-7.0.3.1
35 gems installed

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

rbenv funktioniert, indem es ein Verzeichnis von Shims erstellt, oder Bibliotheken, die Aufrufe abfangen und ändern oder umleiten. In diesem Fall zeigen Shims Ruby-Befehle auf die Dateien, die von der aktuell aktivierten Ruby-Version verwendet werden. Durch den Unterbefehl rehash pflegt rbenv Shims in diesem Verzeichnis, um jeden Ruby-Befehl für jede installierte Ruby-Version auf Ihrem Server anzupassen. Wenn Sie eine neue Version von Ruby oder ein Gem installieren, das Befehle bereitstellt, wie z.B. Rails, sollten Sie rehash verwenden.

Um das Verzeichnis der Shims neu zu laden, führen Sie den folgenden Befehl aus:

rbenv rehash

Überprüfen Sie Ihre Rails-Installation, indem Sie mit diesem Befehl die Version ausgeben:

rails -v

Sie werden die installierte Version von Rails sehen:

Output
Rails 7.0.3.1

Mit Rails erfolgreich installiert können Sie mit dem Testen Ihrer Ruby on Rails-Installation beginnen und mit der Entwicklung von Webanwendungen beginnen. Im nächsten Schritt erfahren Sie, wie Sie rbenv und Ruby aktualisieren und deinstallieren können.

Schritt 5 — Aktualisieren und Deinstallieren von rbenv und Ruby

Wenn Sie Projekte warten, ist es nützlich zu wissen, wie man Aktualisierungen durchführt und deinstalliert, wenn es nötig ist. In diesem Schritt werden Sie rbenv aktualisieren und dann Ruby und rbenv von Ihrem Gerät deinstallieren.

Sie können rbenv und ruby-build mit Homebrew aktualisieren, indem Sie den folgenden Befehl ausführen:

brew upgrade rbenv ruby-build

Wenn rbenv oder ruby-build aktualisiert werden müssen, wird Homebrew dies automatisch für Sie erledigen. Wenn Ihre Konfiguration bereits auf dem neuesten Stand ist, erhalten Sie eine ähnliche Ausgabe wie folgt:

Output
Warning: rbenv 1.2.0 already installed
Warning: ruby-build 20220713 already installed

Dies stellt sicher, dass wir die aktuellste verfügbare Version von rbenv verwenden.

Wenn Sie zusätzliche Versionen von Ruby herunterladen, können Sie möglicherweise mehr Versionen als gewünscht in Ihrem ~/.rbenv/versions-Verzeichnis ansammeln. Mithilfe des Unterkommandos uninstall des ruby-build-Plugins können Sie diese früheren Versionen entfernen.

Zum Beispiel führen Sie den folgenden Befehl aus, um Ruby-Version 2.1.3 zu deinstallieren:

rbenv uninstall 2.1.3

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

Wenn Sie sich entschieden haben, rbenv nicht mehr zu verwenden, können Sie es von Ihrem System entfernen.

Dazu öffnen Sie zuerst Ihre ~/.bash_profile-Datei in Ihrem Editor:

nano ~/.bash_profile

Suchen Sie die folgende Zeile in der Datei und entfernen Sie sie, um zu verhindern, dass rbenv beim Öffnen des Terminals gestartet wird:

...
eval "$(rbenv init -)"

Nachdem Sie diese Zeile gelöscht haben, speichern Sie die Datei und beenden Sie den Editor.

Führen Sie den folgenden Befehl aus, um die Änderungen auf Ihre Shell anzuwenden:

source ~/.bash_profile

Entfernen Sie anschließend rbenv und alle installierten Ruby-Versionen mit diesem Befehl:

rm -rf `rbenv root`

Schließlich entfernen Sie das rbenv-Paket selbst mit Homebrew:

brew uninstall rbenv

Überprüfen Sie die rbenv-Version, um sicherzustellen, dass es deinstalliert wurde:

rbenv -v

Sie erhalten die folgende Ausgabe:

Output
-bash: /usr/local/bin/rbenv: No such file or directory

Dies bedeutet, dass Sie rbenv erfolgreich von Ihrem Rechner entfernt haben.

Abschluss

In diesem Tutorial haben Sie Ruby on Rails mit rbenv auf macOS installiert. Von hier aus können Sie mehr über das Programmieren in Ruby mit unserer Anleitung zum Programmieren in Ruby-Serie erfahren. Sie können auch erkunden, wie Sie Ruby on Rails mit PostgreSQL anstelle seiner Standard-Sqlite3-Datenbank verwenden können, die mehr Skalierbarkeit, Zentralisierung und Stabilität für Ihre Anwendungen bietet.