Bereitstellen einer Symfony-Anwendung in Elastic Beanstalk

Symfony ist ein Open-Source-Framework für die Entwicklung dynamischer PHP-Webanwendungen. Dieses Tutorial führt Sie durch den Prozess der Generierung einer Symfony-Anwendung und deren Bereitstellung in einer AWS Elastic Beanstalk Umgebung.

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 Erste Schritte mit Elastic Beanstalk 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-integrierte Version von Ubuntu und Bash zu erhalten.

Symfony 4.4.9 setzt PHP 7.1.3 oder höher voraus. Es benötigt auch die PHP-Erweiterungen, die unter dem Thema Technische Anforderungen in der offiziellen Symfony-Installationsdokumentation aufgeführt sind. In diesem Tutorial verwenden wir PHP 7.2 und die entsprechende Elastic Beanstalk-Plattformversion. Installieren Sie gemäß den Anweisungen im Thema Einrichten der PHP-Entwicklungsumgebung, PHP und Composer.

Weitere Informationen zu Support und Wartung von Symfony finden Sie im Thema Symfony-Versionen auf der Symfony-Website. Weitere Informationen zu Updates im Zusammenhang mit der Unterstützung der PHP-Version für Symfony 4.4.9 finden Sie im Thema Versionshinweise zu Symfony 4.4.9 auf der Symfony-Website.

Starten einer Elastic Beanstalk-Umgebung

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

So starten Sie eine Umgebung (Konsole)

1. Öffnen Sie die Elastic Beanstalk Beanstalk-Konsole über diesen vorkonfigurierten Link: console.aws.amazon.com/elasticbeanstalk/home#/ newApplication?applicationName=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:

• EC2 instance (EC2-Instance) – eine virtuelle Maschine von Amazon Elastic Compute Cloud (Amazon EC2), die so konfiguriert ist, dass Web-Apps auf der von Ihnen ausgewählten Plattform ausgeführt werden.

  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 (Load Balancer)– Ein Elastic Load Balancing Load Balancer ist für die Verteilung von Anforderungen an die Instances, auf denen Ihre Anwendung ausgeführt wird, konfiguriert. Mit einem Load Balancer müssen Ihre Instances nicht mehr direkt für das Internet zugänglich gemacht werden.

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

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

• CloudWatch CloudWatch Amazon-Alarme — Zwei 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.

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

• Domainname – Ein Domainname, der auf Ihre Web-App in der Form subdomain.region.elasticbeanstalk.com weiterleitet.

  Anmerkung

  Um die Sicherheit Ihrer Elastic-Beanstalk-Anwendungen zu erhöhen, ist die Domain elasticbeanstalk.com in der Public Suffix List (PSL) registriert. Aus Sicherheitsgründen empfehlen wir Ihnen, Cookies mit einem __Host--Präfix zu verwenden, falls Sie jemals sensible Cookies im Standard-Domainnamen für Ihre Elastic-Beanstalk-Anwendungen einrichten müssen. Diese Vorgehensweise hilft Ihnen dabei, Ihre Domain vor CSRF-Versuchen (Cross-Site Request Forgery Attempts, Anforderungsfälschung zwischen Websites) zu schützen. 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.

Installieren von Symfony und Generieren einer Website

Composer kann Symfony installieren und ein Arbeitsprojekt mit einem Befehl erstellen:

~$ composer create-project symfony/website-skeleton eb-symfony

Composer installiert Symfony und seine Abhängigkeiten und generiert ein Standardprojekt.

Wenn Probleme bei der Installation von Symfony auftreten, rufen Sie das Thema Installation in der offiziellen Symfony-Dokumentation auf.

Bereitstellen der Anwendung

Rufen Sie das Projektverzeichnis auf.

~$ cd eb-symfony

Erstellen Sie mit den Dateien, die von Composer erstellt wurden, ein Quell-Bundle . Der folgende Befehl erstellt ein Quell-Bundle mit dem Namen symfony-default.zip. Die Dateien im Ordner vendor werden ausgeschlossen, weil sie viel Platz benötigen und zum Bereitstellen der Anwendung für Elastic Beanstalk nicht erforderlich sind.

eb-symfony$ zip ../symfony-default.zip -r * .[^.]* -x "vendor/*"

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

