View a markdown version of this page

Bereitstellen einer Sinatra-Anwendung in Elastic Beanstalk - AWS Elastic Beanstalk
VoraussetzungenStarten einer Elastic Beanstalk-UmgebungSchreiben einer einfachen Sinatra-WebsiteBereitstellen der AnwendungBereinigenNächste Schritte

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Bereitstellen einer Sinatra-Anwendung in Elastic Beanstalk

Diese schrittweise Anleitung zeigt, wie eine einfache Sinatra-Webanwendung in AWS Elastic Beanstalk erstellt wird.

Voraussetzungen

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 Erfahren Sie, wie Sie mit Elastic Beanstalk loslegen die erste Elastic-Beanstalk-Umgebung.

Für die Verfahren in diesem Leitfaden 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-integrated Version von Ubuntu und Bash zu erhalten.

Sinatra 2.1.0 erfordert Ruby 2.3.0 oder höher. In diesem Tutorial verwenden wir Ruby 3.0.2 und die entsprechende Elastic Beanstalk-Plattformversion. Installieren Sie Ruby mithilfe der Anleitungen unter Einrichtung Ihrer Ruby-Entwicklungsumgebung für Elastic Beanstalk.

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.

So starten Sie eine Umgebung (Konsole)

  1. Öffnen Sie die Elastic Beanstalk-Konsole über diesen vorkonfigurierten Link: console.aws.amazon. com/elasticbeanstalk/home #/Neue Anwendung? Anwendungsname=Tutorials&EnvironmentType= LoadBalanced

  2. Wählen Sie unter Platform (Plattform) die Plattform und die Plattformvariante aus, die mit der Sprache Ihrer Anwendung übereinstimmen.

  3. Wählen Sie unter Application code (Anwendungscode) die Option Sample application (Beispielanwendung) aus.

  4. Klicken Sie auf Review and launch (Überprüfen und starten).

  5. Sehen Sie sich die verfügbaren Optionen an. Wählen Sie die gewünschte verfügbare Option aus und wählen Sie Create App (App erstellen) aus.

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

  • Beanstalk Standard — Für eine Umgebung, die auf Amazon Elastic Compute Cloud (Amazon EC2) ausgeführt wird, stellt Elastic Beanstalk die folgenden Ressourcen bereit:

    • EC2-Instance — Eine virtuelle Amazon EC2-Maschine, die für die Ausführung von Webanwendungen auf der von Ihnen ausgewählten Plattform konfiguriert ist.

      Jede Plattform führt eine spezifische Gruppe von Software, Konfigurationsdateien und Skripts zur Unterstützung einer bestimmten Sprachversion, eines Frameworks, Webcontainers oder einer Kombination daraus aus. Die meisten Plattformen verwenden entweder Apache oder NGINX als Reverse-Proxy, der vor der Web-App platziert ist, Anforderungen weiterleitet, statische Komponenten bedient und Zugriffs- und Fehlerprotokolle generiert.

    • Instance security group (Instance-Sicherheitsgruppe): Eine Amazon EC2-Sicherheitsgruppe, die so konfiguriert ist, dass eingehender Datenverkehr auf Port 80 erlaubt ist. Mit dieser Ressource kann HTTP-Datenverkehr vom Load Balancer die EC2-Instance mit Ihrer Web-App erreichen. Standardmäßig ist Datenverkehr auf anderen Ports nicht zulässig.

    • Load balancer security group (Load Balancer-Sicherheitsgruppe): Eine Amazon EC2-Sicherheitsgruppe, die so konfiguriert ist, dass eingehender Datenverkehr auf Port 80 erlaubt ist. Diese Ressource ermöglicht, dass HTTP-Datenverkehr aus dem Internet den Load Balancer erreicht. Standardmäßig ist Datenverkehr auf anderen Ports nicht zulässig.

    • Auto Scaling group (Auto Scaling-Gruppe) – Eine Auto Scaling-Gruppe, die so konfiguriert ist, dass sie eine Instance ersetzt, wenn diese beendet wird oder nicht verfügbar ist.

    • CloudWatch Amazon-Alarme — Zwei CloudWatch Alarme, die die Auslastung der Instances in Ihrer Umgebung überwachen und ausgelöst werden, wenn die Last zu hoch oder zu niedrig ist. Wenn ein Alarm ausgelöst wird, wird Ihre Auto Scaling-Gruppe nach oben oder nach unten skaliert.

  • Beanstalk Cluster — Für eine Umgebung, die auf Amazon EKS ausgeführt wird, stellt Elastic Beanstalk die folgenden Ressourcen bereit:

    • Amazon EKS-Cluster — Ein Amazon EKS-Cluster, den Elastic Beanstalk erstellt und betreibt. Umgebungen im selben Konto, die dieselben Subnetze verwenden, teilen sich einen Cluster.

    • Compute — Knotenkapazität, die vom Amazon EKS Auto Mode bereitgestellt wird. Dabei werden Knoten hinzugefügt und entfernt, sodass sie zu den im Cluster geplanten Anwendungsreplikaten passen.

    • IAM-Rollen — Die Cluster- und Node-Rollen, die Sie für Amazon EKS bereitstellen, und die Observability-Rolle, die Elastic Beanstalk verwendet, um die Metriken, Logs und Traces der Umgebung zu veröffentlichen.

    Weitere Informationen zu dieser Infrastruktur finden Sie unter. Beanstalk Cluster-Architektur

  • Load Balancer — Ein Load Balancer, der eingehende Anfragen auf Ihre Anwendung verteilt. Ein Load Balancer macht es auch überflüssig, Ihre Anwendung direkt dem Internet auszusetzen.

  • Amazon S3-Bucket – Ein Speicherort für Ihren Quellcode, Protokolle und andere Artefakte, die bei der Verwendung von Elastic Beanstalk erstellt werden.

  • CloudFormation Stack — Elastic Beanstalk verwendet CloudFormation es, um die Ressourcen in Ihrer Umgebung zu starten und Konfigurationsänderungen zu verbreiten. Die Ressourcen werden in einer Vorlage definiert, die Sie in der CloudFormation -Konsole anzeigen können.

  • Domainname — Ein Domainname, der im Formular zu Ihrer Web-App weitergeleitet wird. subdomain region.elasticbeanstalk.com.

    Sicherheit der Domain

    Um die Sicherheit Ihrer Elastic-Beanstalk-Anwendungen zu erhöhen, ist die Domain elasticbeanstalk.com in der Public Suffix List (PSL) registriert.

    Wenn Sie jemals vertrauliche Cookies im Standard-Domainnamen für Ihre Elastic Beanstalk-Anwendungen setzen müssen, empfehlen wir Ihnen, Cookies mit einem Präfix zu verwenden, um die Sicherheit zu erhöhen. __Host- Diese Vorgehensweise schützt Ihre Domain vor Cross-Site-Request-Forgery-Versuchen (CSRF). Weitere Informationen finden Sie auf der Set-Cookie Seite im Mozilla Developer Network.

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

