Umgebungseigenschaften und andere Softwareeinstellungen

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

Themen

• Plattformspezifische Einstellungen konfigurieren
• Konfiguration von Umgebungseigenschaften (Umgebungsvariablen)
• Softwareeinstellung Namespaces
• Zugreifen auf Umgebungseigenschaften
• Konfigurieren des AWS X-Ray-Debuggings
• Anzeigen Ihrer Elastic Beanstalk-Umgebungsprotokolle

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 Regionenliste Ihre 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:

• Docker – Konfiguration von Elastic Beanstalk Docker-Umgebungen

• Go – Verwenden der Go-Plattform von Elastic Beanstalk

• Java SE – Elastic Beanstalk Java SE-Plattform verwenden

• Tomcat – Elastic Beanstalk Tomcat-Plattform verwenden

• . NETCore unter Linux — Verwenden von Elastic Beanstalk. NETCore auf der Linux-Plattform

• .NET – Verwenden von Elastic Beanstalk. NETWindows-Plattform

• Node.js – Verwenden der Elastic Beanstalk Node.js-Plattform

• PHP – Verwenden der PHP-Plattform von Elastic Beanstalk

• Python – Verwenden der Elastic Beanstalk Python-Plattform

• Ruby – Verwenden der Elastic Beanstalk-Ruby-Plattform

Konfiguration von Umgebungseigenschaften (Umgebungsvariablen)

Mithilfe von Umgebungseigenschaften, (auch bekannt als Umgebungsvariablen) können Sie Verschlüsselungen, Endpunkte, Debugging-Einstellungen und andere Informationen an Ihre Anwendung übergeben. Mithilfe von Umgebungseigenschaften können Sie Anwendungen zu unterschiedlichen Zwecken in mehreren Umgebungen ausführen, z. B. Entwicklung, Testing, Staging und Produktion.

Wenn Sie darüber hinaus eine Datenbank zu Ihrer Umgebung hinzufügen, legt Elastic Beanstalk Umgebungseigenschaften wie RDS_HOSTNAME fest, die Sie im Anwendungscode auslesen können, um ein Verbindungsobjekt oder eine Verbindungszeichenfolge zu erstellen.

Umgebungsvariablen

In den meisten Fällen werden Umgebungseigenschaften als Umgebungsvariablen übergeben, das Verhalten ist jedoch abhängig von der Plattform. Die Java SE-Plattform legt beispielsweise Umgebungsvariablen fest, die Sie mit System.getenv abrufen. Die Tomcat-Plattform dagegen legt Java-Systemeigenschaften fest, die Sie mit System.getProperty abrufen. Im Allgemeinen sind Eigenschaften nicht sichtbar, wenn Sie eine Verbindung zu einer Instance herstellen und env ausführen.

So konfigurieren Sie Umgebungseigenschaften in der Elastic Beanstalk-Konsole

1. Öffnen Sie die Elastic Beanstalk Beanstalk-Konsole und wählen Sie in der Regionenliste Ihre 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 den Umgebungseigenschaften.

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

7. Geben Sie die Eigenschaftspaare Name und Wert ein.

8. Wenn Sie weitere Variablen hinzufügen müssen, wiederholen Sie Schritt 6 und Schritt 7.

9. 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 Zeichenketten mit dem folgenden Format gespeichert werden key=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 verwenden oder AWS CloudFormation Vorlagen zum Erstellen benutzerdefinierter Ressourcen können Sie verwenden AWS CloudFormation Funktion, 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 das ARN von ihm erstellte SNS Amazon-Thema abzurufen und es einer Umgebungseigenschaft mit dem Namen NOTIFICATION_TOPIC zuzuweisen.

Hinweise

• Wenn Sie eine verwenden AWS CloudFormation Funktion zur Definition einer Umgebungseigenschaft. Die Elastic Beanstalk Beanstalk-Konsole zeigt 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 verwendet nicht AWS CloudFormation um Container-Ressourcen zu erstellen. Aus diesem Grund unterstützt diese Plattform nicht die Definition von Umgebungseigenschaften mit AWS CloudFormation Funktionen.

Beispiel .Ebextensions/sns-topic.config

Resources:
  NotificationTopic:
    Type: AWS::SNS::Topic

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

Sie können diese Funktion auch verwenden, um Informationen von zu verbreiten AWS CloudFormation Pseudo-Parameter. 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:

• Go – Namespace der Go-Konfiguration

• Java SE – Java SE-Konfigurations-Namespace

• Tomcat – Tomcat-Konfigurations-Namespaces

• . NETCore unter Linux — . NETCore auf Linux-Konfigurationsnamespace

• .NET – Der Namespace aws:elasticbeanstalk:container:dotnet:apppool

• Node.js – Node.js Konfigurations-Namespace

• PHP – Namespaces für die Konfiguration

• Python – Namespaces der Python-Konfiguration

• Ruby – Namespaces der Ruby-Konfigurationen

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, das EB CLI oder das AWS CLI. KonfigurationsoptionenWeitere Informationen finden Sie unter.

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

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

• . NETCore 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 verwendenget-config.