Konfiguration der AWS AppConfig Agent-Lambda-Erweiterung - AWS AppConfig

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.

Konfiguration der AWS AppConfig Agent-Lambda-Erweiterung

Sie können die Erweiterung konfigurieren, indem Sie die folgenden AWS Lambda Umgebungsvariablen ändern. Weitere Informationen finden Sie unter Verwenden von AWS Lambda Umgebungsvariablen im AWS Lambda Entwicklerhandbuch.

Konfigurationsdaten werden vorab abgerufen

Die Umgebungsvariable AWS_APPCONFIG_EXTENSION_PREFETCH_LIST kann die Startzeit Ihrer Funktion verbessern. Wenn die AWS AppConfig Agent Lambda-Erweiterung initialisiert ist, ruft sie die angegebene Konfiguration ab, AWS AppConfig bevor Lambda beginnt, Ihre Funktion zu initialisieren und Ihren Handler aufzurufen. In einigen Fällen sind die Konfigurationsdaten bereits im lokalen Cache verfügbar, bevor Ihre Funktion sie anfordert.

Um die Prefetch-Funktion zu verwenden, setzen Sie den Wert der Umgebungsvariablen auf den Pfad, der Ihren Konfigurationsdaten entspricht. Wenn Ihre Konfiguration beispielsweise einem Anwendungs-, Umgebungs- und Konfigurationsprofil mit den Namen „my_application“, „my_environment“ und „my_configuration_data“ entspricht, wäre der Pfad. /applications/my_application/environments/my_environment/configurations/my_configuration_data Sie können mehrere Konfigurationselemente angeben, indem Sie sie als kommagetrennte Liste auflisten (wenn Sie einen Ressourcennamen haben, der ein Komma enthält, verwenden Sie den ID-Wert der Ressource anstelle ihres Namens).

Zugreifen auf Konfigurationsdaten von einem anderen Konto aus

Die AWS AppConfig Agent Lambda-Erweiterung kann Konfigurationsdaten von einem anderen Konto abrufen, indem sie eine IAM Rolle angibt, die Berechtigungen für die Daten gewährt. Gehen Sie folgendermaßen vor, um dies einzurichten:

  1. Erstellen Sie in dem AWS AppConfig Konto, in dem die Konfigurationsdaten verwaltet werden, eine Rolle mit einer Vertrauensrichtlinie, die dem Konto, auf dem die Lambda-Funktion ausgeführt wird, Zugriff auf die appconfig:GetLatestConfiguration Aktionen appconfig:StartConfigurationSession und gewährt, zusammen mit den Teil- oder Vollzugriff, die den AWS AppConfig Konfigurationsressourcen ARNs entsprechen.

  2. Fügen Sie in dem Konto, auf dem die Lambda-Funktion ausgeführt wird, der Lambda-Funktion die AWS_APPCONFIG_EXTENSION_ROLE_ARN Umgebungsvariable mit ARN der in Schritt 1 erstellten Rolle hinzu.

  3. (Optional) Bei Bedarf kann mithilfe der AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID Umgebungsvariablen eine externe ID angegeben werden. In ähnlicher Weise kann ein Sitzungsname mithilfe der AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME Umgebungsvariablen konfiguriert werden.

Anmerkung

Notieren Sie die folgenden Informationen:

  • Die AWS AppConfig Agent Lambda-Erweiterung kann nur Daten von einem Konto abrufen. Wenn Sie eine IAM Rolle angeben, kann die Erweiterung keine Konfigurationsdaten von dem Konto abrufen, in dem die Lambda-Funktion ausgeführt wird.

  • AWS Lambda protokolliert Informationen über die AWS AppConfig Agent Lambda-Erweiterung und die Lambda-Funktion mithilfe von Amazon CloudWatch Logs.

Umgebungsvariable Details Standardwert

AWS_APPCONFIG_EXTENSION_HTTP_PORT

Diese Umgebungsvariable gibt den Port an, auf dem der lokale HTTP Server läuft, der die Erweiterung hostet.

 2772

AWS_APPCONFIG_EXTENSION_LOG_LEVEL

