Umgebungsvariablen und andere Softwareeinstellungen - AWS Elastic Beanstalk
Plattformspezifische Einstellungen konfigurierenKonfiguration von Umgebungseigenschaften (Umgebungsvariablen)Softwareeinstellung NamespacesZugreifen auf Umgebungseigenschaften

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.

Umgebungsvariablen und andere Softwareeinstellungen

Auf der Konfigurationsseite Updates, Überwachung und Protokollierung konfigurieren können Sie die Software auf den Amazon Elastic Compute Cloud (Amazon EC2) -Instances konfigurieren, auf denen Ihre Anwendung ausgeführt wird. Sie können Umgebungsvariablen, AWS X-Ray Debugging, Speichern und Streamen von Instance-Protokollen sowie plattformspezifische Einstellungen konfigurieren.

Themen

Plattformspezifische Einstellungen konfigurieren

Für die meisten Elastic Beanstalk-Plattformen können Sie neben den standardmäßigen Optionen für alle Umgebungen auch sprach- und Framework-spezifische Einstellungen festlegen. Diese werden im Abschnitt Plattformsoftware auf der Seite Aktualisierungen, Überwachung und Protokollierung konfigurieren angezeigt und können die folgenden Formen annehmen.

  • Vordefinierte Umgebungseigenschaften – Die Ruby-Plattform verwendet Umgebungseigenschaften für Framework-Einstellungen wie RACK_ENV und BUNDLE_WITHOUT.

  • Platzhalter-Umgebungseigenschaften – Die Tomcat-Plattform definiert eine Umgebungseigenschaft namens JDBC_CONNECTION_STRING, die keinen bestimmten Wert erhält. Solche Einstellungen waren auf älteren Plattformversionen gängiger.

  • Konfigurationsoptionen – Die meisten Plattformen legen Konfigurationsoptionen in plattformspezifischen oder freigegebenen Namespaces wie aws:elasticbeanstalk:xray oder aws:elasticbeanstalk:container:python fest.

So konfigurieren Sie plattformspezifische Einstellungen in der Elastic Beanstalk-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, 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. Nehmen Sie unter Plattformsoftware die erforderlichen Änderungen an der Optionseinstellung vor.

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

Informationen zu den plattformspezifischen Optionen und zum Abrufen von Umgebungseigenschaftswerten in Ihrem Code finden Sie im Thema zu Plattformen für Ihre Sprache bzw. Ihr Framework:

Konfiguration von Umgebungseigenschaften (Umgebungsvariablen)

Sie können Umgebungseigenschaften (auch als Umgebungsvariablen bezeichnet) verwenden, um Endpunkte, Debug-Einstellungen und andere Informationen an Ihre Anwendung zu übergeben. Umgebungsvariablen helfen Ihnen dabei, Ihre Anwendung in mehreren Umgebungen für unterschiedliche Zwecke wie Entwicklung, Testen, Staging und Produktion auszuführen.

Wenn Sie Ihrer Umgebung eine Datenbank hinzufügen, legt Elastic Beanstalk außerdem Umgebungsvariablen fest, die Sie beispielsweise in Ihrem Anwendungscode lesen könnenRDS_HOSTNAME, um ein Verbindungsobjekt oder eine Verbindungszeichenfolge zu erstellen.

So konfigurieren Sie Umgebungsvariablen in der Elastic Beanstalk Beanstalk-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, 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. Scrollen Sie nach unten zu Runtime-Umgebungsvariablen.

  6. Wählen Sie Umgebungsvariable hinzufügen aus.

  7. Wählen Sie als Quelle die Option Klartext aus.

    Anmerkung

    Die Werte Secrets Manager und SSM Parameter Store in der Drop-down-Liste dienen zur Konfiguration von Umgebungsvariablen als Secrets zum Speichern sensibler Daten wie Anmeldeinformationen und API-Schlüssel. Weitere Informationen finden Sie unter Elastic Beanstalk mit AWS Secrets Manager und AWS Systems Manager Parameter Store verwenden.

  8. Geben Sie den Namen der Umgebungsvariablen und die Wertepaare der Umgebungsvariablen ein.

  9. Wenn Sie weitere Variablen hinzufügen müssen, wiederholen Sie Schritt 6 bis Schritt 8.

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

