Publication de fonctions

Lorsque vous publiez votre fonction, celle-ci est copiée de l’étape DEVELOPMENT vers l’étape LIVE.

Si aucun comportement de cache n’est associé à la fonction, sa publication vous permet de l’associer à un comportement de cache. Vous pouvez uniquement associer des comportements de cache à des fonctions qui sont à l'étape LIVE.

Important

• Nous recommandons de tester la fonction avant de la publier.

• Une fois la fonction publiée, tous les comportements de cache qui lui sont associés commencent automatiquement à utiliser la nouvelle copie publiée, dès que les distributions ont terminé leur déploiement.

Vous pouvez publier une fonction dans la console CloudFront ou avec AWS CLI.

Console

Pour publier une fonction

1. Connectez-vous à la console CloudFront à l’adresse https://console.aws.amazon.com/cloudfront/v4/home#/functions et sélectionnez la page Fonctions.

2. Sélectionnez la fonction à mettre à jour.

3. Choisissez l’onglet Publier, puis sélectionnez Publier. Si votre fonction est déjà associée à un ou plusieurs comportements de cache, choisissez Publier et mettre à jour.

4. (Facultatif) Pour afficher les distributions associées à la fonction, choisissez Distributions CloudFront associées pour développer cette section.

En cas de réussite, une bannière apparaît en haut de la page avec le message : Nom de la fonction publié. Vous pouvez également choisir l'onglet Générer, puis Live pour afficher la version live du code de fonction.

CLI

Pour publier une fonction

1. Ouvrez une fenêtre de ligne de commande.

2. Exécutez la commande suivante aws cloudfront publish-function. Dans l’exemple, des sauts de ligne sont fournis pour rendre l’exemple plus lisible.

   aws cloudfront publish-function \
       --name MaxAge \
       --if-match ETVXYZEXAMPLE

   Lorsque la commande s’exécute correctement, vous obtenez une sortie similaire à ce qui suit.

   FunctionSummary:
     FunctionConfig:
       Comment: Max Age 2 years
       Runtime: cloudfront-js-2.0
     FunctionMetadata:
       CreatedTime: '2021-04-18T21:24:21.314000+00:00'
       FunctionARN: arn:aws:cloudfront::111122223333:function/ExampleFunction
       LastModifiedTime: '2023-12-19T23:41:15.389000+00:00'
       Stage: LIVE
     Name: MaxAge
     Status: UNASSOCIATED