Récupération des données de configuration à l'aide de l'extension AWS AppConfig Agent Lambda

Une AWS Lambda extension est un processus complémentaire qui augmente les capacités d'une fonction Lambda. Une extension peut démarrer avant qu'une fonction ne soit invoquée, s'exécuter en parallèle avec une fonction et continuer à s'exécuter après le traitement de l'appel de fonction. En substance, une extension Lambda est comme un client qui s'exécute en parallèle à un appel Lambda. Ce client parallèle peut s'interfacer avec votre fonction à tout moment au cours de son cycle de vie.

Si vous utilisez des indicateurs de AWS AppConfig fonctionnalité ou d'autres données de configuration dynamiques dans une fonction Lambda, nous vous recommandons d'ajouter l'extension Agent AWS AppConfig Lambda en tant que couche à votre fonction Lambda. Cela simplifie les indicateurs de fonctionnalité d'appel, et l'extension elle-même inclut les meilleures pratiques qui simplifient l'utilisation AWS AppConfig tout en réduisant les coûts. La réduction des coûts résulte de la diminution du nombre d'appels d'API au AWS AppConfig service et de la réduction des temps de traitement des fonctions Lambda. Pour plus d'informations sur les extensions Lambda, consultez la section Extensions Lambda dans le Guide du développeur.AWS Lambda

Cette rubrique inclut des informations sur l'extension AWS AppConfig Agent Lambda et la procédure de configuration de l'extension pour qu'elle fonctionne avec votre fonction Lambda.

Comment ça marche

Si vous gérez les configurations d'une fonction Lambda sans extensions Lambda, vous devez configurer votre fonction Lambda pour recevoir des mises à jour de configuration en intégrant les actions et API. AWS AppConfig StartConfigurationSessionGetLatestConfiguration

L'intégration de l'extension AWS AppConfig Agent Lambda à votre fonction Lambda simplifie ce processus. L'extension se charge d'appeler le AWS AppConfig service, de gérer un cache local de données récupérées, de suivre les jetons de configuration nécessaires pour les prochains appels de service et de vérifier périodiquement les mises à jour de configuration en arrière-plan. Le schéma suivant montre comment cela fonctionne.

Avant de commencer

Avant d'activer l'extension AWS AppConfig Agent Lambda, procédez comme suit :

Ajout de l'extension AWS AppConfig Agent Lambda

Pour utiliser l'extension AWS AppConfig Agent Lambda, vous devez l'ajouter à votre Lambda. Cela peut être fait en ajoutant l'extension AWS AppConfig Agent Lambda à votre fonction Lambda sous forme de couche ou en activant l'extension sur une fonction Lambda en tant qu'image de conteneur.

Ajouter l'extension AWS AppConfig Agent Lambda à l'aide d'une couche et d'un ARN

Pour utiliser l'extension AWS AppConfig Agent Lambda, vous devez l'ajouter à votre fonction Lambda sous forme de couche. Pour plus d'informations sur la façon d'ajouter une couche à votre fonction, consultez la section Configuration des extensions dans le Guide du AWS Lambda développeur. Le nom de l'extension dans la AWS Lambda console est AWS- AppConfig -Extension. Notez également que lorsque vous ajoutez l'extension en tant que couche à votre Lambda, vous devez spécifier un Amazon Resource Name (ARN). Dans l'une des listes suivantes, choisissez un ARN correspondant à la plate-forme et à l' Région AWS endroit où vous avez créé le Lambda.

Si vous souhaitez tester l'extension avant de l'ajouter à votre fonction, vous pouvez vérifier qu'elle fonctionne en utilisant l'exemple de code suivant.

import urllib.request
                

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name'
    config = urllib.request.urlopen(url).read()
    return config

Pour le tester, créez une nouvelle fonction Lambda pour Python, ajoutez l'extension, puis exécutez la fonction Lambda. Après avoir exécuté la fonction Lambda, celle-ci renvoie la configuration que vous avez spécifiée pour le chemin http://localhost:2772. AWS AppConfig Pour plus d'informations sur la création d'une fonction Lambda, voir Création d'une fonction Lambda avec la console dans le Guide du développeur.AWS Lambda

Pour ajouter l'extension AWS AppConfig Agent Lambda en tant qu'image de conteneur, consultez. Utilisation d'une image de conteneur pour ajouter l'extension AWS AppConfig Agent Lambda

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 rôle IAM qui accorde des autorisations sur les données. Pour configurer cela, procédez comme suit :

"header: value"

Récupération d'un ou de plusieurs indicateurs à partir d'une configuration d'indicateurs de fonctionnalité

Pour les configurations d'indicateurs de fonctionnalités (configurations de typeAWS.AppConfig.FeatureFlags), l'extension Lambda vous permet de récupérer un seul indicateur ou un sous-ensemble d'indicateurs dans une configuration. La récupération d'un ou deux indicateurs est utile si votre Lambda n'a besoin que de quelques indicateurs du profil de configuration. Les exemples suivants utilisent Python.

Vous pouvez récupérer les données AWS AppConfig de configuration à partir d'un point de terminaison HTTP local. Pour accéder à un indicateur spécifique ou à une liste d'indicateurs, utilisez le paramètre de ?flag=flag_name requête pour un profil AWS AppConfig de configuration.

Pour accéder à un seul drapeau et à ses attributs

import urllib.request

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name'
    config = urllib.request.urlopen(url).read()
    return config

Pour accéder à plusieurs drapeaux et à leurs attributs

import urllib.request

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name?flag=flag_name_one&flag=flag_name_two'
    config = urllib.request.urlopen(url).read()
    return config

Affichage des journaux de AWS AppConfig l'extension Lambda de l'agent Lambda

Vous pouvez consulter les données des journaux de l'extension AWS AppConfig Agent Lambda dans les AWS Lambda journaux. Les entrées du journal sont précédées appconfig agent de. Voici un exemple :

[appconfig agent] 2024/05/07 04:19:01 ERROR retrieve failure for 'SourceEventConfig:SourceEventConfigEnvironment:SourceEventConfigProfile': StartConfigurationSession: api error AccessDenied: User: arn:aws:sts::0123456789:assumed-role/us-east-1-LambdaRole/extension1 is not authorized to perform: sts:AssumeRole on resource: arn:aws:iam::0123456789:role/test1 (retry in 60s)