Edge Security Acceleration:Utiliser EdgeRoutine dans la console DCDN

Flux de travail

Pour utiliser EdgeRoutine, activez d'abord DCDN. La figure suivante illustre le flux de travail.

Activer le service EdgeRoutine

1. Connectez-vous à la console DCDN.

2. Dans le volet de navigation de gauche, cliquez sur EdgeRoutine.

3. Cliquez sur Enable EdgeRoutine > Activate Now pour activer le service.

Créer et configurer une routine

1. Connectez-vous à la console DCDN.

2. Dans le volet de navigation de gauche, cliquez sur EdgeRoutine.

3. Si vous utilisez EdgeRoutine pour la première fois, créez d'abord un sous-domaine.

   1. Sur la page EdgeRoutine, cliquez sur Create Subdomain.

      

   2. Dans la boîte de dialogue Create Subdomain, saisissez un nom de sous-domaine.

      Remarque

      • Un sous-domaine sert de référentiel pour toutes vos routines. Il ne peut pas être modifié après sa création.

      • Ce sous-domaine constitue un identifiant unique pour chaque utilisateur et fait partie de l'ID de la routine.

      • Le nom doit contenir uniquement des lettres minuscules, des chiffres et des traits d'union (-), et comporter au moins deux caractères (exemple : subdomain-name).

   3. Cliquez sur OK.

4. Sur la page EdgeRoutine, cliquez sur Create Routine.

   

   Paramètre	Description
   Routine Name	Saisissez un nom pour la routine. Remarque The name can contain lowercase letters, digits, and hyphens (-). The name cannot be less than 2 characters in length. Example: routine-name. The routine name cannot be modified after it is created.
   Description	(Facultatif) Description de la routine.
   Specification	Temps CPU maximal pour une seule exécution de routine, hors temps d'attente E/S pour les réponses réseau. La durée d'exécution maximale est de 120 secondes et la mémoire disponible est de 128 Mo. Les frais varient selon la spécification sélectionnée. La spécification 50 ms est sélectionnée par défaut. Pour plus d'informations, consultez Facturation d'EdgeRoutine. CPU Time Slice for Individual Requests: 5 ms CPU Time Slice for Individual Requests: 50 ms (par défaut) CPU Time Slice for Individual Requests: 100 ms

5. Après avoir créé la routine, cliquez sur Details dans la colonne Actions pour ouvrir sa page de détails. Chaque environnement (production, préproduction et canary facultatif) dispose d'une configuration indépendante modifiable.

   Paramètre	Description
   Routine Specifications	Temps CPU maximal pour une seule exécution de routine, hors temps d'attente E/S pour les réponses réseau. La durée d'exécution maximale est de 120 secondes et la mémoire disponible est de 128 Mo. La spécification 50 ms est sélectionnée par défaut. CPU Time Slice for Individual Requests: 5 ms CPU Time Slice for Individual Requests: 50 ms (par défaut) CPU Time Slice for Individual Requests: 100 ms
   Domain Name Whitelist	Définit les domaines pouvant être associés à cette routine. Les domaines génériques sont pris en charge. Par défaut, la liste d'autorisation de noms de domaine est vide, ce qui permet d'associer n'importe quel domaine à la routine. Remarque Par exemple, si vous ajoutez example.com à la liste d'autorisation, seules les requêtes provenant d'example.com peuvent déclencher cette routine. Les requêtes provenant d'autres domaines sont rejetées.

Associer un domaine à une routine

Une routine nécessite un domaine pour servir de point d'entrée aux requêtes client. Vous pouvez utiliser un domaine accéléré par Alibaba Cloud CDN ou DCDN. Après avoir créé et configuré la routine, associez-lui votre domaine Alibaba Cloud CDN ou DCDN. Les requêtes client vers ce domaine déclencheront alors la routine. La procédure varie selon la console où votre domaine est hébergé.

1. Connectez-vous à la console DCDN.

2. Dans le volet de navigation de gauche, cliquez sur Domain Names.

3. Sur la page Domain Names, recherchez le nom de domaine cible et cliquez sur Configure.

4. Dans le volet de navigation de gauche du domaine, cliquez sur EdgeRoutine.

