View a markdown version of this page

(Optional) Verwenden von Umgebungsvariablen zur Konfiguration AWS AppConfig Agent für Amazon ECS und Amazon EKS - 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.

(Optional) Verwenden von Umgebungsvariablen zur Konfiguration AWS AppConfig Agent für Amazon ECS und Amazon EKS

Sie können den AWS AppConfig Agenten konfigurieren, indem Sie die folgenden Umgebungsvariablen für Ihren Agent-Container ändern.

Anmerkung

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 Beispielwert (e)

ACCESS_TOKEN

Diese Umgebungsvariable definiert ein Token, das bereitgestellt werden muss, wenn Konfigurationsdaten vom HTTP-Server des Agenten angefordert werden. Der Wert des Tokens muss im HTTP-Anforderungsautorisierungsheader mit dem Autorisierungstyp festgelegt werdenBearer. Ein Beispiel.

GET /applications/my_app/... Host: localhost:2772 Authorization: Bearer <token value>
Keine MyAccessToken

BACKUP_DIRECTORY

Diese Umgebungsvariable ermöglicht es dem AWS AppConfig Agenten, eine Sicherungskopie jeder abgerufenen Konfiguration im angegebenen Verzeichnis zu speichern.

Wichtig

Konfigurationen, die auf der Festplatte gesichert werden, sind nicht verschlüsselt. Wenn Ihre Konfiguration vertrauliche Daten enthält, AWS AppConfig empfiehlt, dass Sie bei Ihren Dateisystemberechtigungen das Prinzip der geringsten Rechte anwenden. Weitere Informationen finden Sie unter Sicherheit in AWS AppConfig.

Keine //backups path/to

EXPERIMENT_ASSIGNMENT_LOG_DESTINATION

Diese Umgebungsvariable ermöglicht es dem AWS AppConfig Agenten, Aufzeichnungen über die Versuchszuweisung zu protokollieren, die jedes Vorkommen einer Versuchsbehandlung erfassen, die einer bestimmten Entität zu einem bestimmten Zeitpunkt zugewiesen wurde. Mögliche Werte: file:<path>/ gibt ein Basisverzeichnis an, in dem die Aufzeichnungen der Aufgaben auf die Festplatte geschrieben werden; stderr gibt an, dass die Aufzeichnungen der Aufgaben an stderr ausgegeben werden. Für diese Funktion ist die AWS AppConfig Agentenversion 2.0.175233 oder höher erforderlich.

Keine

file:/tmp/aws-appconfig/assignments/

stderr

HTTP_PORT

Diese Umgebungsvariable gibt den Port an, auf dem der HTTP-Server für den Agenten läuft.

2772 2772

HTTP_HOST

Die Variable HTTP_HOST steuert, wie der AWS AppConfig Agent an Netzwerkschnittstellen bindet. Das Bindungsverhalten unterscheidet sich je nach Laufzeitumgebung, um optimale Sicherheit und Zugänglichkeit zu gewährleisten.

ECS, EKS

  • Standardbindung: Alle Netzwerkschnittstellen (0.0.0.0)

EC2 und vor Ort

  • Standardbindung: nur localhost

  • IPv4-Adresse: 127.0.0. 1:2772

  • IPv6-Adresse: [::1] :2772

Benutzerdefinierte Konfigurationsoptionen. Sie können das Standardverhalten mit diesen Werten überschreiben:

  • all(bindet an alle Schnittstellen)

  • localhost(bindet explizit an Localhost-Schnittstellen)

  • Spezifische IP-Adresse (z. B.) 192.168.1.1

  • Benutzerdefinierter Hostname

LOG_LEVEL

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: trace debuginfo,warn, errorfatal, undnone. Das trace Protokoll enthält detaillierte Informationen über den Agenten, einschließlich Zeitinformationen.

info

trace

debug

info

warnen

error

tödlich

Keine

LOG_PATH

Der Speicherort auf der Festplatte, auf den Protokolle geschrieben werden. Wenn nicht angegeben, werden Protokolle auf stderr geschrieben.

Keine

