Il lato Edge include edge-side-includes
aemcs-cdn-config-adopter@adobe.com e descrivi il tuo caso d'uso.La velocità di distribuzione dei contenuti deriva da un caching aggressivo delle pagine, ottenuto impostando intestazioni cache con valori TTL (High Time To Live) elevati. Questo può essere difficile quando le pagine includono contenuti dinamici, che devono essere aggiornati frequentemente o che potenzialmente non possono essere memorizzati nella cache. Fortunatamente, esistono strategie in cui la pagina HTML contenitore può essere memorizzata nella cache con un TTL elevato, posticipando il recupero dei frammenti di contenuto più dinamici a un momento successivo, tramite Javascript lato client o sulla rete CDN. Quest’ultimo approccio è uno standard denominato Edge Side Includes (ESI), supportato per i siti sottoposti a rendering con la pubblicazione AEM. Il HTML include tag ESI che indicano al CDN di rimandare la distribuzione della pagina al browser fino a quando non valuta tali tag, recuperando contenuto aggiuntivo più dinamico (TTL inferiore) dall’origine (o cache CDN se il relativo TTL non è scaduto).
Alcuni casi d’uso in cui Edge Side Includes può essere utile:
- Visualizzazione del nome di un utente finale o di altre informazioni specifiche dell'utente finale.
- Visualizzazione di un elenco di informazioni recenti, ad esempio articoli di notizie o quotazioni azionarie.
Sintassi ESI esi-syntax
La sintassi ESI è la seguente se una pagina padre /content/page.html include uno snippet content/snippets/mysnippet.html.
<html>
<head>
<title>My Site</title>
</head>
<body>
<div id="content">
<esi:include src="/content/snippets/mysnippet.html" />
</div>
</body>
</html>
Per informazioni dettagliate, vedere la specifica ESI.
Considerazioni esi-syntax-considerations
- Sono supportati i seguenti tag ESI: include, comment, remove.
- I tag ESI vengono elaborati in modo sequenziale anziché simultaneo alla rete CDN, pertanto molti tag ESI in una pagina con valori TTL bassi possono aggiungere latenza all’esperienza dell’utente finale.
- La profondità massima di ESI: elaborazione inclusa è 5.
- Il valore massimo totale ESI: include frammenti di elaborazione è 256.
Configurazione Apache esi-apache
Se disponi di pagine con tag ESI, è necessario dichiarare le seguenti proprietà nella configurazione di Apache:
<LocationMatch "/parent-pages/*content/page.html">
# disable dispatcher compression
SetEnv no-gzip 1
# enable esi processing
Header set x-aem-esi "on"
# enable edgeCDN compression
Header set x-aem-compress "on"
# typically the main page is cached at the CDN
Header always set Cache-Control "max-age=300"
</LocationMatch>
<LocationMatch "/content/snippets/mysnippet.html">
SetEnv no-gzip 1
# typically the included page is either set to a lower TTL than the parent page, or not cached at all, as these 2 commented declarations show, respectively:
#Header always set Cache-Control "no-cache"
#Header always set Cache-Control "max-age=50"
</LocationMatch>
Le proprietà configurate hanno il seguente comportamento:
Sia la pagina padre che i frammenti inclusi devono impostare no-gzip su 1.
Questa impostazione sostituisce qualsiasi impostazione di compressione che Apache avrebbe potuto utilizzare altrimenti, in base ai valori
Accept-Encoding della richiesta.no-gzip impostato su 1), la latenza può essere ridotta.Se questa intestazione non è impostata, quando la rete CDN recupera il contenuto non compresso dall'origine, distribuisce anche il contenuto al client non compresso. Pertanto, è necessario impostare questa intestazione se
no-gzip è impostato su 1 (obbligatorio per ESI) e si desidera distribuire contenuto compresso dalla rete CDN al browser.Sling Dynamic Include esi-sdi
Anche se non obbligatorio, è possibile utilizzare Sling Dynamic Include (SDI) per generare snippet ESI interpretati in CDN.