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.
Konfigurieren von AWS AppConfig Agent Lambda-Erweiterung
Sie können die Erweiterung konfigurieren, indem Sie die folgenden AWS Lambda Umgebungsvariablen ändern. Weitere Informationen finden Sie im AWS Lambda Entwicklerhandbuch unter Verwenden von AWS Lambda Umgebungsvariablen.
Konfigurationsdaten vorab abrufen
Die Umgebungsvariable AWS_APPCONFIG_EXTENSION_PREFETCH_LIST kann die Startzeit Ihrer Funktion verbessern. Wenn die AWS AppConfig Agent Lambda-Erweiterung initialisiert wird, ruft sie die angegebene Konfiguration ab, AWS AppConfig bevor Lambda beginnt, um 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 einer Anwendung, einer Umgebung und einem Konfigurationsprofil mit den Namen „my_application“, „my_environment“ und „my_configuration_data“ entspricht, wäre der Pfad wie folgt. /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 erteilt. Gehen Sie folgendermaßen vor, um dies einzurichten:
-
Erstellen Sie in dem Konto, das für die Verwaltung der Konfigurationsdaten verwendet AWS AppConfig wird, eine Rolle mit einer Vertrauensrichtlinie, die dem Konto, das die Lambda-Funktion ausführt, Zugriff auf die
appconfig:GetLatestConfigurationAktionenappconfig:StartConfigurationSessionund gewährt, zusammen mit den teilweisen oder vollständigen ARNs, die den AWS AppConfig Konfigurationsressourcen entsprechen. -
Fügen Sie in dem Konto, auf dem die Lambda-Funktion ausgeführt wird, der Lambda-Funktion die
AWS_APPCONFIG_EXTENSION_ROLE_ARNUmgebungsvariable mit dem ARN der in Schritt 1 erstellten Rolle hinzu. -
(Optional) Bei Bedarf kann eine externe ID mithilfe der
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_IDUmgebungsvariablen angegeben werden. Ebenso kann ein Sitzungsname mithilfe derAWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAMEUmgebungsvariablen 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 mithilfe von Amazon Logs Informationen über die AWS AppConfig Agent Lambda-Erweiterung und die Lambda-Funktion. CloudWatch
-
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 ermöglicht es dem AWS AppConfig Agenten, Aufzeichnungen über die Versuchszuweisung zu protokollieren, die jedes Vorkommen einer Versuchsbehandlung erfassen, die zu einem bestimmten Zeitpunkt einer bestimmten Entität zugewiesen wurde. Mögliche Werte: |
Keine |
|
|
|
Diese Umgebungsvariable gibt den Port an, auf dem der lokale HTTP-Server ausgeführt wird, 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 sind von den meisten bis zu den am wenigsten detaillierten: |
info |
trace debug info warnen error tödlich Keine |
|
|
Diese Umgebungsvariable konfiguriert die maximale Anzahl von Verbindungen, von denen die Erweiterung Konfigurationen abruft. AWS AppConfig |
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. Zum Beispiel ergeben 60, 60 Sekunden und 1 Minute dasselbe Abfrageintervall. |
45 | 45 45 Sekunden 5m 1 h |
|
|
Diese Umgebungsvariable steuert die maximale Zeitspanne in Millisekunden, ab der die Erweiterung AWS AppConfig beim Aktualisieren von Daten im Cache auf eine Antwort wartet. Wenn die Erweiterung AWS AppConfig nicht innerhalb der angegebenen Zeit reagiert, überspringt sie dieses Abfrageintervall und gibt die zuvor aktualisierten zwischengespeicherten Daten zurück. |
3000 ms | 3000 300 ms 5 s |
|
|
Diese Umgebungsvariable gibt die Konfigurationsdaten an, die der Agent anfordert, AWS AppConfig sobald er gestartet wird. In einer kommagetrennten 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:MyEnv:Config1,MyApp:MyEnv:Config2 |
AWS_APPCONFIG_EXTENSION_PROXY_HEADERS |
Diese Umgebungsvariable spezifiziert Header, die von dem Proxy benötigt werden, 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. HTTPSund HTTP URLs werden unterstützt. |
Keine | http://localhostund URLs werden unterstützt. ----sep----:7474 https://my-proxy.example.com |
AWS_APPCONFIG_EXTENSION_ROLE_ARN |
Diese Umgebungsvariable gibt den IAM-Rollen-ARN 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 dem angenommenen Rollen-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 nicht definiert, 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 Verwenden eines Manifests, um zusätzliche Abruffunktionen zu aktivieren. |
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 |