Ruby on Rails mit rbenv auf macOS installieren: Anleitung

Ruby on Rails ist ein beliebter Anwendungsstack für Entwickler, die Websites und Webanwendungen erstellen möchten. Die Programmiersprache Ruby in Kombination mit dem Entwicklungsframework Rails macht die App-Entwicklung schnell und effizient.

Eine Möglichkeit, Ruby und Rails zu installieren, ist das Befehlszeilentool rbenv. Mit rbenv erhalten Sie eine gut kontrollierte und robuste Umgebung für die Entwicklung Ihrer Ruby-on-Rails-Anwendungen, die es Ihnen ermöglicht, Ihre Arbeitsversion von Ruby bei Bedarf einfach zu wechseln.

rbenv bietet Unterstützung für die Angabe anwendungsspezifischer Versionen von Ruby, ermöglicht es Ihnen, die globale Ruby-Version für jeden Benutzer zu ändern, und erlaubt es, 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 zu folgen, benötigen Sie:

• Einen Computer oder eine virtuelle Maschine mit macOS und Administrationszugriff sowie eine Internetverbindung. Dieses Tutorial wurde auf macOS 12.4 Monterey getestet.
• Node.js auf Ihrem macOS-Computer installiert. Einige Funktionen von Rails, wie die Asset Pipeline, sind von einer JavaScript-Laufzeit abhängig. Node.js bietet diese Funktionalität.
• Den Homebrew-Paketmanager auf Ihrem macOS-Computer installiert.

Schritt 1 — Installation von rbenv

In diesem Schritt installieren Sie rbenv und stellen sicher, dass es beim Start automatisch geladen wird. Dazu verwendet dieses Tutorial den Paketmanager Homebrew.

Laden Sie das rbenv-Paket mit Homebrew herunter, indem Sie den folgenden Befehl ausführen:

brew install rbenv

Dadurch werden rbenv und das ruby-build-Plugin installiert. Dieses Plugin fügt den Befehl rbenv install hinzu, der den Installationsprozess für neue Versionen von Ruby vereinfacht. Dies kann mehrere Abhängigkeiten installieren und einige Zeit in Anspruch nehmen.

Fügen Sie als Nächstes 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 in die Datei ein:

eval "$(rbenv init -)"

Speichern Sie die Datei und verlassen Sie den Editor.

Wenden Sie als Nächstes die Änderungen an, die Sie an Ihrer Datei ~/.bash_profile vorgenommen haben, damit sie für die aktuelle Shell-Sitzung wirksam werden:

source ~/.bash_profile

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

type rbenv

Ihr Terminalfenster zeigt Folgendes an:

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
}

Schritt 2 — Installation von Ruby

Mit dem Plugin ruby-build können Sie jetzt jede gewünschte Ruby-Version über einen einzigen Befehl installieren. In diesem Schritt wählen Sie eine Version von Ruby, installieren sie auf Ihrem Computer und überprüfen die Installation.

Führen Sie zuerst den Befehl mit dem Flag -l aus, um die verfügbaren Ruby-Versionen aufzulisten:

rbenv install -l

Die Ausgabe zeigt eine Liste mit verfügbaren Versionen. Installieren Sie zum Beispiel Ruby 3.1.2:

rbenv install 3.1.2

Nach Abschluss der Installation können Sie diese als Standardversion setzen:

rbenv global 3.1.2

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

ruby -v

Die Ausgabe wird in etwa so aussehen:

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

Um eine andere Version von Ruby zu installieren und zu verwenden, führen Sie die rbenv-Befehle mit einer anderen Versionsnummer aus, z. B.:

rbenv install 2.7.6
rbenv global 2.7.6

Jetzt haben Sie eine Version von Ruby installiert und als Standardversion festgelegt. Im nächsten Schritt richten Sie Ruby-Pakete und Bibliotheken (sogenannte Gems) ein, damit Sie Rails installieren können.

Schritt 3 — Arbeiten mit Gems

Gems sind Pakete von Ruby-Bibliotheken und Programmen, die im gesamten Ruby-Ökosystem verteilt werden können. Mit dem gem-Befehl verwalten Sie diese Gems. In diesem Schritt konfigurieren Sie den gem-Befehl, um die Installation von Rails vorzubereiten.

