Tutorial: Ruby und Ruby on Rails installieren und RubyGems verwenden

Du hast sicher schon von Ruby on Rails gehört und davon, wie schnell sich damit funktionsfähige Anwendungen entwickeln lassen. Für die Erstellung neuer Software braucht es jedoch ein paar Bausteine – und das Wissen, wie man sie effizient handhabt.

Der erste Schritt ist natürlich die Installation von Ruby selbst. Da die Anzahl deiner Projekte vermutlich schnell wächst, kann das Verwalten mehrerer Ruby-Versionen recht mühsam werden. Dafür hat die Open-Source-Community mehrere Version-Manager bereitgestellt – die beliebtesten sind rbenv und rvm.

Wie installiert man Ruby auf dem Mac?

Sowohl rvm als auch rbenv sind für macOS und gängige Linux-Distributionen verfügbar. Der Prozess beschränkt sich im Grunde darauf, ein paar Befehle ins Terminal zu kopieren.

rbenv

1. Mit installiertem Homebrew führe im Terminal Folgendes aus (und falls nicht vorhanden, kannst du rbenv per GitHub-Checkout installieren):

$ brew install rbenv

2. Danach tippe:

$ rbenv init

3. Daraufhin erhältst du eine Anleitung zur Einrichtung deiner Shell. Meist genügt es, eine Zeile in .zshrc oder .bash_profile zu ergänzen:

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

4. Ab jetzt sollte rbenv bei jedem Öffnen des Terminals einsatzbereit sein.

$ source  ~/.zshrv

5. Nun ist es Zeit, Ruby selbst zu installieren. Das geht so einfach wie das Anhängen der Versionsnummer an den install-Befehl:

$ rbenv install 2.7.0
$ rbenv global 2.7.0

6. Um die lokal zu verwendende Version festzulegen, tippe:

$ rbenv local 2.7.0

rvm

Wenn du Ruby bereits mit rbenv installiert hast, bist du fertig. rvm ist ein alternatives Tool für dasselbe Ziel, und es ist generell keine gute Idee, beide gleichzeitig zu verwenden — außerdem gibt es dafür keinen wirklichen Grund.

Die Installation von rvm ist rbenv sehr ähnlich; auch hier genügen ein paar Befehle im Terminal:

1. Beginnen wir mit dem Hinzufügen der PGP-Schlüssel:

gpg --keyserver hkp://keys.gnupg.net --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3

2. Dann rvm holen und direkt die neueste Ruby-Version installieren:

$ curl -sSL https://get.rvm.io | bash -s stable --ruby

3. Weitere Ruby-Versionen lassen sich wie folgt schnell herunterladen und installieren:

$ rvm install 2.7.0

Wichtig: Im Projektverzeichnis kannst du eine .ruby-version-Datei anlegen (eine einfache Textdatei mit der Ruby-Versionsnummer). Auf Basis dieser Datei versuchen sowohl rbenv als auch rvm, die passende Ruby-Version zu verwenden oder schlagen die Installation der fehlenden Version vor.

Wie installiert man Ruby unter Windows?

Unter Windows ist RubyInstaller die beste Option. Lade einfach die .exe-Datei für die gewünschte Ruby-Version herunter und starte die Installation. RubyInstaller lässt sich mit MSYS2 (ein Port der Unix-Entwicklertools) und MinGW-Bibliotheken kombinieren und bietet so eine hervorragende Entwicklungsumgebung.

Ruby-Installation prüfen

Nach der Installation kannst du die Version prüfen mit:

$ ruby -v

Und sehen, wo der Interpreter liegt:

$ which ruby

Ruby ist eine interpretierte Programmiersprache. Um Code auszuführen, genügt es, auf die .rb-Datei zu zeigen und den Befehl zu starten:

$ ruby app.rb

Zusammen mit dem Interpreter kommt die Interactive Ruby Shell (irb), die Ruby-Befehle in Echtzeit ausführt:

$ irb
irb(main):001:0> 2+2
=> 4

Was ist RubyGems?

Die Standardinstallation von Ruby enthält die Ruby Core API und Standard Library API, mit denen sich Ruby-Anwendungen schreiben lassen. Eine einfache App könnte man damit von Grund auf erstellen. Für komplexere Vorhaben nutzt man jedoch am besten die Ruby-Pakete aus dem Paketmanager. Bei Ruby heißt er RubyGems, und die Pakete heißen Gems. 

RubyGems bringt das Kommandozeilen-Tool gem mit. Es installiert Gems aus angegebenen öffentlichen oder privaten Repositories. Erwähnenswert ist auch https://rubygems.org/, wo viele Gems aus der Ruby-Community gehostet werden. Typischerweise liefert ein Gem neue Bibliotheken mit bestimmten Funktionalitäten und manchmal auch Kommandozeilen-Tools. 

RubyGems ist in der Standardinstallation von Ruby enthalten, du musst also nichts zusätzlich installieren.

Wie benutzt man RubyGems?

Schauen wir uns die Arbeit mit Gems an. Dieser Befehl zeigt die RubyGems-Einstellungen inklusive der Installationspfade:

$ gem env

Gems installieren/deinstallieren

Zum Installieren bzw. Deinstallieren:

