AEM Edge-Funktionen

IMPORTANT
AEM Edge Functions befindet sich derzeit in der Beta-Phase. Funktionen und Dokumentation können sich ändern. Wenden Sie sich für Feedback an aemcs-edgecompute-feedback@adobe.com.

Mit den Funktionen von AEM Edge können Sie JavaScript in Adobe CDN am Edge ausführen, in der Nähe Ihrer Besucher und ohne einen Roundtrip zur Ursprungs-URL. Sie arbeiten auf AEM as a Cloud Service- und Edge Delivery Services-Sites mit Adobe Managed CDN.

AEM Edge-Funktionen

AEM Edge-Funktionen sind JavaScript-Module, die in Adobe CDN (powered by Fastly Compute) bereitgestellt und auf diesem ausgeführt werden. Wenn eine Anfrage mit einer CDN-Routing-Regel in cdn.yaml übereinstimmt, fängt die AEM Edge-Funktion sie ab, liest Kopfzeilen, ruft Backends auf, transformiert Antworten und gibt das Ergebnis vom Edge zurück.

Zu den gebräuchlichen Mustern gehören die vom Server gerenderte Personalisierung, sicherer API-Proxy und die Aggregation von Antworten.

Verwendung der AEM Edge-Funktionen

Verwenden Sie die folgende Anleitung, wenn Sie zwischen AEM Edge-Funktionen und anderen AEM-Erweiterbarkeitsoptionen wählen.

Szenario
Empfohlener Ansatz
Benutzerdefinierte Logik ausführen, externe APIs aufrufen, Antworten am Edge personalisieren
AEM Edge-Funktionen
Komplexe Geschäftslogik mit vollständigem AEM-Kontext (für AEM as a Cloud Service Java-Stack) am Ursprung
OSGi-Dienst oder Sling-Servlet

Bevorzugen Sie AEM Edge-Funktionen für dynamische Inhalte oder Daten, die Geschwindigkeit, Sicherheit und Skalierbarkeit ohne einen Roundtrip zur Quelle benötigen.

Wozu dienen AEM Edge-Funktionen

Mit den Funktionen von AEM Edge können vier gängige Herausforderungen beim Erstellen dynamischer, CDN-bereitgestellter Erlebnisse bewältigt werden.

Vorteil
Beschreibung
Leistung
Geringere Zeit bis zum ersten Byte bei Edge-seitiger Ausführung und kein Ursprungs-Roundtrip für gängige Muster
SEO
Server-gerenderte HTML beim ersten crawlen, benutzerfreundlich für Suchmaschinen und KI-Crawler
Sicherheit
API-Anmeldeinformationen und Geheimnisse bleiben Server-seitig und werden in Client-JavaScript nie bereitgestellt
Personalisierung
Inhalte vor dem Laden der Seite nach Geografie, Gerät oder Zielgruppe anpassen

Funktionsweise

Eine AEM Edge-Funktion befindet sich zwischen dem CDN-Cache und Ihren Backends. Er verarbeitet übereinstimmende Anfragen, bevor sie die Quelle erreichen.

Anfragefluss für AEM Edge-Funktionen {align="center"}

Es gibt zwei unabhängige Cache-Ebenen: den CDN-Cache (was der Browser sieht) und den Fetch-Cache (was die AEM Edge-Funktion beim Aufrufen von Backends sieht). Jede Ebene wird separat ungültig gemacht, wenn sich die zugrunde liegenden Daten ändern.

Weitere Informationen finden Sie unter Caching in AEM Edge Functions.

Erste Schritte

Wählen Sie aus, ob Sie AEM as a Cloud Service oder die Edge Delivery Services-Site verwenden, und folgen Sie dem Setup-Tutorial. Sie stellen eine JavaScript AEM Edge-Funktion mit /hello-world- und /weather-Routen bereit, konfigurieren CDN-Routing, übertragen den Code an Adobe CDN und überprüfen Antworten vom Edge.

Einrichten in AEM as a Cloud Service

Auf AEM as a Cloud Service einrichten

Installieren Sie die CLI, stellen Sie WKND (oder Ihre Site) bereit, konfigurieren Sie das CDN-Routing und überprüfen Sie die Funktionsendpunkte von AEM Edge auf AEM as a Cloud Service.

Einrichten

Einrichten in Edge Delivery Services

Auf Edge Delivery Services einrichten

Integrieren Sie Ihre Edge Delivery-Site in Cloud Manager, verknüpfen Sie Ihr Repository und stellen Sie Endpunkte der AEM Edge-Funktionen in Edge Delivery Services bereit.

Einrichten

Anleitung

Codeorientierte Handbücher für gängige AEM Edge-Funktionsmuster.

Thema
Beschreibung
Erstellen eines API-Endpunkts
Offenlegung von HTTP-Endpunkten mit dem Abruf-Ereignis-Handler, CDN-Ursprungs-Selektoren und optionalen ausgehenden Abruf- oder Drittanbieter-API-Aufrufen
Bereitstellung mehrerer Endpunkte
Eine Funktion kann viele Endpunkte bereitstellen und die Handler-Logik entsprechend dem Wachstum der API organisieren
HTTP-Anfragefilter
Anpassen von HTTP-Anfragen oder -Antworten im CDN mit Ursprungsauswahlregeln und einem Abruf-Handler
Verwenden von Konfigurationen und Geheimnissen
Übergeben von nicht sensiblen Konfigurationen und sensiblen Geheimnissen an eine Funktion über edgeFunctions.yaml und Lesen dieser Konfigurationen im Code
Daten am Edge speichern
Aktivieren eines KV-Speichers zum Lesen und Schreiben von Laufzeitschlüssel-Wert-Daten, die über Funktionsaufrufe hinweg am Edge bestehen bleiben

Plattformbeschränkungen

Beachten Sie beim Entwerfen der Funktionslogik von AEM Edge die folgenden Einschränkungen.

Beschränkung
Wert
Max. ausgehende Abrufaufrufe pro Aufruf
32
Max. AEM Edge-Funktionen (AEM as a Cloud Service)
1 pro Umgebung
Max. AEM Edge-Funktionen (Edge Delivery Services)
3 pro Programm (für die Haupt-, Staging- und Entwicklungsverzweigung Ihres Edge Delivery Services-Projekts, die den Produktions-, Staging- bzw. Entwicklungs-Sites zugeordnet sind)
Konfigurations-, Geheimnis- und KV-Speicher (Sandbox-Programme)
Nicht verfügbar

Eine Liste der Einschränkungen finden unter Einschränkungen in der Produktdokumentation zu AEM Edge-Funktionen.

Zusätzliche Ressourcen

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