Fonctions d’AEM Edge

IMPORTANT
AEM Edge Functions est actuellement en version bêta. Les fonctionnalités et la documentation peuvent changer. Pour tout commentaire, contactez 🔗.

Les fonctions AEM Edge vous permettent d’exécuter JavaScript sur le réseau CDN Adobe en périphérie, à proximité de vos visiteurs et sans aller-retour vers l’origine. Ils travaillent sur les sites AEM as a Cloud Service et Edge Delivery Services avec le réseau CDN géré par Adobe.

Que sont les fonctions AEM Edge ?

Les fonctions AEM Edge sont des modules JavaScript déployés et exécutés sur le réseau CDN Adobe (optimisé par Fastly Compute). Lorsqu’une requête correspond à une règle de routage CDN dans cdn.yaml, la fonction AEM Edge l’intercepte, lit les en-têtes, appelle les serveurs principaux, transforme les réponses et renvoie le résultat de l’Edge de .

Les modèles courants incluent la personnalisation générée par le serveur, la mise en proxy sécurisée d’API et l’agrégation des réponses.

Quand utiliser les fonctions AEM Edge ?

Utilisez le guide suivant pour choisir entre les fonctions AEM Edge et les autres options d’extensibilité d’AEM.

Scénario
Approche recommandée
Exécuter une logique personnalisée, appeler des API externes, personnaliser les réponses en périphérie
Fonctions d’AEM Edge
Logique commerciale complexe avec un contexte AEM complet (pour la pile Java AEM as a Cloud Service) à l’origine.
Service OSGi ou servlet Sling

Privilégiez les fonctions AEM Edge pour le contenu dynamique ou les données qui nécessitent de la vitesse, de la sécurité et de l’évolutivité sans aller-retour vers l’origine.

Pourquoi utiliser les fonctions AEM Edge ?

Les fonctions AEM Edge relèvent quatre défis courants lors de la création d’expériences dynamiques diffusées sur le réseau CDN.

Avantage
Description
Performances
Délai de premier octet réduit avec exécution côté périphérie et pas d’aller-retour d’origine pour les modèles courants
SEO
HTML rendu sur le serveur à la première explore, convivial pour les moteurs de recherche et les robots d’exploration d’IA
Sécurité
Les informations d’identification et les secrets d’API restent côté serveur et ne sont jamais exposés dans le JavaScript client
Personnalisation
Personnaliser le contenu par zone géographique, appareil ou audience avant le chargement de la page

Fonctionnement

Une fonction AEM Edge se trouve entre le cache du réseau CDN et vos serveurs principaux. Il traite les requêtes correspondantes avant qu’elles n’atteignent l’origine.

Flux de requête des fonctions AEM Edge {align="center"}

Il existe deux couches de cache indépendantes : la cache CDN (ce que le navigateur voit) et la cache de récupération (ce que la fonction AEM Edge voit lors de l’appel des serveurs principaux). Invalider chaque calque séparément lorsque les données sous-jacentes changent.

Pour plus d’informations, voir ​ Mise en cache dans les fonctions AEM Edge ​.

Prise en main

Choisissez si vous utilisez AEM as a Cloud Service ou un site Edge Delivery Services et suivez le tutoriel de configuration. Vous déployez une fonction JavaScript AEM Edge avec des itinéraires /hello-world et /weather, configurez le routage CDN, envoyez le code sur le réseau CDN Adobe et vérifiez les réponses du Edge de diffusion de contenu.

Configuration sur AEM as a Cloud Service

Configuration sur AEM as a Cloud Service

Installez l’interface de ligne de commande, déployez WKND (ou votre site), configurez le routage CDN et vérifiez les points d’entrée des fonctions Edge AEM sur AEM as a Cloud Service.

Configurer

Configuration sous Edge Delivery Services

Configuration sur Edge Delivery Services

Intégrez votre site Edge Delivery à Cloud Manager, liez votre référentiel et déployez des points d’entrée de fonction AEM Edge sur Edge Delivery Services.

Configurer

Procédures

Guides axés sur le code pour les modèles de fonction AEM Edge courants.

Thème
Description
Créer un point d’entrée d’API
Exposez les points d’entrée HTTP avec le gestionnaire d’événements de récupération, les sélecteurs d’origine du réseau CDN et les appels d’API tiers ou de récupération sortante facultatifs
Servir plusieurs points d’entrée
Une seule fonction peut exposer de nombreux points d’entrée ; organisez la logique du gestionnaire à mesure que votre API se développe
Filtres de requête HTTP
Ajustez les requêtes ou réponses HTTP au niveau du réseau CDN avec des règles de sélecteur d’origine et un gestionnaire de récupération
Utiliser des configurations et des secrets
Transmettez des configurations non sensibles et des secrets sensibles à une fonction via edgeFunctions.yaml et lisez-les dans le code
Stockage des données en périphérie
Activez un magasin de clés pour lire et écrire des données de valeur de clé d’exécution qui persistent à la périphérie des appels de fonction

Limites de Platform

Gardez à l’esprit les limites suivantes lorsque vous concevez la logique de fonction AEM Edge.

Limite
Valeur
Nbre max. d’appels de récupération sortante par appel
32
Fonctions max. d’AEM Edge (AEM as a Cloud Service)
1 par environnement
Fonctions Max AEM Edge (Edge Delivery Services)
3 par programme (pour la branche principale, d’évaluation et de développement de votre projet Edge Delivery Services qui sont mappées aux sites de production, d’évaluation et de développement, respectivement)
Magasins de configuration, secrets et KV (programmes Sandbox)
Non disponible

Pour obtenir la liste complète des limitations, voir Limitations dans la documentation du produit Fonctions d’AEM Edge .

Ressources supplémentaires

recommendation-more-help
experience-manager-learn-help-cloud-service