So stellen Sie ein Quell-Bundle bereit

1. Öffnen Sie die Elastic Beanstalk Beanstalk-Konsole und wählen Sie in der Liste 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.

   Anmerkung

   Wenn Sie viele Umgebungen haben, verwenden Sie die Suchleiste, um die Umgebungsliste zu filtern.

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.

Anmerkung

Um das Quell-Bundle weiter zu optimieren, initialisieren Sie ein Git-Repository und verwenden den Befehl git archive, um das Quell-Bundle zu erstellen. Das Symfony-Standardprojekt enthält eine .gitignore-Datei, die Git anweist, den Ordner vendor sowie andere Dateien auszuschließen, die für die Bereitstellung nicht benötigt werden.

Konfigurieren von Composer-Einstellungen

Klicken Sie nach Abschluss der Bereitstellung auf die URL, um die Symfony-Anwendung im Browser zu öffnen.

Was ist das? Standardmäßig bedient Elastic Beanstalk das Stammverzeichnis Ihres Projekts im Stammpfad der Website. In diesem Fall liegt die Standardseite (app.php) jedoch eine Ebene weiter unten im web-Ordner. Das können Sie überprüfen, indem Sie /public zur URL hinzufügen. z. B. http://symfony.us-east-2.elasticbeanstalk.com/public.

Damit die Anwendung Symfony vom Stammverzeichnis aus genutzt werden kann, konfigurieren Sie mit der Elastic Beanstalk-Konsole das Dokumentenstammverzeichnis für die Website.

So konfigurieren Sie das Stammverzeichnis Ihrer Website

1. Öffnen Sie die Elastic Beanstalk Beanstalk-Konsole und wählen Sie in der Liste 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.

   Anmerkung

   Wenn Sie viele Umgebungen haben, verwenden Sie die Suchleiste, um die Umgebungsliste zu filtern.

3. Wählen Sie im Navigationsbereich Configuration (Konfiguration) aus.

4. Wählen Sie in der Konfigurationskategorie Updates, monitoring and logging  (Updates, Überwachung und Protokolle) die Option Edit (Bearbeiten) aus.

5. Geben Sie für Document root (Basisverzeichnis) /public ein.

6. Wählen Sie unten auf der Seite die Option Apply (Anwenden) aus, um die Änderungen zu speichern.

7. Wenn die Aktualisierung abgeschlossen ist, klicken Sie auf die URL, um Ihre Website erneut im Browser zu öffnen.

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 Amazon EC2 EC2-Instances, Datenbank-Instances, Load Balancer, Sicherheitsgruppen und Alarme.

So beenden Sie Ihre Elastic Beanstalk Beanstalk-Umgebung über die Konsole

1. Öffnen Sie die Elastic Beanstalk Beanstalk-Konsole und wählen Sie in der Liste 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.

   Anmerkung

   Wenn Sie viele Umgebungen haben, filtern Sie Umgebungsliste mit der Suchleiste.

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.

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

Nächste Schritte

Weitere Informationen über Symfony finden Sie in Was ist Symfony? unter symfony.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 (EB CLI) bietet easy-to-use Befehle zum Erstellen, Konfigurieren und Bereitstellen von Anwendungen in Elastic Beanstalk Beanstalk-Umgebungen von der Befehlszeile aus.

In diesem Tutorial haben Sie die Composer-Optionen mit der Elastic Beanstalk-Konsole konfiguriert. Um diese Konfiguration zum Teil der Anwendungsquelle zu machen, können Sie eine Konfigurationsdatei wie diese verwenden.

Beispiel .ebextensions/composer.config

option_settings:
  aws:elasticbeanstalk:container:php:phpini:
    document_root: /public

Weitere Informationen finden Sie unter Erweiterte Umgebungsanpassung mit Konfigurationsdateien (.ebextensions).

Symfony verwendet eigener Konfigurationsdateien zum Konfigurieren von Datenbankverbindungen. Zum Abrufen bestimmter PHP-Paketversionen, die der Version auf Ihrer Elastic Beanstalk PHP-Plattformversion entsprechen, suchen Sie unter Homebrew Formulae verfügbare PHP-Versionen, wie z. B. Verbinden mit einer Datenbank mit Symfony.

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.