Configuration de l'extension AWS AppConfig Agent Lambda - 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.

Configuration de l'extension AWS AppConfig Agent Lambda

Vous pouvez configurer l'extension en modifiant les variables d' AWS Lambda environnement suivantes. Pour plus d'informations, consultez la section Utilisation de variables d' AWS Lambda environnement dans le Guide du AWS Lambda développeur.

Préextraction des données de configuration

La variable d'environnement AWS_APPCONFIG_EXTENSION_PREFETCH_LIST peut améliorer le temps de démarrage de votre fonction. Lorsque l'extension AWS AppConfig Agent Lambda est initialisée, elle récupère la configuration spécifiée avant que AWS AppConfig Lambda ne commence à initialiser votre fonction et à appeler votre gestionnaire. Dans certains cas, les données de configuration sont déjà disponibles dans le cache local avant que votre fonction ne les demande.

Pour utiliser la fonctionnalité de prélecture, définissez la valeur de la variable d'environnement sur le chemin correspondant à vos données de configuration. Par exemple, si votre configuration correspond à une application, à un environnement et à un profil de configuration nommés respectivement « my_application », « my_environment » et « my_configuration_data », le chemin serait. /applications/my_application/environments/my_environment/configurations/my_configuration_data Vous pouvez spécifier plusieurs éléments de configuration en les répertoriant sous forme de liste séparée par des virgules (si le nom d'une ressource inclut une virgule, utilisez l'ID de la ressource au lieu de son nom).

Accès aux données de configuration depuis un autre compte

L'extension AWS AppConfig Agent Lambda peut récupérer les données de configuration d'un autre compte en spécifiant un IAM rôle qui accorde des autorisations sur les données. Pour configurer cela, procédez comme suit :

  1. Dans le compte utilisé AWS AppConfig pour gérer les données de configuration, créez un rôle doté d'une politique de confiance qui accorde au compte exécutant la fonction Lambda l'accès aux appconfig:GetLatestConfiguration actions appconfig:StartConfigurationSession et, ainsi qu'aux actions partielles ou complètes ARNs correspondant aux ressources de AWS AppConfig configuration.

  2. Dans le compte exécutant la fonction Lambda, ajoutez la variable d'AWS_APPCONFIG_EXTENSION_ROLE_ARNenvironnement à la fonction Lambda avec le rôle créé à ARN l'étape 1.

  3. (Facultatif) Si nécessaire, un identifiant externe peut être spécifié à l'aide de la variable d'AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_IDenvironnement. De même, un nom de session peut être configuré à l'aide de la variable d'AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAMEenvironnement.

Note

Notez les informations suivantes.

  • L'extension AWS AppConfig Agent Lambda ne peut récupérer les données que d'un seul compte. Si vous spécifiez un IAM rôle, l'extension ne pourra pas récupérer les données de configuration du compte sur lequel la fonction Lambda est exécutée.

  • AWS Lambda enregistre les informations relatives à l'extension AWS AppConfig Agent Lambda et à la fonction Lambda à l'aide d'Amazon Logs. CloudWatch

Variable d'environnement Détails Valeur par défaut

AWS_APPCONFIG_EXTENSION_HTTP_PORT

Cette variable d'environnement indique le port sur lequel s'exécute le HTTP serveur local hébergeant l'extension.

 2772

AWS_APPCONFIG_EXTENSION_LOG_LEVEL

Cette variable d'environnement indique quels journaux AWS AppConfig spécifiques à une extension sont envoyés à Amazon CloudWatch Logs pour une fonction. Les valeurs valides ne distinguant pas les majuscules et minuscules sont les suivantes : debuginfo,, warnerror, et. none Debug inclut des informations détaillées, y compris des informations temporelles, sur l'extension.

info

AWS_APPCONFIG_EXTENSION_MAX_CONNECTIONS

Cette variable d'environnement configure le nombre maximal de connexions utilisées par l'extension pour récupérer les configurations. AWS AppConfig

 3

AWS_APPCONFIG_EXTENSION_POLL_INTERVAL_SECONDS

Cette variable d'environnement contrôle la fréquence à laquelle l'extension interroge AWS AppConfig une configuration mise à jour en secondes.

 45

AWS_APPCONFIG_EXTENSION_POLL_TIMEOUT_MILLIS

Cette variable d'environnement contrôle la durée maximale, en millisecondes, pendant laquelle l'extension attend une réponse AWS AppConfig lors de l'actualisation des données dans le cache. Si AWS AppConfig elle ne répond pas dans le délai spécifié, l'extension ignore cet intervalle d'interrogation et renvoie les données mises en cache précédemment mises à jour.

 3000

AWS_APPCONFIG_EXTENSION_PREFETCH_LIST

Cette variable d'environnement indique les données de configuration que l'extension commence à récupérer avant l'initialisation de la fonction et l'exécution du gestionnaire. Cela permet de réduire considérablement le temps de démarrage à froid de la fonction.

 Aucun
AWS_APPCONFIG_EXTENSION_PROXY_HEADERS Cette variable d'environnement spécifie les en-têtes requis par le proxy référencé dans la variable d'AWS_APPCONFIG_EXTENSION_PROXY_URLenvironnement. La valeur est une liste d'en-têtes séparés par des virgules. Chaque en-tête utilise le formulaire suivant : 
"header: value"
 Aucun
AWS_APPCONFIG_EXTENSION_PROXY_URL Cette variable d'environnement indique le proxy URL à utiliser pour les connexions entre l' AWS AppConfig extension et services AWS. HTTPSet HTTP URLs sont pris en charge. Aucun
AWS_APPCONFIG_EXTENSION_ROLE_ARN Cette variable d'environnement indique le IAM rôle ARN correspondant à un rôle qui doit être assumé par l' AWS AppConfig extension pour récupérer la configuration. Aucun
AWS_APPCONFIG_EXTENSION_ROLE_EXTERNAL_ID Cette variable d'environnement indique l'identifiant externe à utiliser conjointement avec le rôle assuméARN. Aucun
AWS_APPCONFIG_EXTENSION_ROLE_SESSION_NAME Cette variable d'environnement indique le nom de session à associer aux informations d'identification pour le IAM rôle assumé. Aucun
AWS_APPCONFIG_EXTENSION_SERVICE_REGION Cette variable d'environnement indique une région alternative que l'extension doit utiliser pour appeler le AWS AppConfig service. Lorsqu'elle n'est pas définie, l'extension utilise le point de terminaison de la région actuelle. Aucun

AWS_APPCONFIG_EXTENSION_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. Vous pouvez saisir l'une des valeurs suivantes :

  • "app:env:manifest-config"

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

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.

true

AWS_APPCONFIG_EXTENSION_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