Depuración de la caché de CDN

Obtenga información sobre cómo depurar o eliminar la respuesta HTTP en caché de la CDN de AEM as a Cloud Service. Mediante la característica de autoservicio Purgar token de API, puede purgar la caché de un recurso específico, un grupo de recursos y toda la caché.

AEM En este tutorial, aprenderá a configurar y utilizar el token de API de purga para purgar la caché de CDN del sitio de muestra WKND mediante la función de autoservicio.

Invalidación de caché frente a purga explícita

Existen dos formas de eliminar los recursos en caché de la CDN:

Cuando los recursos en caché se eliminan de la caché de CDN, la siguiente solicitud para el mismo recurso obtiene la última versión del servidor de origen.

Configuración del token de API de depuración

Vamos a aprender a configurar el token de API de purga para purgar la caché de CDN.

Configuración de la regla de CDN

AEM El token de API de purga se crea configurando la regla de CDN en el código de proyecto de.

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

En la regla anterior, tanto purgeKey1 como purgeKey2 se agregan desde el principio para admitir la rotación de secretos sin interrupciones. Sin embargo, solo puede empezar con purgeKey1 y agregar purgeKey2 más adelante al girar los secretos.

Crear variable de entorno de Cloud Manager

A continuación, cree las variables de entorno de Cloud Manager para almacenar el valor Purgar token de API.

Implementación de la regla CDN

Finalmente, implemente la regla de CDN configurada en el entorno de AEM as a Cloud Service mediante la canalización de Cloud Manager.

Uso del token de API de purga

AEM Para purgar la caché de la CDN, invoque la URL de dominio específica del servicio de con Purge API Token. La sintaxis para purgar la caché es la siguiente:

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>

Donde:

Purgar la caché de un recurso específico

En este ejemplo, el comando curl purga la caché del recurso /us/en.html en el sitio WKND implementado en un entorno 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"

Una vez realizada la purga correctamente, se devuelve una respuesta 200 OK con contenido JSON.

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

Purga de la caché para un grupo de recursos

En este ejemplo, el comando curl purga la caché del grupo de recursos con la clave suplente wknd-assets. El encabezado de respuesta Surrogate-Key está establecido en wknd.vhost, por ejemplo:

<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"

Una vez realizada la purga correctamente, se devuelve una respuesta 200 OK con contenido JSON.

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

Purgar toda la caché

En este ejemplo, con el comando curl, toda la caché se purga del sitio WKND de ejemplo implementado en el entorno de 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"

Una vez realizada la purga correctamente, se devuelve una respuesta 200 OK con contenido JSON.

{"status":"ok"}

Verificar la depuración de caché

Para verificar la depuración de caché, acceda a la URL del recurso en el explorador web y revise los encabezados de respuesta. El valor del encabezado X-Cache debe ser MISS.