Diese Umgebungsvariable gibt an, welche AWS AppConfig erweiterungsspezifischen Protokolle für eine Funktion an Amazon CloudWatch Logs gesendet werden. Gültige Werte ohne Berücksichtigung der Groß- und Kleinschreibung sind:debug,,info, warn und. error none Debug enthält detaillierte Informationen, einschließlich Zeitinformationen, über die Erweiterung.

info

AWS_APPCONFIG_EXTENSION_MAX_CONNECTIONS

Diese Umgebungsvariable konfiguriert die maximale Anzahl von Verbindungen, die die Erweiterung zum Abrufen von Konfigurationen verwendet. AWS AppConfig

 3

AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS

Diese Umgebungsvariable steuert, wie oft die Erweiterung innerhalb von Sekunden AWS AppConfig nach einer aktualisierten Konfiguration fragt.

 45

AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS

Diese Umgebungsvariable steuert, wie lange (in Millisekunden) die Erweiterung maximal auf eine Antwort wartet, AWS AppConfig wenn sie Daten im Cache aktualisiert. Wenn AWS AppConfig nicht innerhalb der angegebenen Zeit reagiert, überspringt die Erweiterung dieses Abfrageintervall und gibt die zuvor aktualisierten zwischengespeicherten Daten zurück.

 3000

AWS_APPCONFIG_EXTENSION_PREFETCH_LIST

Diese Umgebungsvariable gibt die Konfigurationsdaten an, die die Erweiterung abruft, bevor die Funktion initialisiert und der Handler ausgeführt wird. Sie kann die Kaltstartzeit der Funktion erheblich reduzieren.

 None
AWS_APPCONFIG_EXTENSION_PROXY_HEADERS Diese Umgebungsvariable spezifiziert Header, die der Proxy benötigt, auf den in der AWS_APPCONFIG_EXTENSION_PROXY_URL Umgebungsvariablen verwiesen wird. Der Wert ist eine durch Kommas getrennte Liste von Headern. Jeder Header verwendet die folgende Form: 
"header: value"
 None
AWS_APPCONFIG_EXTENSION_PROXY_URL Diese Umgebungsvariable gibt den Proxy URL an, der für Verbindungen von der AWS AppConfig Erweiterung zu verwendet AWS-Services werden soll. HTTPSund HTTP URLs werden unterstützt. None
AWS_APPCONFIG_EXTENSION_ROLE_ARN Diese Umgebungsvariable gibt die IAM Rolle an, die einer Rolle ARN entspricht, die von der AWS AppConfig Erweiterung zum Abrufen der Konfiguration übernommen werden sollte. None
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID Diese Umgebungsvariable gibt die externe ID an, die in Verbindung mit der angenommenen Rolle verwendet werden sollARN. None
AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME Diese Umgebungsvariable gibt den Sitzungsnamen an, der den Anmeldeinformationen für die angenommene IAM Rolle zugeordnet werden soll. None
AWS_APPCONFIG_EXTENSION_SERVICE_REGION Diese Umgebungsvariable gibt eine alternative Region an, die die Erweiterung verwenden soll, um den AWS AppConfig Dienst aufzurufen. Wenn sie nicht definiert ist, verwendet die Erweiterung den Endpunkt in der aktuellen Region. None

AWS_APPCONFIG_EXTENSION_MANIFEST

Diese Umgebungsvariable konfiguriert den AWS AppConfig Agenten so, dass er zusätzliche konfigurationsspezifische Funktionen wie das Abrufen mehrerer Konten und das Speichern der Konfiguration auf der Festplatte nutzt. Sie können einen der folgenden Werte eingeben:

  • "app:env:manifest-config"

  • "file:/fully/qualified/path/to/manifest.json"

Weitere Informationen zu diesen Funktionen finden Sie unter Verwenden eines Manifests, um zusätzliche Abruffunktionen zu aktivieren.

true

AWS_APPCONFIG_EXTENSION_WAIT_ON_MANIFEST

Diese Umgebungsvariable konfiguriert den AWS AppConfig Agenten so, dass er wartet, bis das Manifest verarbeitet ist, bevor der Start abgeschlossen wird.

 true