Come eliminare la cache CDN

Scopri come eliminare o rimuovere la risposta HTTP dalla cache dal CDN di AEM as a Cloud Service. Utilizzando la funzionalità self-service denominata Rimuovi token API, è possibile eliminare la cache per una risorsa specifica, un gruppo di risorse e l'intera cache.

In questa esercitazione imparerai a impostare e utilizzare Purge API Token per eliminare la cache CDN del sito AEM WKND di esempio utilizzando la funzione self-service.

Annullamento della validità della cache ed eliminazione esplicita

Esistono due modi per rimuovere le risorse memorizzate in cache dalla rete CDN:

Quando le risorse memorizzate in cache vengono rimosse dalla cache CDN, la richiesta successiva per la stessa risorsa recupera la versione più recente dal server di origine.

Configurare il token API di rimozione

Scopri come impostare Purge API Token per eliminare la cache CDN.

Configurare la regola CDN

Il token API di eliminazione viene creato configurando la regola CDN nel codice del progetto AEM.

kind: "CDN"
version: "1"
metadata:
  envTypes: ["dev", "stage", "prod"]
data:
  authentication: # The main authentication configuration
    authenticators: # The list of authenticators
       - name: purge-auth # The name of the authenticator
         type: purge  # The type of the authenticator, must be purge
         purgeKey1: ${{CDN_PURGEKEY_081324}} # The first purge key, must be referenced by the Cloud Manager secret-type environment variable name ${{CDN_EDGEKEY_073124}}
         purgeKey2: ${{CDN_PURGEKEY_111324}} # The second purge key, must be referenced by the Cloud Manager secret-type environment variable name ${{CDN_EDGEKEY_111324}}. It is used for the rotation of secrets without any interruptions.
    rules: # The list of authentication rules
       - name: purge-auth-rule # The name of the rule
         when: { reqProperty: tier, equals: "publish" } # The condition when the rule should be applied
         action: # The action to be taken when the rule is applied
           type: authenticate # The type of the action, must be authenticate
           authenticator: purge-auth # The name of the authenticator to be used, must match the name from the above authenticators list

Nella regola precedente, sia purgeKey1 che purgeKey2 vengono aggiunti dall'inizio per supportare la rotazione dei segreti senza interruzioni. Tuttavia, è possibile iniziare con solo purgeKey1 e aggiungere purgeKey2 in un secondo momento durante la rotazione dei segreti.

Creare la variabile di ambiente Cloud Manager

Quindi, crea le variabili di ambiente Cloud Manager per memorizzare il valore Purge API Token.

Distribuire la regola CDN

Infine, distribuisci la regola CDN configurata nell’ambiente AEM as a Cloud Service utilizzando la pipeline Cloud Manager.

Utilizzare il token API di rimozione

Per rimuovere la cache CDN, richiama l’URL del dominio specifico del servizio AEM con il token API di rimozione. La sintassi per eliminare la cache è la seguente:

PURGE <URL> HTTP/1.1
Host: <AEM_SERVICE_SPECIFIC_DOMAIN>
X-AEM-Purge-Key: <PURGE_API_TOKEN>
X-AEM-Purge: <PURGE_TYPE>
Surrogate-Key: <SURROGATE_KEY>

Dove:

Eliminare la cache per una risorsa specifica

In questo esempio, il comando curl elimina la cache per la risorsa /us/en.html sul sito WKND distribuito in un ambiente AEM as a Cloud Service.

curl -X PURGE "https://publish-p46652-e1315806.adobeaemcloud.com/us/en.html" \
-H "X-AEM-Purge-Key: 123456789" \
-H "X-AEM-Purge: hard"

Dopo l'eliminazione corretta, viene restituita una risposta 200 OK con contenuto JSON.

{ "status": "ok", "id": "1000098-1722961031-13237063" }

Eliminare la cache per un gruppo di risorse

In questo esempio, il comando curl elimina la cache per il gruppo di risorse con la chiave sostitutiva wknd-assets. L'intestazione di risposta Surrogate-Key è impostata in wknd.vhost, ad esempio:

<VirtualHost *:80>
    ...

    # Core Component Image Component: long-term caching (30 days) for immutable URLs, background refresh to avoid MISS
    <LocationMatch "^/content/.*\.coreimg.*\.(?i:jpe?g|png|gif|svg)$">
        Header set Cache-Control "max-age=2592000,stale-while-revalidate=43200,stale-if-error=43200,public,immutable" "expr=%{REQUEST_STATUS} < 400"
        # Set Surrogate-Key header to group the cache of WKND assets, thus it can be flushed independtly
        Header set Surrogate-Key "wknd-assets"
        Header set Age 0
    </LocationMatch>

    ...
</VirtualHost>

curl -X PURGE "https://publish-p46652-e1315806.adobeaemcloud.com" \
-H "Surrogate-Key: wknd-assets" \
-H "X-AEM-Purge-Key: 123456789" \
-H "X-AEM-Purge: hard"

Dopo l'eliminazione corretta, viene restituita una risposta 200 OK con contenuto JSON.

{ "wknd-assets": "10027-1723478994-2597809-1" }

Eliminare l'intera cache

In questo esempio, utilizzando il comando curl l'intera cache viene eliminata dal sito WKND di esempio distribuito nell'ambiente AEM as a Cloud Service.

curl -X PURGE "https://publish-p46652-e1315806.adobeaemcloud.com/" \
-H "X-AEM-Purge-Key: 123456789" \
-H "X-AEM-Purge: all"

Dopo l'eliminazione corretta, viene restituita una risposta 200 OK con contenuto JSON.

{"status":"ok"}

Verificare l’eliminazione della cache

Per verificare l’eliminazione della cache, accedi all’URL della risorsa nel browser web e controlla le intestazioni di risposta. Il valore dell'intestazione X-Cache deve essere MISS.