Anmerkung

Der von Elastic Beanstalk erstellte Amazon S3-Bucket wird von den Umgebungen gemeinsam genutzt und beim Beenden einer Umgebung nicht gelöscht. Weitere Informationen finden Sie unter Verwenden von Elastic Beanstalk mit Amazon S3.

Schreiben einer einfachen Sinatra-Website

So können Sie eine Sinatra-Anwendung erstellen und bereitstellen:

  1. Erstellen Sie eine Konfigurationsdatei mit dem Namen config.ru und folgendem Inhalt.

    Beispiel config.ru
    require './helloworld'
run Sinatra::Application

  2. Erstellen Sie eine Ruby-Codedatei mit dem Namen helloworld.rb und folgendem Inhalt.

    Beispiel helloworld.rb
    require 'sinatra'
get '/' do
  "Hello World!"
end

  3. Erstellen Sie eine Gemfile-Datei mit folgendem Inhalt.

    Beispiel Gemfile
    source 'https://rubygems.org'
gem 'sinatra'
gem 'puma'

  4. Führen Sie die Bundle-Installation aus, um die Gemfile.lock zu generieren.

    Beispiel
    ~/eb-sinatra$ bundle install
Fetching gem metadata from https://rubygems.org/....
Resolving dependencies...
Using bundler 2.2.22
Using rack 2.2.3
...

  5. 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.

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

  6. Erstellen Sie eine Procfile-Datei mit folgendem Inhalt.

    Beispiel Procfile
    web: bundle exec puma -C /opt/elasticbeanstalk/config/private/pumaconf.rb

Bereitstellen der Anwendung

Erstellen Sie ein Quell-Bundle mit Ihren Quelldateien. Der folgende Befehl erstellt ein Quell-Bundle mit dem Namen sinatra-default.zip.

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

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

So stellen Sie ein Quell-Bundle bereit

  1. Öffnen Sie die Elastic Beanstalk-Konsole und wählen Sie in der Liste der Regionen Ihre aus. AWS-Region

  2. Wählen Sie im Navigationsbereich Environments (Umgebungen) aus und wählen Sie dann in der Liste den Namen Ihrer Umgebung aus.

  3. Wählen Sie auf der Umgebungsübersichtsseite die Option Upload and deploy (Hochladen und bereitstellen).

  4. Verwenden Sie das Dialogfeld auf dem Bildschirm, um das Quellpaket hochzuladen.

  5. Wählen Sie Deploy (Bereitstellen) aus.

  6. Wenn die Bereitstellung abgeschlossen ist, wählen Sie die Website-URL, um Ihre Website in einer neuen Registerkarte zu öffnen.

Bereinigen

Nachdem Sie die Arbeit mit dem Demo-Code abgeschlossen haben, können Sie Ihre Umgebung beenden. Elastic Beanstalk löscht alle zugehörigen AWS Ressourcen wie Amazon EC2-Instances, Datenbank-Instances, Load Balancer , Sicherheitsgruppen und Alarme.

Durch das Entfernen von Ressourcen wird die Elastic Beanstalk-Anwendung nicht gelöscht, sodass Sie jederzeit neue Umgebungen für Ihre Anwendung erstellen können.

Um Ihre Elastic Beanstalk-Umgebung von der Konsole aus zu beenden

  1. Öffnen Sie die Elastic Beanstalk-Konsole und wählen Sie in der Liste der Regionen Ihre aus. AWS-Region

  2. Wählen Sie im Navigationsbereich Environments (Umgebungen) aus und wählen Sie dann in der Liste den Namen Ihrer Umgebung aus.

  3. Klicken Sie auf Actions (Aktionen) und dann auf Terminate Environment (Umgebung beenden).

  4. Verwenden Sie das Dialogfeld auf dem Bildschirm, um die Beendigung der Umgebung zu bestätigen.

Nächste Schritte

Weitere Informationen über Sinatra finden Sie unter sinatrarb.com.

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. Die Elastic Beanstalk Command Line Interface (Elastic Beanstalk Befehlszeilenschnittstelle) (EB CLI) stellt benutzerfreundliche Befehle zum Erstellen, Konfigurieren und Bereitstellen von Anwendungen in Elastic Beanstalk-Umgebungen über die Befehlszeile bereit.

Sofern Sie planen, die Anwendung in einer Produktionsumgebung einzusetzen, konfigurieren Sie einen benutzerdefinierten Domainnamen für die Umgebung und aktivieren dann HTTPS für sichere Verbindungen.