Beschränkungen von Umgebungseigenschaften

  • Schlüssel dürfen beliebige alphanumerische Zeichen sowie die folgenden Symbole enthalten: _ . : / + \ - @

    Die aufgeführten Symbole gelten für Umgebungseigenschaftsschlüssel, möglicherweise aber nicht für Umgebungsvariablennamen auf der Plattform Ihrer Umgebung. Wenn Sie sicherstellen möchten, dass Ihre Umgebungsvariablen mit allen Plattformen kompatibel sind, beschränken Sie sich auf folgendes Muster: [A-Z_][A-Z0-9_]*

  • Werte dürfen beliebige alphanumerische Zeichen, Leerzeichen sowie die folgenden Symbole enthalten: _ . : / = + \ - @ ' "

    Anmerkung

    Einige Zeichen in Umgebungseigenschaftswerten müssen durch das Escape-Zeichen geschützt werden. Verwenden Sie den umgekehrten Schrägstrich (\), um einige Sonderzeichen und Steuerzeichen darzustellen. Die folgende Liste enthält Beispiele für die Darstellung einiger Zeichen, die durch das Escape-Zeichen geschützt werden müssen:

    • umgekehrter Schrägstrich (\) – zur Darstellung \\ verwenden

    • einzelnes Anführungszeichen (') – zur Darstellung \' verwenden

    • doppeltes Anführungszeichen (") – zur Darstellung \" verwenden

  • Bei Schlüsseln und Werten wird die Groß-/Kleinschreibung berücksichtigt.

  • Die Gesamtgröße aller Umgebungseigenschaften darf 4.096 Byte nicht überschreiten, wenn sie als Zeichenfolgen im Format key = gespeichert werden. value

Softwareeinstellung Namespaces

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 mit den Konfigurationsdateien von Elastic Beanstalk Umgebungseigenschaften und Konfigurationsoptionen in Ihrem Quellcode festlegen. Verwenden Sie den aws:elasticbeanstalk:application:environmentNamespace, um Umgebungseigenschaften zu definieren.

Beispiel .ebextensions/options.config
option_settings:
  aws:elasticbeanstalk:application:environment:
    API_ENDPOINT: www.example.com/api

Wenn Sie Konfigurationsdateien oder AWS CloudFormation Vorlagen verwenden, um benutzerdefinierte Ressourcen zu erstellen, können Sie eine AWS CloudFormation Funktion verwenden, um Informationen über die Ressource abzurufen und sie während der Bereitstellung dynamisch einer Umgebungseigenschaft zuzuweisen. Das folgende Beispiel aus dem elastic-beanstalk-samples GitHub Repository verwendet die Ref-Funktion, um den ARN eines Amazon SNS SNS-Themas abzurufen, das es erstellt, und weist es einer Umgebungseigenschaft mit dem Namen zu. NOTIFICATION_TOPIC

Hinweise

  • Wenn Sie eine AWS CloudFormation Funktion verwenden, um eine Umgebungseigenschaft zu definieren, zeigt die Elastic Beanstalk Beanstalk-Konsole den Wert der Eigenschaft an, bevor die Funktion ausgewertet wird. Sie können das get-config-Plattformskript verwenden, um die Werte der Umgebungseigenschaften zu bestätigen, die für Ihre Anwendung verfügbar sind.

  • Die Multicontainer Docker-Plattform wird nicht zur Erstellung von Container-Ressourcen verwendet AWS CloudFormation . Daher unterstützt diese Plattform die Definition von Umgebungseigenschaften mithilfe AWS CloudFormation von Funktionen nicht.

Beispiel .Ebextensions/sns-topic.config
Resources:
  NotificationTopic:
    Type: AWS::SNS::Topic

option_settings:
  aws:elasticbeanstalk:application:environment:
    NOTIFICATION_TOPIC: '`{"Ref" : "NotificationTopic"}`'

Sie können mithilfe dieses Features auch Informationen aus AWS CloudFormation -Pseudoparametern bereitstellen. In diesem Beispiel wird die derzeitige Region abgerufen und einer Eigenschaft namens AWS_REGION zugewiesen.

Beispiel .Ebextensions/env-regionname.config
option_settings:
  aws:elasticbeanstalk:application:environment:
    AWS_REGION: '`{"Ref" : "AWS::Region"}`'

Die meisten Elastic Beanstalk-Plattformen definieren zusätzliche Namespaces mit Optionen zur Konfiguration von Software, die auf der Instance ausgeführt wird, wie den Reverse-Proxy, der Anforderungen an Ihre Anwendung weiterleitet. Weitere Informationen zu den für Ihre Plattform verfügbaren Namespaces finden Sie unter:

Elastic Beanstalk bietet zahlreiche Konfigurationsoptionen für die Anpassung Ihrer Umgebung. Neben den Konfigurationsdateien können Sie die Konfigurationsoptionen auch unter Verwendung der Konsole, gespeicherter Konfigurationen, der EB CLI oder der AWS CLI einrichten. Weitere Informationen finden Sie unter Konfigurationsoptionen.

Zugreifen auf Umgebungseigenschaften

In den meisten Fällen können Sie in Ihrem Anwendungscode auf Umgebungseigenschaften wie Umgebungsvariablen zugreifen. In der Regel werden Umgebungseigenschaften jedoch nur an die Anwendung übergeben und können nicht angezeigt werden, indem Sie sich mit einer Instance in Ihrer Umgebung verbinden und env ausführen.

  • Go – os.Getenv

    endpoint := os.Getenv("API_ENDPOINT")

  • Java SE – System.getenv

    String endpoint = System.getenv("API_ENDPOINT");

  • Tomcat — System.getProperty und System.getenv

    Tomcat-Plattformversionen, die am oder nach dem 26. März 2025 veröffentlicht wurden, können auch für den System.getenv Zugriff auf Klartext-Umgebungsvariablen verwendet werden. Sie können es weiterhin für den Zugriff System.getProperty auf Klartext-Umgebungsvariablen verwenden. Umgebungsvariablen, die als Geheimnisse gespeichert sind, sind jedoch nur über System.getenv verfügbar.

    String endpoint = System.getProperty("API_ENDPOINT");
    String endpoint = System.getenv("API_ENDPOINT");
    Wichtig

    Der zusätzliche System.getenv Zugriff auf Umgebungsvariablen in Versionen der Tomcat-Plattform, die am oder nach dem 26. März 2025 veröffentlicht wurden, kann zu unerwartetem Verhalten in Anwendungen führen, die Umgebungsvariablen Vorrang vor Java-Systemeigenschaften geben, oder wenn explizit von System.getProperty zu gewechselt wird. System.getenv Weitere Informationen und Handlungsempfehlungen finden Sie unter Verwenden der Elastic Beanstalk Tomcat-Plattform.

  • .NET Core unter Linux – Environment.GetEnvironmentVariable

    string endpoint = Environment.GetEnvironmentVariable("API_ENDPOINT");

  • .NET – appConfig

    NameValueCollection appConfig = ConfigurationManager.AppSettings;
string endpoint = appConfig["API_ENDPOINT"];

  • Node.js – process.env

    var endpoint = process.env.API_ENDPOINT

  • PHP – $_SERVER

    $endpoint = $_SERVER['API_ENDPOINT'];

  • Python – os.environ

    import os
endpoint = os.environ['API_ENDPOINT']

  • Ruby – ENV

    endpoint = ENV['API_ENDPOINT']

Außerhalb des Anwendungscodes, beispielsweise in Skripten, die während der Bereitstellung ausgeführt werden, können Sie auf Umgebungseigenschaften mit dem get-config-Plattformskript zugreifen. Im elastic-beanstalk-samples GitHub Repository finden Sie Beispielkonfigurationen, die verwenden. get-config