View a markdown version of this page

(Facultatif) Utilisation de variables d'environnement pour configurer AWS AppConfig Agent pour Amazon ECS et Amazon EKS - AWS AppConfig

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

(Facultatif) Utilisation de variables d'environnement pour configurer AWS AppConfig Agent pour Amazon ECS et Amazon EKS

Vous pouvez configurer AWS AppConfig l'agent en modifiant les variables d'environnement suivantes pour votre conteneur d'agents.

Note

Le tableau suivant inclut une colonne de valeurs d'exemple. En fonction de la résolution de votre écran, vous devrez peut-être faire défiler la page vers le bas du tableau, puis la faire défiler vers la droite pour afficher la colonne.

Variable d'environnement Détails Valeur par défaut Valeur (s) de l'échantillon

ACCESS_TOKEN

Cette variable d'environnement définit un jeton qui doit être fourni lors de la demande de données de configuration auprès du serveur HTTP de l'agent. La valeur du jeton doit être définie dans l'en-tête d'autorisation de la requête HTTP avec un type d'autorisation deBearer. Voici un exemple.

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

BACKUP_DIRECTORY

Cette variable d'environnement permet à AWS AppConfig l'Agent d'enregistrer une sauvegarde de chaque configuration qu'il récupère dans le répertoire spécifié.

Important

Les configurations sauvegardées sur disque ne sont pas chiffrées. Si votre configuration contient des données sensibles, vous AWS AppConfig recommande d'appliquer le principe du moindre privilège avec les autorisations de votre système de fichiers. Pour de plus amples informations, veuillez consulter Sécurité dans AWS AppConfig.

Aucune /path/to/sauvegardes

EXPERIMENT_ASSIGNMENT_LOG_DESTINATION

Cette variable d'environnement permet à l' AWS AppConfig Agent d'enregistrer les enregistrements d'attribution des expériences, qui capturent chaque occurrence d'un traitement expérimental attribué à une entité donnée à un moment donné. Valeurs possibles : file:<path>/ indique un répertoire de base dans lequel les enregistrements d'affectation sont écrits sur le disque ; stderr indique que les enregistrements d'affectation sont émis vers stderr. Cette fonctionnalité nécessite la version 2.0.175233 ou ultérieure de l' AWS AppConfig Agent.

Aucune

file:/tmp/aws-appconfig/assignments/

stderr

HTTP_PORT

Cette variable d'environnement spécifie le port sur lequel s'exécute le serveur HTTP de l'agent.

2772 2772

HTTP_HOST

La variable HTTP_HOST contrôle la manière dont l' AWS AppConfig agent se lie aux interfaces réseau. Le comportement des liaisons varie en fonction de l'environnement d'exécution afin de garantir une sécurité et une accessibilité optimales.

ÉCS, ÉKS

  • Liaison par défaut : toutes les interfaces réseau (0.0.0.0)

EC2 et sur site

  • Liaison par défaut : localhost uniquement

  • Adresse IPv4 : 127.0.0. 1:2772

  • Adresse IPv6 : [::1] :2772

Options de configuration personnalisées. Vous pouvez modifier le comportement par défaut à l'aide des valeurs suivantes :

  • all(se lie à toutes les interfaces)

  • localhost(se lie explicitement aux interfaces localhost)

  • Adresse IP spécifique (par exemple192.168.1.1)

  • Nom d'hôte personnalisé

LOG_LEVEL

Cette variable d'environnement spécifie le niveau de détail enregistré par l'agent. Chaque niveau inclut le niveau actuel et tous les niveaux supérieurs. La valeur ne fait pas la distinction majuscules/minuscules. Du plus détaillé au moins détaillé, les niveaux de journalisation sont les suivants : trace debug infowarn,error,fatal, etnone. Le trace journal contient des informations détaillées, y compris des informations de synchronisation, concernant l'agent.

info

trace

debug

info

prévenir

error

fatal

Aucune

LOG_PATH

Emplacement du disque où les journaux sont écrits. S'il n'est pas spécifié, les journaux sont écrits sur stderr.

Aucune

path/to//logs/agent.journal

MANIFEST

Cette variable d'environnement configure l' AWS AppConfig Agent pour tirer parti de fonctionnalités supplémentaires par configuration, telles que la récupération de plusieurs comptes et l'enregistrement de la configuration sur disque. Pour de plus amples informations sur l'utilisation de ces modèles, consultez Utilisation d'un manifeste pour activer des fonctionnalités de récupération supplémentaires.

