Utilisation des actions et des déclencheurs de la fonction Edge

Les fonctions de bordure se composent de deux éléments principaux : les actions et les déclencheurs. Les actions sont des fichiers JavaScript qui définissent la logique à exécuter au niveau du bord. Les déclencheurs sont des règles de routage basées sur des URL qui définissent quand et dans quelles circonstances ces actions doivent être exécutées. Les déclencheurs relient des modèles de demande spécifiques (comme les domaines et les chemins) aux actions appropriées. Sans déclencheur associé, une action n'aura pas d'impact sur le trafic.

Actions de la fonction de bord

Les actions sont écrites en JavaScript et nécessitent un programme d'écoute d'événement pour répondre à un événement déclencheur. Les actions n'affectent pas votre trafic à moins d'être utilisées par un déclencheur.

Différences entre les régimes

Les différences dans le travail avec les actions dépendent de votre plan :

Plans standard

  • N'autorisez qu'une seule action par compte, nommée automatiquement d'après votre domaine (le nom ne peut pas être changé).
  • Pour mettre à jour une action, téléchargez un nouveau fichier JavaScript ou modifiez le code directement dans l'éditeur. Le téléchargement d'un nouveau fichier remplace l'action existante.
  • Lorsque vous téléchargez un fichier JavaScript, son nom est toujours défini sur votre nom de domaine.

Plans d'entreprise

  • Vous pouvez télécharger un nombre illimité de scripts, chacun avec un nom unique si vous le souhaitez.
  • Lors de la création d'une action, vous pouvez spécifier un nom personnalisé.
  • Lors du téléchargement d'un fichier JavaScript, le nom de l'action est repris du nom du fichier.

Gestion des actions

Vous pouvez créer, télécharger, modifier et gérer des actions pour définir la logique que votre fonction Edge exécute en réponse à des événements déclencheurs. La console fournit des outils pour chacune des opérations principales :

  • Création d'une action- Cliquez sur Créer pour ajouter une action à l'aide de l'éditeur de code intégré. Après avoir ajouté votre code JavaScript, cliquez sur Enregistrer pour créer votre action.

  • Lecture d'une action- Cliquez sur une action existante dans le tableau des actions pour l'ouvrir dans l'éditeur. Cela vous permet de visualiser son code sans y apporter de modifications.

  • Mise à jour d'une action- Pour modifier une action, ouvrez-la dans l'éditeur en cliquant dessus dans la liste. Effectuez vos modifications, puis cliquez sur Enregistrer. Lorsque vous enregistrez vos modifications, l'action mise à jour est téléchargée. Si l'action est en cours d'utilisation, les mises à jour prennent effet immédiatement.

  • Téléchargement d'une action- Cliquez sur Télécharger pour télécharger un fichier JavaScript. Le téléchargement ou la création d'une action portant le même nom qu'une action existante entraîne le remplacement de l'action existante. Renommez le fichier d'action avant de le télécharger ou saisissez un nom unique lors de la création pour éviter ce comportement.

    Le téléchargement peut également être utilisé dans le cadre de la création ou de la mise à jour d'une action, selon que le nom existe déjà ou non.

  • Suppression d'une action- Pour supprimer une action, cliquez sur l'icône Supprimer Icône Supprimer dans la ligne du tableau pour l'action sélectionnée. Une action ne peut pas être supprimée tant qu'elle est associée à un déclencheur. Pour supprimer l'action, vous devez d'abord supprimer tous les déclencheurs qui l'utilisent. La colonne Usages indique le nombre de déclencheurs liés à chaque action.

  • Associer un déclencheur- Les déclencheurs sont nécessaires à l'exécution d'une action. Ajoutez un déclencheur dans l'onglet Déclencheurs et sélectionnez l'action dans la liste des actions existantes. La colonne Utilisations du tableau des actions affiche le nombre de déclencheurs actuellement liés à chaque action.

Déclencheurs de fonction de bord

Les déclencheurs (routes) déterminent comment le trafic du domaine est acheminé vers les actions. Ils associent les modèles URL, basés sur un domaine du compte, à une action prédéfinie. Le modèle URL doit inclure le domaine et peut contenir des caractères génériques en tant que préfixe du domaine ou à la fin du chemin. Si aucun chemin n'est spécifié, une adresse / est ajoutée implicitement. URL ne peuvent pas contenir de caractères génériques infixes ou de paramètres de requête.

Différences entre les régimes

Il n'y a pas de différences dans le fonctionnement des déclencheurs d'un régime à l'autre. Tous les plans permettent d'ajouter, de modifier et de supprimer des déclencheurs.

Utilisation des déclencheurs

Vous devez ajouter un domaine avant d'ajouter des déclencheurs. Les déclencheurs définissent la manière dont le trafic est acheminé vers les actions de la fonction Edge. Un déclencheur relie un modèle URL à une action existante.

Les déclencheurs peuvent être créés même si aucune action n'existe encore, mais ils n'invoqueront aucune logique tant qu'une action n'aura pas été sélectionnée.

  • Ajout d'un déclencheur- Allez dans l'onglet Déclencheurs et cliquez sur Ajouter un déclencheur. Saisissez un modèle URL, puis sélectionnez une action dans la liste des actions existantes à associer à ce modèle. Il établit le lien entre un itinéraire et une action.

    Pour qu'un chemin de déclenchement reste actif sans exécuter de fonction de bord, activez la fonction Éviter les fonctions de bord. Par exemple, si my-function est affecté à gamma.cistest-load.com/*, mais que vous souhaitez que gamma.cistest-load.com/data le contourne, créez un déclencheur distinct pour /data et activez les fonctions de contournement. Cela permet de s'assurer que le chemin /data reste actif sans invoquer my-function.

  • Modification d'un déclencheur- Cliquez sur l'icône Modifier Icône Modifier dans la ligne du tableau le déclencheur que vous souhaitez modifier, puis apportez les modifications et cliquez sur Enregistrer.

  • Suppression d'un déclencheur- Cliquez sur l'icône Supprimer Icône Supprimer dans le tableau la ligne du déclencheur que vous souhaitez modifier. Cette action est irréversible. La suppression d'un déclencheur supprime l'association entre l'itinéraire et l'action.