5. Sur la page EdgeRoutine, activez la fonctionnalité et configurez l'Routine ID.

   

   Paramètre	Description
   Routine ID	Identifiant unique de chaque routine. Le format est routine-name.subdomain. Remarque Dans le volet de navigation de gauche de la console DCDN, cliquez sur EdgeRoutine. Vous trouverez l'ID de la routine correspondante sur la page Function.
   Trigger Mode	Les requêtes adressées au domaine ou DCDN déclenchent la routine. Deux modes sont disponibles : Redirect : La routine traite intégralement les requêtes adressées au domaine ou DCDN. Vous pouvez écrire votre propre code pour répondre directement au client, lire depuis le cache via l'API Cache ou récupérer du contenu à l'origine. Bypass : Les requêtes adressées au domaine ou DCDN déclenchent uniquement l'exécution de la routine, puis suivent la configuration ou DCDN standard pour rediriger vers l'origine. Ce mode convient aux scénarios tels que l'authentification ou la journalisation.
   Redirect to Origin if Error Occurs	Yes : Si l'exécution d'une routine échoue, le point de présence (POP) transfère la requête client au serveur d'origine du domaine ou DCDN. Cela vous permet de mettre en œuvre des mécanismes de repli et de reprise après sinistre sur votre serveur d'origine. No : Si l'exécution d'une routine échoue, le POP retourne directement un code d'état 5xx au client. Remarque Lors de votre première utilisation d'une routine, nous vous recommandons de définir le paramètre Redirect to Origin if Error Occurs sur No. Vous pouvez ainsi utiliser le code d'état HTTP 5xx retourné pour résoudre les problèmes. En cas d'exception, le nombre de requêtes vers l'origine vous est facturé. Le pourcentage de requêtes anormales vers l'origine est très faible et peut être ignoré.

Développer et déboguer une routine

1. Connectez-vous à la console DCDN.

2. Dans le volet de navigation de gauche, cliquez sur EdgeRoutine.

3. Sélectionnez la routine créée et cliquez sur Details.

4. Sur la page Details, sélectionnez l'onglet Code pour développer votre EdgeRoutine en JavaScript. L'éditeur inclut un exemple « Hello World » par défaut.

5. Après avoir écrit le code, cliquez sur Release to Staging Environment. Utilisez ensuite l'une des adresses IP de l'environnement de préproduction fournies pour configurer votre fichier hosts local afin de tester et déboguer la routine.

   Remarque

   Pour tester, modifiez le fichier hosts de votre machine locale afin d'associer le domaine à l'une des adresses IP de préproduction fournies. Par exemple : 10.10.10.10 example.com. Remplacez l'adresse IP par l'une des adresses fournies et le nom de domaine par le domaine Alibaba Cloud CDN ou DCDN associé à la routine.

Créer une version

Publier une version

1. Sur la page Details, sélectionnez l'onglet Versions. Choisissez un ID de version et cliquez sur Release dans la colonne Actions.

2. Sélectionnez l'environnement de publication : Staging Environment, Production Environment ou Canary Environment.

   Remarque

   We recommend that you release a routine to the canary environments before you release it to the production environments.

3. Cliquez sur OK. La nouvelle version sera déployée sur les POP de l'environnement sélectionné.

Maintenance des routines

Les étapes précédentes décrivent la configuration et la publication d'un exemple de routine « Hello World ».

• Pour mettre à jour et itérer sur le code d'une routine, suivez les étapes des sections « Développer et déboguer une routine », « Créer une version » et « Publier une version ».

• Pour ajuster les configurations d'une routine (spécifications, liste d'autorisation de noms de domaine, etc.), reportez-vous à la section « Créer et configurer une routine ».

• Pour désactiver la fonctionnalité EdgeRoutine pour un domaine Alibaba Cloud CDN ou DCDN, supprimez la configuration EdgeRoutine des paramètres d'association du domaine.

FAQ

• Comment choisir la spécification de routine appropriée ?

• Comment mettre en œuvre un plan de repli en cas d'échec d'exécution de routine ?

• Comment annuler une publication canary ?

• Comment supprimer un environnement canary ?

• Comment choisir la région appropriée pour une publication canary ?

• Résoudre les erreurs courantes d'EdgeRoutine (ER)