Aucune

Lorsque vous utilisez AWS AppConfig la configuration comme manifeste :MyApp:MyEnv:MyManifestConfig.

Lors du chargement du manifeste depuis le disque : file:/path/to/manifest.json

MAX_CONNECTIONS

Cette variable d'environnement configure le nombre maximum de connexions que l'agent utilise pour récupérer les configurations. AWS AppConfig

3 3

POLL_INTERVAL

Cette variable d'environnement contrôle la fréquence à laquelle l'agent interroge les données AWS AppConfig de configuration mises à jour. Vous pouvez spécifier un nombre de secondes pour l'intervalle. Vous pouvez également spécifier un nombre avec une unité de temps : s pour les secondes, m pour les minutes et h pour les heures. Si aucune unité n'est spécifiée, l'agent utilise par défaut les secondes. Par exemple, 60, 60 et 1 m donnent le même intervalle d'interrogation.

45 secondes

45

45 années

5 min

1 heure

PREFETCH_LIST

Cette variable d'environnement spécifie les données de configuration demandées par AWS AppConfig l'agent dès son démarrage. Plusieurs identifiants de configuration peuvent être fournis dans une liste séparée par des virgules.

Aucune

MyApp:MyEnv:MyConfig

abcd123 : efgh456 : ijkl789

MyApp:MyEnv:Config1,MyApp:MyEnv:Config2

PRELOAD_BACKUPS

Si ce paramètre est défini surtrue, l' AWS AppConfig agent charge les sauvegardes de configuration présentes BACKUP_DIRECTORY dans la mémoire et vérifie immédiatement si une version plus récente existe depuis le service. Si ce paramètre est défini surfalse, l' AWS AppConfig Agent charge le contenu d'une sauvegarde de configuration uniquement s'il ne peut pas récupérer les données de configuration du service, par exemple en cas de problème avec votre réseau.

true

vrai

false

PROXY_HEADERS Cette variable d'environnement spécifie les en-têtes requis par le proxy référencé dans la variable d'PROXY_URLenvironnement. La valeur est une liste d'en-têtes séparés par des virgules. Aucune

en-tête : valeur

h1 : v1, h2 : v2

PROXY_URL Cette variable d'environnement spécifie l'URL du proxy à utiliser pour les connexions entre l'agent Services AWS et, notamment AWS AppConfig. HTTPSet HTTP les URL sont prises en charge. Aucune

http://localhost: 7474

https://my-proxy.example.com

REQUEST_TIMEOUT

Cette variable d'environnement contrôle la durée pendant laquelle l'agent attend une réponse. AWS AppConfig Si le service ne répond pas, la demande échoue.

Si la demande concerne la récupération initiale des données, l'agent renvoie une erreur à votre application.

Si le délai d'attente survient lors d'une vérification des antécédents pour les données mises à jour, l'agent enregistre l'erreur et réessaie après un court laps de temps.

Vous pouvez spécifier le nombre de millisecondes pour le délai d'attente. Vous pouvez également spécifier un nombre avec une unité de temps : ms pour les millisecondes et s pour les secondes. Si aucune unité n'est spécifiée, l'agent utilise par défaut les millisecondes. Par exemple, 5 000, 5 000 ms et 5 s entraînent la même valeur de délai d'expiration de la demande.

3000 ms

3000

3000 ms

5s

ROLE_ARN Cette variable d'environnement spécifie le nom de ressource Amazon (ARN) d'un rôle IAM. AWS AppConfig L'agent assume ce rôle pour récupérer les données de configuration. Aucune arn:aws:iam : :123456789012 : role/MyRole
ROLE_EXTERNAL_ID Cette variable d'environnement spécifie l'ID externe à utiliser avec le rôle supposé ARN. Aucune MyExternalId
ROLE_SESSION_NAME Cette variable d'environnement spécifie le nom de session à associer aux informations d'identification pour le rôle IAM supposé. Aucune AWSAppConfigAgentSession
SERVICE_REGION Cette variable d'environnement spécifie une alternative Région AWS que AWS AppConfig l'agent utilise pour appeler le AWS AppConfig service. Si elle n'est pas définie, l'agent tente de déterminer la région actuelle. Si ce n'est pas possible, l'agent ne démarre pas. Aucune

us-east-1

eu-west-1

WAIT_ON_MANIFEST

Cette variable d'environnement configure l' AWS AppConfig agent pour qu'il attende que le manifeste soit traité avant de terminer le démarrage.

true

vrai

false