Bereitstellen einer Rails-Anwendung in Elastic Beanstalk

Rails ist ein Open-Source-Framework model-view-controller (MVC) für Ruby. Dieses Tutorial führt Sie durch den Prozess der Generierung einer Rails-Anwendung und deren Bereitstellung in einer AWS Elastic Beanstalk Umgebung.

Voraussetzungen

Grundkenntnisse zu Elastic Beanstalk

In diesem Tutorial wird davon ausgegangen, dass Sie die grundlegenden Elastic Beanstalk-Operationen und die Elastic Beanstalk-Konsole kennen. Sofern noch nicht geschehen, starten Sie anhand der Anleitung in Erste Schritte mit Elastic Beanstalk die erste Elastic-Beanstalk-Umgebung.

Befehlszeile

Um die Verfahren in diesem Leitfaden zu befolgen, benötigen Sie ein Befehlszeilen-Terminal oder eine Shell für die Ausführung der Befehle. Befehle werden ggf. in Auflistungen mit einem vorangestellten Eingabeaufforderungssymbol ($) und dem Namen des aktuellen Verzeichnisses angezeigt.

~/eb-project$ this is a command
this is output

In Linux und macOS können Sie Ihren bevorzugten Shell- und Paket-Manager verwenden. Unter Windows können Sie das Windows-Subsystem für Linux installieren, um eine Windows-integrierte Version von Ubuntu und Bash zu erhalten.

Rails-Abhängigkeiten

Das Rails-Framework 6.1.4.1 hat die folgenden Abhängigkeiten. Stellen Sie sicher, dass Sie alle installiert haben.

Starten einer Elastic Beanstalk-Umgebung

Erstellen Sie mit der Elastic Beanstalk-Konsole, eine Elastic Beanstalk-Umgebung. Wählen Sie die Plattform Ruby und übernehmen Sie die Standardeinstellungen und den Beispielcode.

Das Erstellen der Umgebung benötigt etwa fünf Minuten. Dabei werden die folgenden Ressourcen erstellt:

All diese Ressourcen werden von Elastic Beanstalk verwaltet. Wenn Sie die Umgebung beenden, werden alle darin enthaltenen Ressourcen von Elastic Beanstalk beendet.

Installieren von Rails und Generieren einer Website

Installieren Sie Rails und seine Abhängigkeiten mit dem Befehl gem.

~$ gem install rails
Fetching: concurrent-ruby-1.1.9.gem
Successfully installed concurrent-ruby-1.1.9
Fetching: rack-2.2.3.gem
Successfully installed rack-2.2.3
...

Testen Sie Ihre Rails-Installation.

~$ rails --version
Rails 6.1.4.1

Verwenden Sie rails new mit dem Namen der Anwendung, um ein neues Rails-Projekt zu erstellen.

~$ rails new ~/eb-rails

Rails erstellt ein Verzeichnis mit dem angegebenen Namen, generiert alle Dateien, die für eine lokale Ausführung des Beispielprojekts benötigt werden, und führt anschließend Bundler aus, um alle Abhängigkeiten (Gems) zu installieren, die in der Gemfile-Datei des Projekts definiert sind.

Testen Sie die Rails-Installation, indem Sie das Standardprojekt lokal ausführen.

~$ cd eb-rails
~/eb-rails$ rails server
=> Booting Puma
=> Rails 6.1.4.1 application starting in development
=> Run `bin/rails server --help` for more startup options
Puma starting in single mode...
* Puma version: 5.5.2 (ruby 3.0.2-p107) ("Zawgyi")
*  Min threads: 5
*  Max threads: 5
*  Environment: development
*          PID: 77857
* Listening on http://127.0.0.1:3000
* Listening on http://[::1]:3000
Use Ctrl-C to stop
...

Öffnen Sie http://localhost:3000 in einem Webbrowser, um das Standardprojekt in Aktion zu sehen.

Diese Seite ist nur im Entwicklungsmodus sichtbar. Fügen Sie Inhalte auf der Titelseite der Anwendung hinzu, um die Produktionsbereitstellung in Elastic Beanstalk zu unterstützen. Erstellen Sie mit rails generate einen Controller, eine Route und eine Ansicht für die Willkommensseite.

~/eb-rails$ rails generate controller WelcomePage welcome
      create  app/controllers/welcome_page_controller.rb
       route  get 'welcome_page/welcome'
      invoke  erb
      create    app/views/welcome_page
      create    app/views/welcome_page/welcome.html.erb
      invoke  test_unit
      create    test/controllers/welcome_page_controller_test.rb
      invoke  helper
      create    app/helpers/welcome_page_helper.rb
      invoke    test_unit
      invoke  assets
      invoke    coffee
      create      app/assets/javascripts/welcome_page.coffee
      invoke    scss
      create      app/assets/stylesheets/welcome_page.scss.