//.log path/to logs/agent

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. 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 :. MyApp:MyEnv:MyManifestConfig

Beim Laden des Manifests von der Festplatte: file:/path/to/manifest.json

MAX_CONNECTIONS

Diese Umgebungsvariable konfiguriert die maximale Anzahl von Verbindungen, über die der Agent Konfigurationen AWS AppConfig abruft.

3 3

POLL_INTERVAL

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 Sekunden

45

45 Sekunden

5m

1 h

PREFETCH_LIST

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.

Keine

MyApp:MyEnv:MyConfig

abcd123:efgh456:ijkl789

MyApp:MyEnv:Config1,MyApp:MyEnv:Config2

PRELOAD_BACKUPS

Wenn auf gesetzttrue, lädt der AWS AppConfig Agent die im Dienst gefundenen Konfigurations-Backups BACKUP_DIRECTORY in den Speicher und prüft sofort, ob eine neuere Version des Dienstes existiert. Wenn diese Option auf gesetzt istfalse, lädt der AWS AppConfig Agent den Inhalt einer Konfigurationssicherung nur, wenn er die Konfigurationsdaten nicht aus dem Dienst abrufen kann, z. B. wenn ein Problem mit Ihrem Netzwerk vorliegt.

true

true

false

PROXY_HEADERS Diese Umgebungsvariable gibt Header an, die von dem Proxy benötigt werden, auf den in der PROXY_URL Umgebungsvariablen verwiesen wird. Der Wert ist eine durch Kommas getrennte Liste von Headern. Keine

Header: Wert

h1: v1, h2: v2

PROXY_URL Diese Umgebungsvariable gibt die Proxy-URL an, die für Verbindungen vom Agenten zu verwendet werden soll AWS-Services, einschließlich AWS AppConfig. HTTPSund HTTP URLs werden unterstützt. Keine

http://localhostund URLs werden unterstützt. ----sep----:7474

https://my-proxy.example.com

REQUEST_TIMEOUT

Diese Umgebungsvariable steuert, wie lange der Agent auf eine Antwort wartet. AWS AppConfig Wenn der Dienst nicht antwortet, schlägt die Anfrage fehl.

Wenn die Anfrage den ersten Datenabruf betrifft, gibt der Agent einen Fehler an Ihre Anwendung zurück.

Tritt der Timeout während einer Hintergrundüberprüfung auf aktualisierte Daten auf, protokolliert der Agent den Fehler und versucht es nach einer kurzen Verzögerung erneut.

Sie können die Anzahl der Millisekunden für den Timeout angeben. Sie können auch eine Zahl mit einer Zeiteinheit angeben: ms für Millisekunden und s für Sekunden. Wenn keine Einheit angegeben ist, verwendet der Agent standardmäßig Millisekunden. Beispielsweise ergeben 5000, 5000 ms und 5s denselben Wert für das Anforderungs-Timeout.

3000 ms

3000

3000 ms

5 s

ROLE_ARN Diese Umgebungsvariable gibt den Amazon-Ressourcennamen (ARN) einer IAM-Rolle an. AWS AppConfig Der Agent übernimmt diese Rolle, um Konfigurationsdaten abzurufen. Keine arn:aws:iam: :123456789012: role/MyRole
ROLE_EXTERNAL_ID Diese Umgebungsvariable gibt die externe ID an, die mit dem angenommenen Rollen-ARN verwendet werden soll. Keine MyExternalId
ROLE_SESSION_NAME Diese Umgebungsvariable gibt den Sitzungsnamen an, der den Anmeldeinformationen für die angenommene IAM-Rolle zugeordnet werden soll. Keine AWSAppConfigAgentSession
SERVICE_REGION Diese Umgebungsvariable gibt eine Alternative an AWS-Region , die der AWS AppConfig Agent verwendet, um den AWS AppConfig Dienst aufzurufen. Wenn nicht definiert, versucht der Agent, die aktuelle Region zu ermitteln. Wenn dies nicht möglich ist, kann der Agent nicht gestartet werden. Keine

us-east-1

eu-west-1

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

true

false