Mise en cache dans les fonctions AEM Edge edge-functions-caching

Cette page fournit des conseils techniques détaillés sur le fonctionnement de la mise en cache dans les fonctions AEM Edge, y compris l’architecture à deux caches, sur la manière de contrôler le comportement de mise en cache dans votre code et sur la manière de purger les entrées de cache lorsque le contenu change.

Pour obtenir des informations générales sur le fonctionnement de la mise en cache d’AEM as a Cloud Service, consultez Mise en cache dans AEM as a Cloud Service et Le réseau CDN dans AEM as a Cloud Service. Pour obtenir des exemples de code, reportez-vous au Modèle des fonctions AEM Edge — Mise en cache.

Architecture de mise en cache architecture

Les fonctions AEM Edge se trouvent entre le réseau CDN et les services principaux à partir desquels la fonction récupère. Ces serveurs principaux peuvent être des instances de publication AEM, des API tierces, des bases de données externes ou tout point d’entrée HTTP que votre code appelle. Le flux de requêtes comporte deux caches distincts chacun fonctionnant indépendamment :

Browser → AEM CDN (CDN Cache) → AEM Edge Functions (Fetch Cache) → Backend (AEM, APIs, etc.)

Il est essentiel de comprendre cette architecture à deux couches, car chaque cache a une portée différente, des contrôles différents et un mécanisme de purge différent. Une mise en cache efficace nécessite une configuration délibérée aux deux niveaux.

Cache CDN (externe) cdn-cache

Le cache du réseau CDN se trouve entre le navigateur et la fonction Edge. Il met en cache la réponse de la fonction Edge. Vous contrôlez son comportement en définissant des en-têtes de cache HTTP standard sur vos réponses de fonction Edge :

return new Response(body, {
  headers: {
    'Surrogate-Key': 'page-home product-123',
    'Cache-Control': 'public, max-age=3600'
  }
});

Plusieurs clés de substitution sont séparées par des espaces. Ces clés de substitution peuvent être utilisées pour purger le cache du réseau CDN à l’aide de l’API de purge du cache CDN. Le concept de purge de clé de substitution est identique à celui décrit dans Purge du cache pour un groupe de ressources — la différence essentielle est que les clés de substitution du réseau CDN sont ici définies par votre code de fonction Edge plutôt que par le serveur principal.

Cache de récupération des fonctions Edge (interne) fetch-cache

Le cache de récupération de la fonction Edge se trouve entre la fonction Edge et les serveurs principaux qu’elle appelle. Il met en cache la réponse du serveur principal aux appels fetch() effectués dans votre code de fonction Edge. Il contient également toutes les données stockées par votre code via l’API Core Cache ou l’API Simple Cache, des interfaces de mise en cache programmatiques qui vous permettent de contrôler précisément ce qui est mis en cache, pendant combien de temps et sous quelles clés de substitution.

Il n’est pas influencé par les en-têtes que vous définissez sur la réponse sortante de la fonction Edge, mais uniquement par les en-têtes de réponse du serveur principal, par CacheOverride options sur vos appels de récupération ou par les clés de substitution que vous attribuez par programmation lors de l’écriture dans l’API Core Cache.

Mise en cache des réponses du serveur principal cache-override

Pour mettre en cache les réponses du serveur principal pendant une durée spécifique :

import { CacheOverride } from "fastly:cache-override";

const response = await fetch(request, {
  backend: "my-origin",
  cacheOverride: new CacheOverride({ ttl: 300 })
});

Contournement du cache cache-pass

Pour contourner entièrement le cache de récupération et toujours effectuer une récupération à partir du serveur principal, utilisez le mode pass :

import { CacheOverride } from "fastly:cache-override";

const response = await fetch(request, {
  backend: "my-origin",
  cacheOverride: new CacheOverride({ mode: "pass" })
});

Purge du cache cache-purging

Lorsque le contenu mis en cache devient obsolète, vous devez le purger explicitement. Comme les deux caches fonctionnent indépendamment, il est important de comprendre quel calque vous invalidez et comment ils interagissent.

