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.
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-Fähigkeit 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:
-
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
Aktionenappconfig:StartConfigurationSession
und gewährt, zusammen mit den Teil- oder Vollzugriff, die den AWS AppConfig Konfigurationsressourcen ARNs entsprechen. -
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 dem ARN der in Schritt 1 erstellten Rolle hinzu. -
(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 derAWS_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.
-
Die folgende Tabelle enthält eine Spalte mit Beispielwerten. Je nach Bildschirmauflösung müssen Sie möglicherweise zum Ende der Tabelle und dann nach rechts scrollen, um die Spalte anzuzeigen.
Umgebungsvariable | Details | Standardwert | Beispielwerte |
---|---|---|---|
|
Diese Umgebungsvariable gibt den Port an, auf dem der lokale HTTP-Server läuft, der die Erweiterung hostet. |
2772 | 2772 |
|
Diese Umgebungsvariable gibt den Detaillierungsgrad an, den der Agent protokolliert. Jede Ebene umfasst die aktuelle Ebene und alle höheren Ebenen. Der Wert unterscheidet nicht zwischen Groß- und Kleinschreibung. Die Protokollebenen, von den meisten bis hin zu den am wenigsten detaillierten |
info |
Spur debug info warnen error tödlich Keine |
|
Diese Umgebungsvariable konfiguriert die maximale Anzahl von Verbindungen, die die Erweiterung zum Abrufen von AWS AppConfig Konfigurationen verwendet. |
3 | 3 |
|
Diese Umgebungsvariable steuert, wie oft der Agent AWS AppConfig nach aktualisierten Konfigurationsdaten fragt. Sie können eine Anzahl von Sekunden für das Intervall angeben. Sie können auch eine Zahl mit einer Zeiteinheit angeben: s für Sekunden, m für Minuten und h für Stunden. Wenn keine Einheit angegeben ist, verwendet der Agent standardmäßig Sekunden. Beispielsweise ergeben 60, 60 Sekunden und 1 m dasselbe Abfrageintervall. |
45 | 45 45 s 5m 1 h |
|
Diese Umgebungsvariable steuert die maximale Zeit (in Millisekunden), für die die Erweiterung AWS AppConfig beim Aktualisieren von Daten im Cache auf eine Antwort wartet. Wenn innerhalb der angegebenen Zeit AWS AppConfig nicht reagiert wird, überspringt die Erweiterung dieses Abfrageintervall und gibt die zuvor aktualisierten zwischengespeicherten Daten zurück. |
3000 ms | 3000 300 ms 5s |
|
Diese Umgebungsvariable gibt die Konfigurationsdaten an, nach denen der Agent fragt, AWS AppConfig sobald er gestartet wird. In einer durch Kommas getrennten Liste können mehrere Konfigurationsbezeichner angegeben werden. Durch das Vorabrufen von Konfigurationsdaten von AWS AppConfig kann die Kaltstartzeit Ihrer Funktion erheblich reduziert werden. |
Keine | MyApp:MyEnv:MyConfig abcd123:efgh456:ijkl789 MyApp::Konfiguration 1, ::Konfiguration 2 MyEnv MyApp MyEnv |
AWS_APPCONFIG_EXTENSION_PROXY_HEADERS |
Diese Umgebungsvariable gibt Header an, die für den Proxy erforderlich sind, auf den in der Umgebungsvariablen verwiesen wird. AWS_APPCONFIG_EXTENSION_PROXY_URL Der Wert ist eine durch Kommas getrennte Liste von Headern. |
Keine | Header: Wert h1: v1, h2: v2 |
AWS_APPCONFIG_EXTENSION_PROXY_URL |
Diese Umgebungsvariable gibt die Proxy-URL an, die für Verbindungen von der AWS AppConfig Erweiterung zu verwendet werden soll AWS-Services. HTTPS und HTTP URLs werden unterstützt. |
Keine | http://localhost:7474 https://my-proxy.example.com |
AWS_APPCONFIG_EXTENSION_ROLE_ARN |
Diese Umgebungsvariable gibt den ARN der IAM-Rolle an, der einer Rolle entspricht, die von der AWS AppConfig Erweiterung zum Abrufen der Konfiguration übernommen werden sollte. | Keine | arn:aws:iam: :123456789012:role/ MyRole |
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID |
Diese Umgebungsvariable gibt die externe ID an, die in Verbindung mit der angenommenen Rolle ARN verwendet werden soll. | Keine | MyExternalId |
AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME |
Diese Umgebungsvariable gibt den Sitzungsnamen an, der den Anmeldeinformationen für die angenommene IAM-Rolle zugeordnet werden soll. | Keine | AWSAppConfigAgentSession |
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. | Keine | us-east-1 eu-west-1 |
|
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. Weitere Informationen zu diesen Funktionen finden Sie unter Verwendung eines Manifests zur Aktivierung zusätzlicher Abruffunktionen. |
Keine | Bei Verwendung der Konfiguration als Manifest AWS AppConfig :. Beim Laden des Manifests von der Festplatte: |
|
Diese Umgebungsvariable konfiguriert den AWS AppConfig Agenten so, dass er wartet, bis das Manifest verarbeitet ist, bevor der Start abgeschlossen wird. |
true | true false |