Tutoriel : Création d'une CloudFront fonction incluant des valeurs clés

Ce didacticiel explique comment inclure des valeurs clés dans une CloudFront fonction. Les valeurs clés font partie d'une paire clé-valeur. Vous incluez le nom (issu de la paire clé-valeur) dans le code de fonction. Lorsque la fonction s'exécute, CloudFront remplace le nom par la valeur.

Les paires clé-valeur sont des variables stockées dans un magasin clé-valeur. Lorsque vous utilisez une clé dans votre fonction (à la place de valeurs codées en dur), votre fonction est plus flexible. Vous pouvez modifier la valeur de la clé sans avoir à déployer de modifications de code. Les paires clé-valeur peuvent également réduire la taille de votre fonction. Pour plus d’informations, consultez Amazon CloudFront KeyValueStore.

Table des matières

• Prérequis
• Créez le magasin de valeur clé
• Ajouter des paires clé-valeur au magasin clé-valeur
• Associez le magasin de valeurs clés à la fonction
• Testez et publiez le code de fonction

Prérequis

Si vous découvrez les CloudFront fonctions et le magasin de valeurs clés pour la première fois, nous vous recommandons de suivre le didacticiel dansTutoriel : Création d'une fonction simple avec CloudFront Functions.

Après avoir terminé ce didacticiel, vous pouvez suivre ce didacticiel pour étendre la fonction que vous avez créée. Pour ce didacticiel, nous vous recommandons de créer d'abord le magasin de valeurs clés.

Créez le magasin de valeur clé

Créez d'abord le magasin de valeurs clés à utiliser pour votre fonction.

Pour créer le magasin de valeurs clés

1. Planifiez les paires clé-valeur que vous souhaitez inclure dans la fonction. Notez les noms de clés. Les paires clé-valeur que vous souhaitez utiliser dans une fonction doivent se trouver dans un seul magasin clé-valeur.

2. Décidez de l’ordre de travail. Il existe deux façons de procéder :

   • Créez un magasin clé-valeur et ajoutez-y des paires clé-valeur. Créez (ou modifiez) ensuite la fonction et incorporez les noms des clés.

   • Ou, créez (ou modifiez) la fonction et incorporez les noms des clés que vous voulez utiliser. Créez ensuite un magasin clé-valeur et ajoutez les paires clé-valeur.

3. Connectez-vous à la CloudFront console AWS Management Console et ouvrez-la à l'adressehttps://console.aws.amazon.com/cloudfront/v4/home.

4. Dans le volet de navigation, choisissez Functions, puis sélectionnez l'KeyValueStoresonglet.

5. Choisissez Créer KeyValueStore et saisissez les champs suivants :

   • Entrez un nom et une description (facultative) pour le magasin.

   • Laissez l'URI S3 vide. Dans ce didacticiel, vous allez saisir les paires clé-valeur manuellement.

6. Choisissez Créer. La page de détails du nouveau magasin de clés-valeurs apparaît. Cette page inclut une section Paires clé-valeur qui est actuellement vide.

Ajouter des paires clé-valeur au magasin clé-valeur

Ajoutez ensuite manuellement une liste de paires clé-valeur au magasin clé-valeur que vous avez créé précédemment.

Pour ajouter des paires clé-valeur au magasin clé-valeur

1. Dans la section Paires clé-valeur, choisissez Ajouter des paires clé-valeur.

2. Choisissez Ajouter une paire, puis entrez une clé et une valeur. Cochez la case pour confirmer vos modifications et répétez cette étape pour en ajouter d'autres.

3. Lorsque vous avez terminé, choisissez Enregistrer les modifications pour enregistrer les paires clé-valeur dans le magasin clé-valeur. Dans la boîte de dialogue de confirmation, choisissez OK.

Vous disposez désormais d'un magasin clé-valeur qui contient un groupe de paires clé-valeur.

Associez le magasin de valeurs clés à la fonction

Vous avez maintenant créé le magasin de clés-valeurs. Vous avez également créé ou modifié une fonction qui inclut les noms des clés à partir du magasin de clés-valeurs. Vous pouvez maintenant associer le magasin de clés-valeurs et la fonction. Vous créez cette association à partir de la fonction.

Pour associer le magasin de valeurs clés à la fonction

1. Dans le volet de navigation, choisissez Fonctions. L’onglet Fonctions apparaît en haut, par défaut.

2. Choisissez le nom de la fonction, puis dans la KeyValueStore section Associé, sélectionnez Associer existant KeyValueStore.

3. Sélectionnez le magasin de valeurs clés, puis choisissez Associer KeyValueStore.

Note

Vous ne pouvez associer qu'une seule banque de valeurs clés à chaque fonction.

Testez et publiez le code de fonction

Après avoir associé le magasin de valeurs clés à votre fonction, vous pouvez tester et publier le code de la fonction. Vous devez tester le code de la fonction chaque fois que vous le modifiez, y compris lorsque vous effectuez les opérations suivantes :

• Association d’un magasin de clés-valeurs à la fonction.

• Modifiez la fonction et son magasin de valeurs clés pour inclure une nouvelle paire clé-valeur.

• Modifiez la valeur d'une paire clé-valeur.

Pour tester et publier le code de fonction

1. Pour en savoir plus sur la façon de tester une fonction, consultez Fonctions de test. Assurez-vous de choisir de tester la fonction dans la phase DEVELOPMENT.

2. Publiez la fonction lorsque vous êtes prêt à l'utiliser (avec les paires clé-valeur nouvelles ou révisées) dans un LIVE environnement.

   Lorsque vous publiez, CloudFront copie la version de la fonction de la DEVELOPMENT scène vers la scène en direct. La fonction possède le nouveau code et est associée au magasin de clés-valeurs. (Il n’est pas nécessaire de répéter l’association, dans la phase en direct.)

   Pour en savoir plus sur la façon de publier la fonction, consultez Fonctions de publication.