Coordination Des Purges Sur Les Deux Calques coordinating-purges

Comme la fonction Edge se trouve derrière le réseau CDN en tant que serveur principal (accessible via sélecteurs d’origine), la purge d’une couche de cache sans l’autre peut produire des résultats inattendus :

Bonne pratique : lorsque les données sous-jacentes sont modifiées, purgez les deux les caches : utilisez l’API de purge du cache CDN pour la couche externe et purge-cache (ou purgeSurrogateKey()) pour la couche interne de fonction Edge. L’utilisation de clés de substitution cohérentes sur les deux couches simplifie l’invalidation coordonnée. Pour un exemple complet de ce modèle, reportez-vous à la section Modèle des fonctions AEM Edge — Purge.

Purge du cache du réseau CDN purge-cdn-cache

Pour purger le cache CDN externe (la réponse de la fonction Edge mise en cache au niveau de la couche CDN), utilisez l’API de purge du cache CDN. Il s’agit du même mécanisme de purge utilisé pour tout le contenu AEM as a Cloud Service mis en cache sur le réseau CDN — voir Comment purger le cache CDN pour des conseils détaillés.

Dans l’architecture AEM as a Cloud Service, les fonctions Edge reçoivent le trafic du réseau CDN via des sélecteurs d’origine (voir également Routage CDN). Le flux de requête complet est :

Client → AEM CDN (VCL) → Origin Selector → Edge Function → Backend

Le réseau CDN met en cache la réponse finale renvoyée par la fonction Edge. Une purge du réseau CDN efface uniquement cette réponse mise en cache externe ; elle n’a aucun effet sur les caches internes de la fonction Edge.

Purge du cache de récupération des fonctions Edge purge-fetch-cache

La commande de l’interface de ligne de commande purge-cache purge le cache de récupération de la fonction Edge ​​(les réponses du serveur principal mises en cache dans la fonction Edge). Il ne purge pas cache du réseau CDN externe. Pour connaître les options et les indicateurs de l’interface de ligne de commande complète, consultez la référence des commandes 🔗.purge-cache

D’Où Proviennent Les Clés De Substitution surrogate-key-origin

Les clés de substitution utilisées dans les commandes de purge doivent correspondre aux clés balisées sur le contenu mis en cache au moment de son stockage. Il s’agit du même concept que la purge par clé de substitution utilisée dans le réseau CDN d’AEM, mais appliquée au cache interne de la fonction Edge. Ces clés proviennent de :

Par exemple, si votre serveur principal répond avec :

HTTP/1.1 200 OK
Content-Type: text/html
Surrogate-Key: page-about product-456 category-shoes
Cache-Control: public, max-age=3600

Ensuite, la réponse mise en cache est balisée avec trois clés de substitution : page-about, product-456 et category-shoes. Vous pouvez ensuite le purger à l’aide de l’une de ces clés :

# Purge all cached content tagged with "product-456"
aio aem edge-functions purge-cache <function-name> --surrogateKey product-456

# Purge multiple keys at once
aio aem edge-functions purge-cache <function-name> -k page-about -k category-shoes

Tout purger purge-all

# Purge all cached content (use with caution)
aio aem edge-functions purge-cache <function-name> --all

Purge réversible soft-purge

Utilisez l’indicateur --soft pour effectuer une purge réversible, qui conserve les entrées obsolètes dans le cache et réduit la charge du serveur principal tout en activant la revalidation obsolète :

aio aem edge-functions purge-cache <function-name> --surrogateKey product-456 --soft

Purge programmatique programmatic-purge

Vous pouvez également purger les clés de substitution par programmation à partir de votre code de fonction Edge à l’aide de purgeSurrogateKey :

import { purgeSurrogateKey } from "fastly:compute";

// Hard purge (immediate removal)
purgeSurrogateKey("product-456");

// Soft purge (retain stale entries for revalidation)
purgeSurrogateKey("product-456", true);