De CDN-cache leegmaken

Leer hoe u de HTTP-respons in de cache kunt leegmaken of verwijderen uit de AEM as a Cloud Service CDN. Gebruikend de zelfbediening eigenschap genoemd zuiveren API Token, kunt u het geheime voorgeheugen voor een specifiek middel, een groep middelen, en het volledige geheime voorgeheugen ontruimen.

In dit leerprogramma, leert u hoe te opstelling en het Schrappen API Token te gebruiken om het CDN geheime voorgeheugen van de steekproef AEM WKNDplaats te zuiveren gebruikend de zelfbediening eigenschap.

Invalidatie van cache versus expliciete verwijdering

Er zijn twee manieren om de caching middelen uit CDN te verwijderen:

Wanneer de caching middelen uit het CDN geheime voorgeheugen worden verwijderd, haalt het volgende verzoek om het zelfde middel de recentste versie van de oorsprongserver.

Het token voor de lege API instellen

Leer hoe u het token voor de zuiverings-API instelt voor het leegmaken van de CDN-cache.

De CDN-regel configureren

Het token van de zuiverings-API wordt gemaakt door de CDN-regel in uw AEM projectcode te configureren.

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

In de bovenstaande regel worden zowel purgeKey1 als purgeKey2 vanaf het begin toegevoegd ter ondersteuning van de rotatie van geheimen zonder onderbrekingen. U kunt echter alleen met purgeKey1 beginnen en purgeKey2 later toevoegen wanneer u de geheimen roteert.

Cloud Manager-omgevingsvariabele maken

Maak vervolgens de Cloud Manager-omgevingsvariabelen om de waarde van het token voor de zuiverings-API op te slaan.

De CDN-regel implementeren

Tot slot stel de gevormde CDN regel aan het milieu van AEM as a Cloud Service op gebruikend de pijpleiding van Cloud Manager.

De token voor de wisse-API gebruiken

Als u de CDN-cache wilt leegmaken, roept u de URL van het AEM servicespecifieke domein aan met het token voor de zuiverings-API. De syntaxis voor het leegmaken van de cache is als volgt:

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>

Waarbij:

De cache leegmaken voor een bepaalde resource

In dit voorbeeld leegt de opdracht curl de cache voor de /us/en.html -bron op de WKND-site die wordt geïmplementeerd in een AEM as a Cloud Service-omgeving.

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

Na het leegmaken wordt een 200 OK reactie geretourneerd met JSON-inhoud.

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

De cache leegmaken voor een groep bronnen

In dit voorbeeld leegt de opdracht curl de cache voor de groep met bronnen met de vervangende sleutel wknd-assets . De Surrogate-Key reactiekopbal wordt geplaatst in wknd.vhost, bijvoorbeeld:

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

Na het leegmaken wordt een 200 OK reactie geretourneerd met JSON-inhoud.

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

De gehele cache leegmaken

In dit voorbeeld wordt met de opdracht curl de gehele cache leeggemaakt vanaf de WKND-voorbeeldsite die is geïmplementeerd in de AEM as a Cloud Service-omgeving.

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

Na het leegmaken wordt een 200 OK reactie geretourneerd met JSON-inhoud.

{"status":"ok"}

De cache leegmaken controleren

Als u het leegmaken van de cache wilt controleren, opent u de URL van de bron in de webbrowser en bekijkt u de antwoordheaders. De headerwaarde X-Cache moet MISS zijn.