Didacticiel : création d’une fonction CloudFront qui inclut des valeurs de clés - Amazon CloudFront
PrérequisCréation du magasin de clés-valeursAjout des paires clé-valeur au magasin de clés-valeursAssociation du magasin de clés-valeurs à la fonctionTest et publication du code de la fonction

Didacticiel : création d’une fonction CloudFront qui inclut des valeurs de clés

Ce didacticiel vous montre comment inclure des valeurs de clés avec une fonction CloudFront. Les valeurs de clés font partie d’une paire clé-valeur. Vous incluez le nom (provenant de la paire clé-valeur) dans le code de la fonction. Quand la fonction est exécutée, CloudFront remplace le nom par la valeur.

Les paires clé-valeur sont des variables stockées dans un magasin de clés-valeurs. 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.

Prérequis

Si vous débutez avec les fonctions CloudFront et avec le magasin de clés-valeurs, nous vous recommandons de suivre le didacticiel dans Didacticiel : création d’une fonction simple avec les fonctions CloudFront.

Une fois ce didacticiel terminé, vous pouvez suivre celui-ci pour étendre la fonction que vous avez créée. Pour ce didacticiel, nous vous recommandons de commencer par créer le magasin de clés-valeurs.

Création du magasin de clés-valeurs

Commencez par créer le magasin de clés-valeurs à utiliser pour votre fonction.

Pour créer le magasin de clés-valeurs

  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 même magasin de clés-valeurs.

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

    • Créez un magasin de clés-valeurs et ajoutez-y les 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 de clés-valeurs et ajoutez les paires clé-valeur.

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

  4. Dans le volet de navigation, choisissez Fonctions, puis l’onglet KeyValueStores.

  5. Choisissez Créer un KeyValueStore et complétez les champs suivants :

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

    • Laissez URI S3 vide. Dans ce didacticiel, vous saisirez manuellement les paires clé-valeur.

  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.

Ajout des paires clé-valeur au magasin de clés-valeurs

Ensuite, ajoutez manuellement une liste de paires clé-valeur au magasin de clés-valeurs que vous avez créé précédemment.

Pour ajouter des paires clé-valeur au magasin de clés-valeurs

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

  2. Choisissez Ajouter une paire et 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 de clés-valeurs. Dans la boîte de dialogue de confirmation, choisissez Terminé.

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

Association du magasin de clés-valeurs à 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 clés-valeurs à 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 et dans la section KeyValueStore associé, choisissez Associer le KeyValueStore existant.

  3. Sélectionnez le magasin de clés-valeurs et choisissez Associer le KeyValueStore.

Note

Vous pouvez associer un seul magasin de clés-valeurs à chaque fonction.

Test et publication du code de la fonction

Après avoir associé le magasin de clés-valeurs à 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.

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

  • Modification de la valeur d’une paire clé-valeur.

Pour tester et publier le code de la 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 environnement LIVE.

    Lorsque vous publiez la fonction, CloudFront copie la version de la fonction à partir de la phase DEVELOPMENT vers la phase 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 Publication de fonctions.