View a markdown version of this page

Erweiterte Anpassung der Umgebung mit Konfigurationsdateien (.ebextensions) - AWS Elastic Beanstalk

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.

Erweiterte Anpassung der Umgebung mit Konfigurationsdateien (.ebextensions)

Sie können dem Quellcode Ihrer Webanwendung AWS Elastic Beanstalk Konfigurationsdateien (.ebextensions) hinzufügen, um Ihre Umgebung zu konfigurieren und die darin enthaltenen AWS Ressourcen anzupassen. Konfigurationsdateien sind YAML- oder JSON-formatted Dokumente mit einer .config Dateierweiterung, die Sie in einem Ordner ablegen, der in Ihrem Anwendungsquellpaket benannt .ebextensions und bereitgestellt wird.

Beispiel
. ebextensions/network-load-Balancer.config

In diesem Beispiel wird eine einfache Konfigurationsänderung vorgenommen. Es wird eine Konfigurationsoption geändert, um den Typ des Load Balancers Ihrer Umgebung auf „Network Load Balancer“ festzulegen.

option_settings:
  aws:elasticbeanstalk:environment:
    LoadBalancerType: network

Wir empfehlen die Verwendung von YAML für Konfigurationsdateien, da das Format besser lesbar ist als JSON. YAML unterstützt Kommentare, mehrzeilige Befehle, verschiedene Alternativen für Anführungszeichen und vieles mehr. Sie können jedoch alle Konfigurationsänderungen in Elastic Beanstalk-Konfigurationsdateien gleichermaßen mit YAML oder JSON vornehmen.

Anmerkung

Konfigurationsdateien gelten nur für Beanstalk Standard-Umgebungen. Sie passen die Amazon EC2-Instances an, auf denen Ihre Anwendung ausgeführt wird, was in einer Beanstalk Cluster-Umgebung nicht der Fall ist. Installieren Sie mit Beanstalk Cluster die Abhängigkeiten Ihrer Anwendung im Container-Image, entweder in Ihrem Dockerfile oder in der Quelle, die Elastic Beanstalk erstellt, und legen Sie die Konfigurationsoptionen mit oder in der Konsole fest. --option-settings Siehe Erstellen von Container-Images für Beanstalk Cluster-Umgebungen und Konfigurationsoptionen für Beanstalk Cluster-Umgebungen.

Tipp

Für die Entwicklung und die Testphase neuer Konfigurationsdateien starten Sie eine bereinigte Umgebung, auf der die Standardanwendung ausgeführt wird, und stellen diese dort bereit. Schlecht formatierte Konfigurationsdateien führen dazu, dass eine neue Umgebung nicht gestartet werden kann und nicht wiederherstellbar ist.

Im Abschnitt option_settings der Konfigurationsdatei werden die Werte für Konfigurationsoptionen definiert. Mit den Konfigurationsoptionen können Sie Ihre Elastic Beanstalk-Umgebung, die darin enthaltenen AWS Ressourcen und die Software, auf der Ihre Anwendung ausgeführt wird, konfigurieren. Konfigurationsdateien sind nur eine von mehreren Möglichkeiten zum Festlegen von Konfigurationsoptionen.

ResourcesIn diesem Abschnitt können Sie die Ressourcen in der Umgebung Ihrer Anwendung weiter anpassen und zusätzliche AWS Ressourcen definieren, die über die in den Konfigurationsoptionen bereitgestellten Funktionen hinausgehen. Sie können alle Ressourcen hinzufügen und konfigurieren AWS CloudFormation, die Elastic Beanstalk zur Erstellung von Umgebungen verwendet.

In den anderen Abschnitten einer Konfigurationsdatei (packages, sources, files, users, groups, commands, container_commands und services) können Sie die EC2-Instances konfigurieren, die in der Umgebung gestartet werden. Jedes Mal, wenn ein Server in der Umgebung gestartet wird, führt Elastic Beanstalk die in diesen Abschnitten definierten Vorgänge aus, um das Betriebs- und das Speichersystem für die Anwendung vorzubereiten.

Beispiele für häufig verwendete .ebextensions finden Sie im Elastic Beanstalk-Konfigurationsdateien-Repository.

Voraussetzungen

  • Standort — Elastic Beanstalk verarbeitet alle in Ihrer Bereitstellung vorhandenen .ebextensions Ordner. Wir empfehlen jedoch, dass Sie alle Ihre Konfigurationsdateien in einem einzigen Ordner mit dem Namen .ebextensions im Stammverzeichnis Ihres Quellpakets speichern. Verzeichnisse, die mit einem Punkt beginnen, können von Dateibrowsern ausgeblendet werden. Stellen Sie daher sicher, dass das Verzeichnis beim Erstellen des Quell-Bundles angelegt wird. Weitere Informationen finden Sie unter Erstellen Sie ein Elastic Beanstalk-Anwendungsquellpaket.

  • Naming (Namensgebung) – Konfigurationsdateien müssen die Dateiendung .config haben.

  • Formatting (Format) – Konfigurationsdateien müssen den YAML- oder JSON-Spezifikationen entsprechen.

    Bei Verwendung von YAML immer Leerzeichen verwenden, um Schlüssel in den verschiedenen Verschachtelungsebenen einzurücken. Weitere Informationen zu YAML finden Sie unter YAML Ain't Markup Language (YAML™) Version 1.1.

  • Uniqueness (Eindeutigkeit) – Verwenden Sie jeden Schlüssel in jeder Konfigurationsdatei nur einmal.

    Warning

    Wenn Sie einen Schlüssel (z. B. option_settings) innerhalb einer Konfigurationsdatei mehrfach verwenden, wird einer der Abschnitte gelöscht. Kombinieren Sie doppelte Abschnitte in einem Abschnitt oder platzieren Sie diese in separaten Konfigurationsdateien.

Der Prozess für die Bereitstellung kann je nach dem Client, der für die Umgebungsverwaltung verwendet wird, unterschiedlich sein. Ausführliche Informationen finden Sie in den folgenden Abschnitten:

Themen