Erweiterte Umgebungsanpassung 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 Umgebungsanpassung 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 Dokumente im YAML- oder JSON-Format mit einer .config Dateierweiterung, die Sie in einem Ordner mit dem Namen Ihres Anwendungsquellpakets .ebextensions ablegen und dort bereitstellen.

Beispiel
.ebextensions/ .config network-load-balancer

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.

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 Beanstalk-Umgebung, die darin AWS enthaltenen Ressourcen und die Software, mit 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 von Elastic Beanstalk unterstützt werden und 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 .ebextensions Ordner, die in Ihrem Deployment vorhanden sind. Wir empfehlen jedoch, dass Sie alle Ihre Konfigurationsdateien in einem einzigen Ordner mit dem Namen .ebextensions „Root“ im Stammverzeichnis Ihres Quellpakets ablegen. 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 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.

    Warnung

    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