Funzioni di AEM Edge

IMPORTANT
AEM Edge Functions è attualmente in versione beta. Le funzioni e la documentazione potrebbero cambiare. Per ricevere commenti, contattare aemcs-edgecompute-feedback@adobe.com.

Le funzioni Edge di AEM consentono di eseguire JavaScript su Adobe CDN ai margini, vicino ai visitatori e senza un viaggio di andata e ritorno all’origine. Lavorano sui siti AEM as a Cloud Service e Edge Delivery Services con Adobe Managed CDN.

Cosa sono le funzioni Edge di AEM

Le funzioni Edge di AEM sono moduli JavaScript distribuiti ed eseguiti sulla rete CDN di Adobe (con tecnologia Fastly Compute). Quando una richiesta corrisponde a una regola di routing CDN in cdn.yaml, la funzione Edge di AEM la intercetta, legge le intestazioni, effettua chiamate backend, trasforma le risposte e restituisce il risultato dal server Edge di.

I pattern comuni includono personalizzazione con rendering server, proxy API sicuri e aggregazione delle risposte.

Quando utilizzare le funzioni di AEM Edge

Utilizza la seguente guida per scegliere tra le funzioni di AEM Edge e altre opzioni di estensibilità di AEM.

Scenario
Approccio consigliato
Esegui logica personalizzata, chiama API esterne, personalizza le risposte ai server Edge di
Funzioni di AEM Edge
Logica di business complessa con contesto AEM completo (per AEM as a Cloud Service Java stack) all’origine
Servizio OSGi o servlet Sling

Preferisci le funzioni Edge di AEM per i contenuti dinamici o i dati che richiedono velocità, sicurezza e scalabilità senza un round trip all’origine.

Perché utilizzare le funzioni di AEM Edge

Le funzioni Edge di AEM affrontano quattro sfide comuni durante la creazione di esperienze dinamiche distribuite tramite CDN.

Vantaggio
Descrizione
Prestazioni
Riduzione del time-to-first-byte con esecuzione edge-side e nessun round trip di origine per i pattern comuni
SEO
HTML con rendering server alla prima scansiona, compatibile con motori di ricerca e crawler di intelligenza artificiale
Sicurezza
Le credenziali e i segreti API rimangono lato server e non vengono mai esposti in JavaScript client
Personalizzazione
Personalizzare il contenuto per area geografica, dispositivo o pubblico prima del caricamento della pagina

Come funziona

Una funzione Edge di AEM è posizionata tra la cache CDN e i backend. Elabora le richieste corrispondenti prima che raggiungano l’origine.

Flusso della richiesta delle funzioni di AEM Edge {align="center"}

Esistono due livelli di cache indipendenti: la cache CDN (visualizzata dal browser) e la cache di recupero (visualizzata dalla funzione Edge di AEM durante la chiamata ai backend). Annullare la validità di ogni livello separatamente quando i dati sottostanti cambiano.

Per ulteriori informazioni, consulta Memorizzazione in cache nelle funzioni AEM Edge.

Come iniziare

Scegli se utilizzi AEM as a Cloud Service o il sito Edge Delivery Services e segui l’esercitazione di configurazione. Distribuisci una funzione Edge di JavaScript AEM con /hello-world e /weather route, configura il routing CDN, invia il codice a Adobe CDN e verifica le risposte dal server Edge di.

Configurazione su AEM as a Cloud Service

Configurazione su AEM as a Cloud Service

Installa CLI, distribuisci WKND (o il tuo sito), configura il routing CDN e verifica gli endpoint delle funzioni Edge di AEM in AEM as a Cloud Service.

Configurazione

Configurazione su Edge Delivery Services

Configurazione in Edge Delivery Services

Acquisisci l’onboarding del tuo sito Edge Delivery in Cloud Manager, collega l’archivio e implementa gli endpoint con funzioni AEM Edge in Edge Delivery Services.

Configurazione

Procedura

Guide incentrate sul codice per i pattern di funzioni AEM Edge più comuni.

Argomento
Descrizione
Generare un endpoint API
Esponi gli endpoint HTTP con il gestore eventi di recupero, i selettori di origine CDN e le chiamate facoltative di recupero in uscita o API di terze parti
Più endpoint
Una funzione può esporre molti endpoint; organizza la logica del gestore man mano che l’API cresce
Filtri di richiesta HTTP
Regolare le richieste o le risposte HTTP sulla rete CDN con le regole del selettore di origine e un gestore di recupero
Usa configurazioni e segreti
Trasmettere configurazioni non sensibili e segreti sensibili a una funzione tramite edgeFunctions.yaml e leggerle nel codice
Archivia dati al perimetro
Consente a un archivio KV di leggere e scrivere dati chiave-valore di runtime che persistono al perimetro tra le chiamate di funzione

Limiti della piattaforma

Quando progetti la logica per funzioni AEM Edge, tieni presenti i seguenti limiti.

Limite
Valore
Numero massimo di chiamate di recupero in uscita per chiamata
32
Numero massimo di funzioni Edge di AEM (AEM as a Cloud Service)
1 per ambiente
Numero massimo di funzioni Edge di AEM (Edge Delivery Services)
3 per programma (per i rami principale, di staging e di sviluppo del progetto Edge Delivery Services mappati rispettivamente sui siti di produzione, staging e sviluppo)
Archivi di configurazione, segreti e KV (programmi sandbox)
Non disponibile

Per l’elenco completo delle limitazioni, consulta Limitazioni nella documentazione del prodotto AEM Edge Functions.

Risorse aggiuntive

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