Ruby-Entwicklungsumgebung einrichten

In diesem Tutorial erfahren Sie, wie Sie Ihren lokalen Computer für die Ruby-Entwicklung vorbereiten, einschließlich der Entwicklung von Ruby-Apps, die auf Google Cloudausgeführt werden. Folgen Sie dieser Anleitung, um Ruby und dafür erforderliche Tools zu installieren.

In der Kurzanleitung für Ruby Google Cloud finden Sie eine Übersicht über Ruby und Möglichkeiten zum Ausführen von Ruby-Apps auf Google Cloud.

Ziele

  • Ruby installieren
  • Bundler installieren
  • Editor installieren (optional)
  • Installieren Sie die Google Cloud CLI.
  • Installieren Sie die Cloud-Clientbibliotheken für Ruby.
  • Richten Sie die Authentifizierung ein.

Ruby installieren

Die Installationsanleitung für Ruby variiert je nach Betriebssystem. Folgen Sie der Anleitung für das Betriebssystem, das Sie auf Ihrem lokalen Entwicklungscomputer verwenden. Dieses Tutorial gilt für stabile und nicht EOL-Versionen (End-of-Life) von Ruby, die auf Ruby-lang aufgeführt sind.

macOS

Wir empfehlen, rbenv zu verwenden, um Ihre Ruby-Installationen unter macOS zu verwalten. rbenv verwaltet mehrere Ruby-Versionsinstallationen auf Ihrem Computer und ein rbenv-Plug-in namens ruby-build fügt rbenv Unterstützung hinzu, um eine bestimmte Version von Ruby zu installieren.

Obgleich macOS standardmäßig eine Ruby-Version enthält, empfiehlt sich eine separate Installation der neuesten Ruby-Versionen. Sie stellen dadurch den aktuellen Stand sicher und vermeiden Konflikte mit der durch das Betriebssystem genutzten Standardversion.

  1. Installieren Sie XCode.

  2. Installieren Sie die Befehlszeilentools von Xcode mit dem folgenden Befehl in einem Terminal:

    xcode-select --install

  3. Installieren Sie homebrew gemäß der Anleitung auf der Homebrew-Startseite.

  4. Installieren Sie rbenv mithilfe von homebrew und folgen Sie der Anleitung in der rbenv-Readme-Datei. Die Homebrew-Installation enthält das Plug-in ruby-build.

Weitere Informationen zur Verwendung von rbenv und ruby-build zum Installieren verschiedener Ruby-Versionen.

Linux

Wir empfehlen, rbenv zu verwenden, um Ihre Ruby-Installationen auf Linux-Distributionen zu verwalten. rbenv verwaltet mehrere Ruby-Versionen auf Ihrem Computer und ein rbenv-Plug-in namens ruby-build fügt rbenv Unterstützung für die Installation einer bestimmten Version von Ruby hinzu.

  1. Installieren Sie rbenv mithilfe der rbenv-Readme auf Ihrer Linux-Distribution.

  2. Installieren Sie das Plug-in ruby-build für rbenv. Folgen Sie dazu der Anleitung in der Readme-Datei ruby-build.

Weitere Informationen zur Verwendung von rbenv und ruby-build zum Installieren verschiedener Ruby-Versionen

Windows

Für Windows empfehlen wir eine der folgenden Optionen:

Bundler installieren

Bundler ist ein Ruby-Gem, das die in einer Datei namens Gemfile definierten Gem-Abhängigkeiten des Projekts verwaltet. In den Ruby-Beispielen in der Dokumentation von Google Cloudwerden Gemfile-Dateien verwendet, um erforderliche Gems und Versionen anzugeben.

  1. Bundler installieren

    gem install bundler

  2. Installieren Sie die in Gemfile definierten gem - Abhängigkeiten.

    bundle install

  3. Führen Sie Ihr Ruby-Projekt nur mit den in Gemfile definierten Gems aus.

    bundle exec ruby app.rb

Weitere Informationen zum Erstellen eines Gemfile finden Sie in der Dokumentation zu Bundler.

Editor installieren

Im Folgenden sind in beliebiger Reihenfolge gängige Editoren aufgeführt, die zur Entwicklung von Ruby-Anwendungen verwendet werden können:

Diese Editoren bieten (teilweise mithilfe von Plug-ins) alle erforderlichen Funktionen, von Syntaxhervorhebung, IntelliSense und Codebeispielen bis zu vollständig integrierten Fehlerbehebungsfunktionen für eine maximale Effizienz bei der Ruby-Entwicklung.

gcloud-CLI installieren

Die gcloud CLI ist eine Reihe von Tools für Google Cloud. Es enthält gcloud und bq, mit denen Sie über die Befehlszeile auf Compute Engine, Cloud Storage, BigQuery und andere Produkte und Dienste zugreifen können. Sie können diese Tools interaktiv oder in Ihren automatisierten Skripts ausführen.

Hier ist ein einfaches Beispiel für einen Befehl, mit dem eine Ruby-Webanwendung in der flexiblen App Engine-Umgebung bereitgestellt wird. Nach der Bereitstellung versucht App Engine, die App mit bundle exec ruby app.rb -p 8080 zu starten:

gcloud app deploy

Hier erfahren Sie, wie Sie eine Ruby on Rails-Anwendung in der flexiblen App Engine-Umgebung bereitstellen.

Cloud-Clientbibliothek für Ruby installieren

Die Cloud-Clientbibliothek für Ruby bietet Ruby-Entwicklern eine idiomatische Möglichkeit zur Integration in Google Cloud-Dienste. Sie können das Paket für eine einzelne API wie z. B. Cloud Storage installieren:

gem install google-cloud-storage

Sie haben auch die Möglichkeit, mit Bundler Ihren Gemfile-Abhängigkeiten das Gem hinzuzufügen:

bundle add google-cloud-storage

Authentifizierung einrichten

Wenn Sie die Cloud-Clientbibliotheken in einer lokalen Entwicklungsumgebung verwenden möchten, richten Sie Standardanmeldedaten für Anwendungen ein.

Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Authentifizierungsdaten für Ihr Nutzerkonto: 

gcloud auth application-default login

Wenn Sie Cloud Shell verwenden, müssen Sie das nicht tun.

Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.

Weitere Informationen finden Sie unter Für die Verwendung von Clientbibliotheken authentifizieren.

Nächste Schritte