

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
<a name="environments-cfg-softwaresettings"></a>

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.

**Topics**
+ [Plattformspezifische Einstellungen konfigurieren](#environments-cfg-softwaresettings-specific)
+ [Konfiguration von Umgebungseigenschaften (Umgebungsvariablen)](#environments-cfg-softwaresettings-console)
+ [Softwareeinstellung Namespaces](#environments-cfg-softwaresettings-configfiles)
+ [Zugreifen auf Umgebungseigenschaften](#environments-cfg-softwaresettings-accessing)
+ [AWS X-Ray Debugging konfigurieren](environment-configuration-debugging.md)
+ [Anzeigen Ihrer Elastic Beanstalk-Umgebungsprotokolle](environments-cfg-logging.md)

## Plattformspezifische Einstellungen konfigurieren
<a name="environments-cfg-softwaresettings-specific"></a>

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](command-options.md) 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](https://console.aws.amazon.com/elasticbeanstalk) und wählen Sie in der Liste **Regionen** Ihre aus. AWS-Region

1. Wählen Sie im Navigationsbereich **Environments (Umgebungen)** aus und wählen Sie dann in der Liste den Namen Ihrer Umgebung aus.

1. Wählen Sie im Navigationsbereich **Configuration (Konfiguration)** aus.

1. Wählen Sie in der Konfigurationskategorie **Updates, monitoring and logging ** (Updates, Überwachung und Protokolle) die Option **Edit** (Bearbeiten) aus.

1. Nehmen Sie unter **Plattformsoftware** die erforderlichen Änderungen an der Optionseinstellung vor.

1. 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](create_deploy_docker.container.console.md)
+ Go – [Verwenden der Go-Plattform von Elastic Beanstalk](go-environment.md)
+ Java SE – [Elastic Beanstalk Java SE-Plattform verwenden](java-se-platform.md)
+ Tomcat – [Elastic Beanstalk Tomcat-Plattform verwenden](java-tomcat-platform.md)
+ .NET Core unter Linux – [Verwenden des Elastic Beanstalk Beanstalk-.NET-Kerns auf einer Linux-Plattform](dotnet-linux-platform.md)
+ .NET – [Verwendung der Elastic Beanstalk .NET Windows-Plattform](create_deploy_NET.container.console.md)
+ Node.js – [Verwenden der Elastic Beanstalk Node.js-Plattform](create_deploy_nodejs.container.md)
+ PHP – [Verwenden der Elastic Beanstalk PHP-Plattform](create_deploy_PHP.container.md)
+ Python – [Verwenden der Elastic Beanstalk Python-Plattform](create-deploy-python-container.md)
+ Ruby – [Verwenden der Elastic Beanstalk-Ruby-Plattform](create_deploy_Ruby.container.md)

## Konfiguration von Umgebungseigenschaften (Umgebungsvariablen)
<a name="environments-cfg-softwaresettings-console"></a>

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](using-features.managing.db.md), legt Elastic Beanstalk außerdem Umgebungsvariablen fest, die Sie beispielsweise in Ihrem Anwendungscode lesen können`RDS_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](https://console.aws.amazon.com/elasticbeanstalk) und wählen Sie in der Liste **Regionen** Ihre aus. AWS-Region

1. Wählen Sie im Navigationsbereich **Environments (Umgebungen)** aus und wählen Sie dann in der Liste den Namen Ihrer Umgebung aus.

1. Wählen Sie im Navigationsbereich **Configuration (Konfiguration)** aus.

1. Wählen Sie in der Konfigurationskategorie **Updates, monitoring and logging ** (Updates, Überwachung und Protokolle) die Option **Edit** (Bearbeiten) aus.

1. Scrollen Sie nach unten zu **Runtime-Umgebungsvariablen.**

1. Wählen Sie **Umgebungsvariable hinzufügen** aus.

1. 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](AWSHowTo.secrets.md). 

1. Geben Sie den **Namen der Umgebungsvariablen** und die **Wertepaare der Umgebungsvariablen** ein.

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

1. 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
<a name="environments-cfg-softwaresettings-configfiles"></a>

Mithilfe einer [Konfigurationsdatei](ebextensions.md) können Sie im Rahmen der Bereitstellung Konfigurationsoptionen festlegen und andere Instance-Konfigurationsaufgaben durchführen. Die Konfigurationsoptionen können [plattformspezifisch](command-options-specific.md) sein oder für [alle Plattformen](command-options-general.md) im Elastic Beanstalk-Service als Ganzes gelten. *Die Konfigurationsoptionen sind in Namespaces organisiert.*

Sie können mit den [Konfigurationsdateien](ebextensions.md) von Elastic Beanstalk Umgebungseigenschaften und Konfigurationsoptionen in Ihrem Quellcode festlegen. Verwenden Sie den [`aws:elasticbeanstalk:application:environment`Namespace](command-options-general.md#command-options-general-elasticbeanstalkapplicationenvironment), um Umgebungseigenschaften zu definieren.

**Example .ebextensions/options.config**  

```
option_settings:
  aws:elasticbeanstalk:application:environment:
    API_ENDPOINT: www.example.com/api
```

Wenn Sie Konfigurationsdateien oder CloudFormation Vorlagen verwenden, um [benutzerdefinierte Ressourcen](environment-resources.md) zu erstellen, können Sie eine 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](https://github.com/awsdocs/elastic-beanstalk-samples/) GitHub Repository verwendet die [Ref-Funktion](ebextensions-functions.md), 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 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](custom-platforms-scripts.md) verwenden, um die Werte der Umgebungseigenschaften zu bestätigen, die für Ihre Anwendung verfügbar sind. 
Die [Multicontainer Docker-Plattform](create_deploy_docker_ecs.md) wird nicht zur Erstellung von Container-Ressourcen verwendet CloudFormation . Daher unterstützt diese Plattform die Definition von Umgebungseigenschaften mithilfe CloudFormation von Funktionen nicht.

**Example .Ebextensions/[sns-topic.config](https://github.com/awsdocs/elastic-beanstalk-samples/tree/main/configuration-files/aws-provided/resource-configuration/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 [CloudFormation -Pseudoparametern](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/pseudo-parameter-reference.html) bereitstellen. In diesem Beispiel wird die derzeitige Region abgerufen und einer Eigenschaft namens `AWS_REGION` zugewiesen.

**Example .Ebextensions/[env-regionname.config](https://github.com/awsdocs/elastic-beanstalk-samples/tree/main/configuration-files/aws-provided/instance-configuration/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](go-environment.md#go-namespaces)
+ Java SE – [Java SE-Konfigurations-Namespace](java-se-platform.md#java-se-namespaces)
+ Tomcat – [Tomcat-Konfigurations-Namespaces](java-tomcat-platform.md#java-tomcat-namespaces)
+ .NET Core unter Linux – [.NET Core unter Linux-Konfigurations-Namespace](dotnet-linux-platform.md#dotnet-linux-namespace)
+ .NET – [Der Namespace aws:elasticbeanstalk:container:dotnet:apppool](create_deploy_NET.container.console.md#dotnet-namespaces)
+ Node.js – [Node.js-Konfigurations-Namespace](create_deploy_nodejs.container.md#nodejs-namespaces)
+ PHP – [Namespaces für die Konfiguration](create_deploy_PHP.container.md#php-namespaces)
+ Python – [Namespaces der Python-Konfiguration](create-deploy-python-container.md#python-namespaces)
+ Ruby – [Namespaces der Ruby-Konfigurationen](create_deploy_Ruby.container.md#ruby-namespaces)

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](command-options.md).

## Zugreifen auf Umgebungseigenschaften
<a name="environments-cfg-softwaresettings-accessing"></a>

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](go-environment.md#go-options-properties) – `os.Getenv`

  ```
  endpoint := os.Getenv("API_ENDPOINT")
  ```
+ [Java SE](java-se-platform.md#java-se-options-properties) – `System.getenv`

  ```
  String endpoint = System.getenv("API_ENDPOINT");
  ```
+ [Tomcat](java-tomcat-platform.md#java-tomcat-options-properties) — `System.getProperty` und `System.getenv` 

  Tomcat-Plattformversionen, die am oder nach dem [26. März 2025 veröffentlicht wurden,](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2025-03-26-windows.html) 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](AWSHowTo.secrets.env-vars.md) 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,](https://docs.aws.amazon.com/elasticbeanstalk/latest/relnotes/release-2025-03-26-windows.html) 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](https://docs.aws.amazon.com/elasticbeanstalk/latest/dg/java-tomcat-platform.html).
+ [.NET Core unter Linux](dotnet-linux-platform.md#dotnet-linux-options-properties) – `Environment.GetEnvironmentVariable`

  ```
  string endpoint = Environment.GetEnvironmentVariable("API_ENDPOINT");
  ```
+ [.NET](create_deploy_NET.container.console.md#dotnet-console-properties) – `appConfig`

  ```
  NameValueCollection appConfig = ConfigurationManager.AppSettings;
  string endpoint = appConfig["API_ENDPOINT"];
  ```
+ [Node.js](create_deploy_nodejs.container.md#nodejs-platform-console-envprops) – `process.env`

  ```
  var endpoint = process.env.API_ENDPOINT
  ```
+ [PHP](create_deploy_PHP.container.md#php-console-properties) – `$_SERVER`

  ```
  $endpoint = $_SERVER['API_ENDPOINT'];
  ```
+ [Python](create-deploy-python-container.md#create-deploy-python-custom-container-envprop) – `os.environ`

  ```
  import os
  endpoint = os.environ['API_ENDPOINT']
  ```
+ [Ruby](create_deploy_Ruby.container.md#create_deploy_Ruby.env.console.ruby.envprops) – `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](custom-platforms-scripts.md) zugreifen. Im [elastic-beanstalk-samples](https://github.com/awsdocs/elastic-beanstalk-samples/search?utf8=%E2%9C%93&q=get-config) GitHub Repository finden Sie Beispielkonfigurationen, die verwenden. `get-config`