Verwenden der Elastic Beanstalk Node.js-Plattform

In diesem Thema wird beschrieben, wie Sie Ihre Node.js -Anwendungen auf Elastic Beanstalk konfigurieren, erstellen und ausführen.

AWS Elastic Beanstalk unterstützt eine Reihe von Plattformzweigen für verschiedene Versionen der Programmiersprache Node.js. Eine vollständige Liste finden Sie unter Node.js im Dokument AWS Elastic Beanstalk Platforms.

Elastic Beanstalk bietet Konfigurationsoptionen, mit denen Sie die Software anpassen können, die auf dem EC2 Instanzen in Ihrer Elastic Beanstalk Beanstalk-Umgebung. Sie können die von Ihrer Anwendung benötigten Umgebungsvariablen konfigurieren, die Protokollrotation an Amazon S3 aktivieren und die Ordner in der Anwendungsquelle, die statische Dateien enthalten, den vom Proxy-Server verwendeten Pfaden zuordnen.

In der Elastic Beanstalk-Konsole sind Konfigurationsoptionen für das Ändern der Konfiguration einer ausgeführten Umgebung verfügbar. Um zu verhindern, dass die Umgebungskonfiguration beim Beenden verloren geht, können Sie gespeicherte Konfigurationen verwenden, um Ihre Einstellungen zu speichern und sie später für eine andere Umgebung zu übernehmen.

Zum Speichern der Einstellungen im Quellcode können Sie Konfigurationsdateien einschließen. Die Einstellungen in Konfigurationsdateien werden jedes Mal verwendet, wenn Sie eine Umgebung erstellen oder Ihre Anwendung bereitstellen. Mit Konfigurationsdateien können Sie auch Pakete installieren, Skripts ausführen und andere Instance-Anpassungen bei Bereitstellungen vornehmen.

Sie können Ihrem Quellpaket eine Package.json Datei hinzufügen, um Pakete während der Bereitstellung zu installieren, einen Startbefehl bereitzustellen und die Node.js Version, die Ihre Anwendung verwenden soll. Sie können eine -Datei npm-shrinkwrap.json aufnehmen, um Abhängigkeitsversionen zu sperren.

Das Tool Node.js Die Plattform umfasst einen Proxyserver, der statische Ressourcen bereitstellt, Datenverkehr an Ihre Anwendung weiterleitet und Antworten komprimiert. Sie können die für erweiterte Szenarien Proxy-Standardkonfiguration erweitern oder überschreiben.

Es gibt verschiedene Möglichkeiten, um Ihre Anwendung zu starten. Sie können eine hinzufügen Procfilezu Ihrem Quellpaket, um den Befehl anzugeben, mit dem Ihre Anwendung gestartet wird. Wenn Sie kein Procfile bereitstellen, aber stattdessen eine package.json-Datei verfügbar machen führt Elastic Beanstalk npm start aus. Wenn Sie auch dies nicht angeben, sucht Elastic Beanstalk die Datei von app.js oder server.js (in dieser Reihenfolge) und führt das Script aus.

Die in der Elastic Beanstalk-Konsole angewendeten Einstellungen überschreiben die entsprechenden Einstellungen in Konfigurationsdateien, falls vorhanden. So sind Standardeinstellungen in Konfigurationsdateien möglich, die Sie mit umgebungsspezifischen Einstellungen in der Konsole überschreiben können. Für weitere Informationen zur Rangfolge und zu anderen Methoden zum Ändern der Einstellungen siehe Konfigurationsoptionen.

Details zu den verschiedenen Möglichkeiten für das Erweitern einer Linux-basierten Elastic Beanstalk-Plattform finden Sie unter Erweitern von Elastic Beanstalk-Linux-Plattformen.

Konfiguration Ihres Node.js Umgebung

Sie können das Node.js Plattformeinstellungen zur Feinabstimmung des Verhaltens Ihrer EC2 Amazon-Instances. Sie können die EC2 Amazon-Instance-Konfiguration für Ihre Elastic Beanstalk Beanstalk-Umgebung mithilfe der Elastic Beanstalk Beanstalk-Konsole bearbeiten.