Wenn Sie ein Gem installieren, wird lokale Dokumentation generiert. Dieser Prozess kann die Installationszeit erheblich verlängern. Um dies zu verhindern, können Sie eine Datei namens ~/.gemrc erstellen, die eine Konfigurationsanweisung enthält, um die Generierung lokaler Dokumentation zu deaktivieren:

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

Installieren Sie anschließend den Bundler, ein Werkzeug, das Abhängigkeiten von Gems in Projekten verwaltet. Bundler ist erforderlich, damit Rails korrekt funktioniert:

gem install bundler

Die Ausgabe wird wie folgt aussehen:

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 der Gems zu erfahren. Um den Speicherort der installierten Gems anzuzeigen, verwenden Sie das Argument home:

gem env home

Die Ausgabe wird in etwa so aussehen:

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

Nachdem Sie Ihre Gem-Workflow eingerichtet haben, können Sie Rails installieren.

Schritt 4 — Installation von Rails

Um Rails zu installieren, verwenden Sie den gem install-Befehl:

gem install rails

Der gem-Befehl installiert das angegebene Gem sowie alle Abhängigkeiten. Rails ist ein komplexes Webentwicklungsframework mit vielen Abhängigkeiten, sodass die Installation einige Zeit in Anspruch nehmen kann. Schließlich wird eine Nachricht angezeigt, dass Rails zusammen mit seinen Abhängigkeiten installiert wurde:

...
Successfully installed rails-7.0.3.1
35 gems installed

Falls Sie eine andere Version von Rails installieren möchten, können Sie die verfügbaren Versionen durchsuchen und eine spezifische Version installieren:

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

Verifizieren Sie die Installation von Rails, indem Sie die Version abfragen:

rails -v

Die Ausgabe zeigt die installierte Rails-Version:

Rails 7.0.3.1

Mit Rails erfolgreich installiert, können Sie mit der Entwicklung von Webanwendungen beginnen.

Schritt 5 — Aktualisieren und Deinstallieren von rbenv und Ruby

Wenn Sie Projekte pflegen, ist es hilfreich zu wissen, wie Sie Updates durchführen und Installationen entfernen können, wenn dies erforderlich ist. In diesem Schritt aktualisieren Sie rbenv und deinstallieren anschließend Ruby und rbenv von Ihrem Computer.

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

brew upgrade rbenv ruby-build

Wenn rbenv oder ruby-build aktualisiert werden müssen, erledigt Homebrew dies automatisch für Sie. Wenn Ihr Setup bereits auf dem neuesten Stand ist, erhalten Sie eine Ausgabe wie diese:

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

Während Sie zusätzliche Ruby-Versionen herunterladen, können sich möglicherweise mehr Versionen ansammeln, als Sie tatsächlich benötigen. Sie können alte Versionen mithilfe des ruby-build-Plugins und dessen uninstall-Unterbefehl entfernen. Zum Beispiel:

rbenv uninstall 2.1.3

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

Falls Sie entschieden haben, rbenv nicht länger verwenden zu wollen, können Sie es von Ihrem System entfernen.

Öffnen Sie zuerst Ihre Datei ~/.bash_profile in einem Texteditor:

nano ~/.bash_profile

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

eval "$(rbenv init -)"

Speichern Sie die Datei und beenden Sie den Editor.

Wenden Sie die Änderungen mit folgendem Befehl auf Ihre aktuelle Shell-Sitzung an:

source ~/.bash_profile

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

rm -rf `rbenv root`

Zuletzt deinstallieren Sie das rbenv-Paket selbst mit Homebrew:

brew uninstall rbenv

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

rbenv -v

Die Ausgabe wird wie folgt aussehen:

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

Das bedeutet, dass Sie rbenv erfolgreich von Ihrem Computer entfernt haben.

Fazit

In diesem Tutorial haben Sie Ruby on Rails mit rbenv auf macOS installiert. Jetzt können Sie weiter erkunden, wie Sie Ruby on Rails für Ihre Projekte nutzen können. Sie können auch PostgreSQL anstelle der Standarddatenbank sqlite3 verwenden, um die Skalierbarkeit und Stabilität Ihrer Anwendungen zu verbessern.