Bereitstellen einer Laravel-Anwendung in Elastic Beanstalk

Laravel ist ein Open-Source-Framework model-view-controller (MVC) für PHP. Dieses Tutorial führt Sie durch den Prozess, eine Laravel-Anwendung zu generieren, sie in einer AWS Elastic Beanstalk Umgebung bereitzustellen und sie so zu konfigurieren, dass sie eine Verbindung zu einer Amazon Relational Database Service (Amazon RDS) -Datenbank-Instance herstellt.

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.

Laravel 6 erfordert PHP 7.2 oder höher. Außerde werden die PHP-Erweiterungen benötigt, die unter dem Thema Serveranforderungen in der offiziellen Laravel-Dokumentation aufgeführt sind. Folgen Sie den Anweisungen im Thema Einrichtung Ihrer PHP Entwicklungsumgebung für Elastic Beanstalk, um PHP und Composer zu installieren.

Weitere Informationen zu Support und Wartung von Laravel finden Sie im Thema Support-Richtlinie in der offiziellen Laravel-Dokumentation.

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.

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 Laravel und Erstellen einer Website

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

~$ composer create-project --prefer-dist laravel/laravel eb-laravel

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

Wenn Probleme bei der Installation von Laravel auftreten, gehen Sie zum Installationsthema in der offiziellen Dokumentation: https://laravel.com/docs/6.x.

Bereitstellen der Anwendung

Erstellen Sie mit den Dateien, die von Composer erstellt wurden, ein Quell-Bundle . Der folgende Befehl erstellt ein Quell-Bundle mit dem Namen laravel-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-laravel$ zip ../laravel-default.zip -r * .[^.]* -x "vendor/*"

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

Konfigurieren von Composer-Einstellungen

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

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

Damit die Anwendung Laravel im Stammverzeichnis verwendet werden kann, konfigurieren Sie mit der Elastic Beanstalk-Konsole das Dokumentenstammverzeichnis der Website.

So weit, so gut. Jetzt fügen Sie eine Datenbank zu Ihrer Umgebung hinzu und konfigurieren eine Verbindung mit Laravel.

Hinzufügen einer Datenbank zu Ihrer Umgebung

Starten Sie eine RDS-DB-Instance in Ihrer Elastic Beanstalk-Umgebung. Sie können in Elastic Beanstalk MySQL-, SQLServer- oder PostgreSQL-Datenbanken für Laravel verwenden. In diesem Beispiel wird MySQL verwendet.

Das Erstellen einer Datenbank-Instance dauert ca. zehn Minuten. Weitere Informationen zu Datenbanken, die mit einer Elastic-Beanstalk-Umgebung gekoppelt sind, finden Sie unter Hinzufügen einer Datenbank zu Ihrer Elastic Beanstalk-Umgebung.

In der Zwischenzeit können Sie Ihren Quell-Code aktualisieren, um Verbindungsinformationen aus der Umgebung zu lesen. Elastic Beanstalk bietet Verbindungsdetails mithilfe von Umgebungsvariablen an, wie z. B. RDS_HOSTNAME, auf die Sie in Ihrer Anwendung zugreifen können.

Die Laravel-Datenbankkonfiguration ist in einer Datei mit dem Namen database.php im config-Ordner im Projektcode gespeichert. Suchen Sie den Eintrag mysql und ändern Sie die Variablen host, database, username und and password, damit sie die entsprechenden Werte aus Elastic Beanstalk lesen:

...
    'connections' => [

        'sqlite' => [
            'driver' => 'sqlite',
            'database' => env('DB_DATABASE', database_path('database.sqlite')),
            'prefix' => '',
        ],

        'mysql' => [
            'driver' => 'mysql',
            'host' => env('RDS_HOSTNAME', '127.0.0.1'),
            'port' => env('RDS_PORT', '3306'),
            'database' => env('RDS_DB_NAME', 'forge'),
            'username' => env('RDS_USERNAME', 'forge'),
            'password' => env('RDS_PASSWORD', ''),
            'unix_socket' => env('DB_SOCKET', ''),
            'charset' => 'utf8mb4',
            'collation' => 'utf8mb4_unicode_ci',
            'prefix' => '',
            'strict' => true,
            'engine' => null,
        ],
...

Um zu überprüfen, ob die Datenbankverbindung ordnungsgemäß konfiguriert ist, fügen Sie index.php den Code hinzu, um eine Verbindung zur Datenbank herzustellen und fügen Code zur Standardantwort hinzu:

...
if(DB::connection()->getDatabaseName())
{
   echo "Connected to database ".DB::connection()->getDatabaseName();
}
$response->send();
...

Wenn die DB-Instance den Start abgeschlossen hat, bündeln Sie die aktualisierte Anwendung und stellen Sie sie in Ihrer Umgebung bereit.

Die Bereitstellung einer neuen Version Ihrer Anwendung dauert weniger als eine Minute. Wenn die Bereitstellung abgeschlossen ist, aktualisieren Sie die Webseite erneut, um zu überprüfen, ob die Datenbankverbindung erfolgreich war:

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.

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

Außerdem können Sie Datenbankressourcen beenden, die außerhalb der Elastic Beanstalk-Umgebung erstellt wurden. Beim Beenden einer Amazon RDS-DB-Instance können Sie einen Snapshot erstellen und die Daten zu einem späteren Zeitpunkt in einer anderen Instance wiederherstellen.

Nächste Schritte

Weitere Informationen über Laravel finden Sie auf der offiziellen Laravel-Website unter laravel.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.

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

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

Das Ausführen einer Amazon RDS-DB-Instance in Ihrer Elastic Beanstalk-Umgebung eignet sich hervorragend für Entwicklung und Tests, sie bindet jedoch den Lebenszyklus Ihrer Datenbank an Ihre Umgebung. Anweisungen zum Herstellen einer Verbindung mit einer Datenbank, die außerhalb der Umgebung ausgeführt wird, finden Sie unter Hinzufügen einer Amazon RDS DB-Instance zu Ihrer PHP Elastic Beanstalk Beanstalk-Umgebung.

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.