$ gem install gem_name (-v version, um die Gem-Version festzulegen)
$ gem uninstall gem_name

Gems aktualisieren

Um ein bestimmtes Gem zu aktualisieren, führe aus:

$ gem update gem_name

Oder alle Gems:

$ gem update

Gems auflisten

Gems werden in einem lokalen Repository installiert. Um alle installierten Gems aufzulisten, tippe:

$ gem list

Beim Installieren werden alle Abhängigkeiten eines Gems automatisch mit installiert.

Ruby Bundler

Während der Entwicklung stellst du schnell fest, dass dein Projekt immer mehr Gems braucht. Sie alle manuell mit gem zu installieren und dabei alle Abhängigkeiten zu treffen, ist mühsam bis unmöglich. Hier hilft ein smartes Tool für das Management aller Projekt-Gems — Bundler.

Bundler installieren und Gems fürs Projekt festlegen

Bundler kommt als Gem, installiere es also zuerst:

$ gem install bundler

Erstelle dann im Projektstamm eine Gemfile mit folgendem Inhalt:

source ‘https://rubygems.org’ gem ‘rails’, ’6.0.2.1’ gem ‘rspec’

Gems mit Bundler installieren

Zum Installieren tippe:

$ bundle install

Damit werden alle Gems mit den angegebenen Versionen und deren Abhängigkeiten installiert. Wenn du ein weiteres Gem verwenden willst, füge es zur Gemfile hinzu und führe bundle install erneut aus.

Gems mit Bundler aktualisieren

Wenn du bestimmte Gems aktualisieren möchtest, ändere die Version in der Gemfile und führe erneut aus:

$ bundle install

Um ein bestimmtes Gem zu aktualisieren, nutze:

$ bundle update gem_name

Oder für alle Gems:

$ bundle update

In beiden Fällen löst Bundler die Abhängigkeiten.

Wie nutzt man Ruby on Rails?

Nach allen Installationen und Einstellungen ist es Zeit, ein neues Ruby on Rails-Projekt zu starten und ein paar Dinge einzurichten. 

Rails installieren

Keine Überraschung — Rails kommt als Gem:

$ gem install rails

Dadurch wird die neueste Rails-Version zusammen mit einigen weiteren Gems installiert, von denen Rails abhängt. Rails selbst bringt ein Kommandozeilen-Tool mit, mit dem du eine neue Ruby-on-Rails-Anwendung erstellen kannst.

Prüfe die Version und die Hilfe, die die Optionen zum Erstellen einer neuen App beschreibt.

$ rails -v
$ rails -h

Neue Rails-Anwendung

Erstelle ein Rails-Projekt mit den Standardoptionen:

$ rails new my_amazing_rails_app

Dieser Befehl generiert die komplette Projektstruktur im Verzeichnis my_amazing_rails_app. Du siehst die Ausgabe beim Erstellen der Dateien, anschließend installiert Bundler alle Abhängigkeiten aus der neu erzeugten Gemfile. 

Wechsle danach in das Verzeichnis my_amazing_rails_app und starte einen Rails-Server.

$ cd my_amazing_rails_app
$ rails server

Dadurch startet der Webserver Puma, der standardmäßig von Rails-Anwendungen verwendet wird. Der Standardport ist 3000. Öffne deinen Browser, rufe http://localhost:3000 auf und du solltest die Rails-Willkommensseite sehen.

Wie richtet man eine Ruby-on-Rails-Entwicklungsumgebung ein?

Die Standarddatenbank von Rails ist SQLite. Wenn du von Beginn an eine andere DB nutzen willst, kannst du sie mit der folgenden Option angeben:

$ rails new my_amazing_rails_app —database postgresql

Die Datenbankkonfiguration befindet sich in der Datei config/database.yml. Rails führt die Anwendung in der angegebenen Umgebung aus (für den lokalen Start wird standardmäßig die Umgebung „development“ verwendet). Um deine DB-Einstellungen zu setzen, bearbeite die development-Settings in config/database.yml. 

Eine weitere häufig genutzte Option ist api. Sie konfiguriert die Anwendung mit reduzierten Middleware-Komponenten, nur für API-orientierte Apps.

$ rails new my_amazing_rails_app —api

Rails generiert eine Menge Dateien. Im Verzeichnis app findest du die zentralen Dateien der Anwendung. Da Rails dem MVC-Prinzip (Model-View-Controller) folgt, gibt es dort passende Verzeichnisse für Models, Controller und Views. Im Verzeichnis config liegen Konfigurationsdateien für die Anwendung, die Umgebungen, die Datenbank, die Routen usw. Im Verzeichnis db findest du das DB-Schema und die Migrationsdateien.

Wie geht es weiter?

Es gibt viele Rails-Tutorials und -Guides. Besonders zu nennen ist https://guides.rubyonrails.org/, wo die meisten Rails-Features mit Beispielen beschrieben werden. Ruby- und Rails-APIs sind gut dokumentiert. Erstelle einfach eine neue App, lege ein Model, einen Controller und eine View dafür an — und vielleicht verliebst du dich in Rails!

Wenn du dich für Ruby-on-Rails-Entwicklung interessierst, lies unseren Artikel und erfahre, warum es sich lohnt, Ruby on Rails zu lernen.