Dies gibt Ihnen alles, was Sie brauchen, um auf die Seite unter /welcome_page/welcome zuzugreifen. Bevor Sie die Änderungen veröffentlichen, sollten Sie die Inhalte der Ansicht ändern und eine Route hinzufügen, damit diese Seite als Top-Level-Objekt der Website angezeigt wird.

Ändern Sie die Inhalte in app/views/welcome_page/welcome.html.erb mit einem Texteditor. In diesem Beispiel werden die Inhalte der bestehenden Datei einfach mit cat überschrieben.

<h1>Welcome!</h1>
<p>This is the front page of my first Rails application on Elastic Beanstalk.</p>

Abschließend fügen Sie die folgende Route zu config/routes.rb hinzu:

Rails.application.routes.draw do
  get 'welcome_page/welcome'
  root 'welcome_page#welcome'

Damit wird Rails angewiesen, an den Website-Stamm gerichtete Anforderungen an die Willkommen-Methode des Controllers der Willkommenseite zu leiten, von der die Inhalte in der Willkommen-Ansicht dargestellt werden (welcome.html.erb).

Damit Elastic Beanstalk die Anwendung erfolgreich auf der Ruby-Plattform bereitstellen kann, aktualisieren Sie Gemfile.lock. Einige Abhängigkeiten von Gemfile.lock können plattformspezifisch sein. Deshalb müssen Sie platform ruby zu Gemfile.lock hinzufügen, damit alle erforderlichen Abhängigkeiten mit der Bereitstellung installiert werden.

~/eb-rails$ bundle lock --add-platform ruby
Fetching gem metadata from https://rubygems.org/............
Resolving dependencies...
Writing lockfile to /Users/janedoe/EBDPT/RubyApps/eb-rails-doc-app/Gemfile.lock

Konfigurieren von Rails-Einstellungen

Konfigurieren Sie die Rails-Umgebungseigenschaften mit der Elastic Beanstalk-Konsole. Setzen Sie die SECRET_KEY_BASE-Umgebungseigenschaft auf eine Zeichenfolge mit bis zu 256 alphanumerischen Zeichen.

Rails verwendet diese Eigenschaft, um Schlüssel zu erstellen. Aus diesem Grund sollten Sie sie geheimhalten und nicht als Klartext in der Quellsteuerung speichern. Übergeben Sie sie stattdessen an Rails-Code in Ihrer Umgebung über eine Umgebungseigenschaft.

Jetzt können Sie die Website in Ihrer Umgebung bereitstellen.

Bereitstellen der Anwendung

Erstellen Sie ein Quell-Bundle mit den Dateien, die von Rails erstellt wurden. Der folgende Befehl erstellt ein Quell-Bundle mit dem Namen rails-default.zip.

~/eb-rails$ zip ../rails-default.zip -r * .[^.]*

Laden Sie das Quell-Bundle nach Elastic Beanstalk hoch, um Rails in der Umgebung bereitzustellen.

Bereinigen

Wenn Sie nicht mehr mit Elastic Beanstalk arbeiten, können Sie Ihre Umgebung beenden. Elastic Beanstalk beendet alle AWS Ressourcen, die mit Ihrer Umgebung verknüpft sind, wie EC2Amazon-Instances, Datenbank-Instances, Load Balancer, Sicherheitsgruppen und Alarme.

Mit Elastic Beanstalk können Sie ganz einfach und jederzeit eine neue Umgebung für Ihre Anwendung erstellen.

Nächste Schritte

Weitere Informationen über Rails finden Sie unter rubyonrails.org.

Im weiteren Verlauf der Anwendungsentwicklung können Sie Umgebungen verwalten und Anwendungen bereitstellen, ohne manuell eine ZIP-Datei zu erstellen und diese in die Elastic Beanstalk-Konsole hochzuladen. Das Elastic Beanstalk Command Line Interface (EBCLI) bietet easy-to-use Befehle zum Erstellen, Konfigurieren und Bereitstellen von Anwendungen in Elastic Beanstalk Beanstalk-Umgebungen von der Befehlszeile aus.

Wenn Sie Ihre Anwendung in einer Produktionsumgebung verwenden möchten, sollten Sie schließlich einen benutzerdefinierten Domainnamen für Ihre Umgebung konfigurieren und sichere Verbindungen aktivieren HTTPS.