Mithilfe der Elastic Beanstalk-Konsole aktivieren Sie die Protokollrotation an Amazon S3 und konfigurieren Variablen, die die Anwendung aus der Umgebung auslesen kann.

Containeroptionen

Sie können die folgenden plattformspezifischen Optionen angeben:

Protokolloptionen

Im Abschnitt mit den Protokolloptionen sind zwei Einstellungen vorhanden:

Statische Dateien

Um die Leistung zu verbessern, können Sie den Abschnitt Statische Dateien verwenden, um den Proxy-Server so zu konfigurieren, dass statische Dateien (z. HTML B. Bilder) aus einer Reihe von Verzeichnissen in Ihrer Webanwendung bereitgestellt werden. Legen Sie für jedes Verzeichnis den virtuellen Pfad zum Verzeichnis-Mapping fest. Wenn der Proxy-Server eine Anfrage nach einer Datei unter dem angegebenen Pfad erhält, stellt er die Datei direkt bereit, anstatt die Anfrage an Ihre Anwendung weiterzuleiten.

Weitere Informationen zum Konfigurieren statischer Dateien mit der Elastic Beanstalk-Konsole finden Sie unter Bereitstellen von statischen Dateien.

Umgebungseigenschaften

Verwenden Sie den Abschnitt Umgebungseigenschaften, um die Umgebungskonfigurationseinstellungen für die EC2 Amazon-Instances anzugeben, auf denen Ihre Anwendung ausgeführt wird. Diese Einstellungen werden als Schlüsselwert-Paare an die Anwendung weitergeleitet.

Innerhalb des Node.js In der Umgebung, in der Sie ausgeführt werden AWS Elastic Beanstalk, können Sie auf die Umgebungsvariablen zugreifen, indem Sie Folgendes ausführenprocess.env.ENV_VARIABLE.

var endpoint = process.env.API_ENDPOINT

Das Tool Node.js Die Plattform legt die fest PORT Umgebungsvariable für den Port, an den der Proxyserver den Verkehr weiterleitet. Weitere Informationen finden Sie unter Konfigurieren des Proxy-Server.

Weitere Informationen finden Sie unter Umgebungseigenschaften und andere Softwareeinstellungen.

Node.js Konfigurations-Namespace

Mithilfe einer Konfigurationsdatei können Sie im Rahmen der Bereitstellung Konfigurationsoptionen festlegen und andere Instance-Konfigurationsaufgaben durchführen. Die Konfigurationsoptionen können plattformspezifisch sein oder für alle Plattformen im Elastic Beanstalk-Service als Ganzes gelten. Die Konfigurationsoptionen sind in Namespaces organisiert.

Sie können mittels des Namespace aws:elasticbeanstalk:environment:proxy den Proxy auswählen, der für die Instances Ihrer Umgebung verwendet werden soll. Im folgenden Beispiel wird Ihre Umgebung für die Verwendung von konfiguriert Apache HTTPD Proxyserver.

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: apache

Sie können den Proxy so konfigurieren, dass statische Dateien mittels des Namespace aws:elasticbeanstalk:environment:proxy:staticfiles bereitgestellt werden. Weitere Informationen sowie ein Beispiel finden Sie unter Bereitstellen von statischen Dateien.

Elastic Beanstalk bietet zahlreiche Konfigurationsoptionen für die Anpassung Ihrer Umgebung. Zusätzlich zu den Konfigurationsdateien können Sie Konfigurationsoptionen auch über die Konsole, gespeicherte Konfigurationen, den EB CLI oder den festlegen AWS CLI. Weitere Informationen finden Sie unter Konfigurationsoptionen.

var port = process.env.PORT || 8080;

app.listen(port, function() {
  console.log('Server running at http://127.0.0.1:%s', port);
});

option_settings:
  aws:elasticbeanstalk:container:nodejs: 
    NodeCommand: "npm start"
    ProxyServer: apache
    GzipCompression: true
  aws:elasticbeanstalk:container:nodejs:staticfiles:
    /html: statichtml
    /images: staticimages