Caching in AEM Edge-Funktionen edge-functions-caching

Auf dieser Seite finden Sie detaillierte technische Anleitungen dazu, wie das Caching in AEM Edge funktioniert, einschließlich der Zwei-Cache-Architektur, der Steuerung des Caching-Verhaltens in Ihrem Code und der Bereinigung von Cache-Einträgen bei Inhaltsänderungen.

Allgemeine Informationen zur Funktionsweise der AEM as a Cloud Service-Zwischenspeicherung finden Sie unter Caching in AEM as a Cloud Service und Das CDN in AEM as a Cloud Service. Code-Beispiele finden Sie im AEM Edge Functions Boilerplate - Caching.

Caching-Architektur architecture

AEM Edge-Funktionen befinden sich zwischen dem CDN und den Backend-Services, von denen die Funktion abgerufen wird. Bei diesen Backends kann es sich um AEM-Veröffentlichungsinstanzen, Drittanbieter-APIs, externe Datenbanken oder einen beliebigen HTTP-Endpunkt handeln, den Ihr Code aufruft. Es gibt zwei verschiedene Caches im Anfragefluss, von denen jeder unabhängig arbeitet:

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

Das Verständnis dieser zweischichtigen Architektur ist wichtig, da jeder Cache einen anderen Umfang, andere Steuerelemente und einen anderen Bereinigungsmechanismus hat. Eine effektive Zwischenspeicherung erfordert eine gezielte Konfiguration auf beiden Ebenen.

CDN-Cache (außen) cdn-cache

Der CDN-Cache befindet sich zwischen dem Browser und der Edge-Funktion. Es wird die (Antwort der Edge-Funktion. Sie steuern sein Verhalten, indem Sie standardmäßige HTTP-Cache-Header für Ihre Edge-Funktionsantworten festlegen:

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

Mehrere Ersatzschlüssel werden durch Leerzeichen getrennt. Diese Ersatzschlüssel können verwendet werden, um den CDN-Cache mithilfe der CDN Cache Purge API) zu ​. Das Konzept der Löschung von Ersatzschlüsseln ist dasselbe wie unter Bereinigen des Caches für eine Gruppe von Ressourcen beschrieben. Der wesentliche Unterschied besteht darin, dass die CDN-Ersatzschlüssel hier durch Ihren Edge-Funktions-Code festgelegt werden und nicht durch das Backend.

Edge, Funktion Zwischenspeicher abrufen (innere) fetch-cache

Der Cache zum Abrufen von Edge-Funktionen befindet sich zwischen der Edge-Funktion und den von ihr aufgerufenen Backends. Er speichert die Antwort des Backends in fetch() Aufrufe, die innerhalb Ihres Edge-Funktions-Codes getätigt werden. Es enthält auch alle Daten, die Ihr Code über die Core Cache API oder Simple Cache API speichert - programmgesteuerte Caching-Schnittstellen, die Ihnen eine genaue Kontrolle darüber geben, was wie lange und unter welchen Ersatzschlüsseln zwischengespeichert wird.

Sie wird nicht durch Kopfzeilen beeinflusst, die Sie in der ausgehenden Antwort der Edge-Funktion festlegen - nur durch die Antwort-Kopfzeilen des Backends, durch CacheOverride von Optionen in Ihren Abrufaufrufen oder durch Ersatzschlüssel, die Sie beim Schreiben in die Core-Cache-API programmgesteuert zuweisen.

Caching von Backend-Antworten cache-override

So speichern Sie Backend-Antworten für eine bestimmte Dauer zwischen:

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

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

Umgehen des Cache cache-pass

Um den Abrufcache vollständig zu umgehen und immer aus dem Backend abzurufen, verwenden Sie pass:

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

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

Cache-Bereinigung cache-purging

Wenn zwischengespeicherte Inhalte veraltet sind, müssen Sie sie explizit bereinigen. Da die beiden Caches unabhängig voneinander arbeiten, ist es wichtig zu verstehen, welche Ebene Sie invalidieren und wie sie interagieren.

Koordinieren von Bereinigungen über beide Ebenen hinweg coordinating-purges

Da die Edge-Funktion sich als Backend hinter dem CDN befindet (erreichbar über Origin-Selektoren), kann das Bereinigen einer Cache-Ebene ohne die andere zu unerwarteten Ergebnissen führen:

Best Practice: Bei zugrunde liegenden Datenänderungen, Bereinigen beide Caches - Verwenden Sie die CDN Cache Purge API für die äußere Ebene und purge-cache (oder purgeSurrogateKey()) für die innere Edge-Funktionsebene. Die Verwendung konsistenter Ersatzschlüssel auf beiden Ebenen vereinfacht die koordinierte Invalidierung. Ein vollständiges Beispiel für dieses Muster finden Sie unter AEM Edge Functions Boilerplate - Purging.

Bereinigen des CDN-Cache purge-cdn-cache

Um den äußeren CDN-Cache zu bereinigen (die auf CDN-Ebene zwischengespeicherte Antwort der Edge-Funktion), verwenden Sie die CDN Cache Purge API. Dies ist derselbe Bereinigungsmechanismus, der für alle im CDN zwischengespeicherten AEM as a Cloud Service-Inhalte verwendet wird - siehe Bereinigen des CDN-Cache für eine schrittweise Anleitung.

In der AEM as a Cloud Service-Architektur empfangen Edge-Funktionen Traffic vom CDN über Ursprungsselektoren (siehe auch CDN-Routing). Der vollständige Anfragefluss ist:

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

Das CDN speichert die endgültige Antwort zwischen, die von der Edge-Funktion zurückgegeben wird. Eine CDN-Bereinigung löscht nur diese äußere zwischengespeicherte Antwort - sie hat keine Auswirkungen auf die internen Caches der Edge-Funktion.

Löschen des Cache für Edge-Funktionsabrufe purge-fetch-cache

Der purge-cache CLI-Befehl löscht den Cache für den Abruf der Edge-Funktion (die Backend-Antworten, die innerhalb der Edge-Funktion zwischengespeichert wurden). Der äußere CDN Cache wird gelöscht. Vollständige CLI-Optionen und -Flags finden Sie in der purge-cache-Befehlsreferenz.

Woher die Ersatzschlüssel kommen surrogate-key-origin

Ersatzschlüssel, die in Bereinigungsbefehlen verwendet werden, müssen mit den Schlüsseln übereinstimmen, die im zwischengespeicherten Inhalt zum Zeitpunkt seiner Speicherung getaggt waren. Dies entspricht dem Konzept der schlüsselbasierten Ersatzbereinigung, das im AEM CDN verwendet wird, wird aber auf den internen Cache der Edge-Funktion angewendet. Diese Schlüssel stammen aus:

Wenn Ihr Backend beispielsweise mit antwortet:

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

Anschließend wird die zwischengespeicherte Antwort mit drei Ersatzschlüsseln getaggt: page-about, product-456 und category-shoes. Sie können sie später mit einem dieser Schlüssel bereinigen:

# 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

Alle bereinigen purge-all

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

Soft Purge soft-purge

Verwenden Sie das --soft-Flag, um eine Soft Purge durchzuführen, bei der veraltete Einträge im Cache beibehalten werden und die Backend-Last reduziert wird, während eine veraltete erneute Überprüfung aktiviert wird:

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

Bereinigung programmatic-purge

Sie können Ersatzschlüssel auch programmgesteuert aus Ihrem Edge-Funktions-Code löschen, indem Sie purgeSurrogateKey verwenden:

import { purgeSurrogateKey } from "fastly:compute";

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

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