Konfigurieren der Push-Invalidierung für das BYO Production CDN

Durch die Push-Invalidierung werden Inhalte automatisch aus dem Produktions-CDN des Kunden gelöscht (z. B. www.yourdomain.com), sobald ein Autor Inhaltsänderungen veröffentlicht.

Inhalte werden durch URL und Cache-Tag/-Schlüssel gelöscht.

Die Einrichtung der Push-Invalidierung erfordert zwei Schritte:

Konfiguration

Die Push-Invalidierung wird derzeit für CDNs der folgenden Anbieter unterstützt:

Die Push-Invalidierung wird durch Hinzufügen bestimmter Eigenschaften zur Projektkonfiguration aktiviert (eine Excel-Arbeitsmappe mit dem Namen .helix/config.xlsx in Sharepoint oder einer Google Tabelle mit dem Namen .helix/config in Google Drive).

In den folgenden Abschnitten werden die herstellerspezifischen Eigenschaften beschrieben, die zum Einrichten der Push-Invalidierung erforderlich sind.

Fastly

Konfigurationseigenschaften:

key
value
Kommentar
cdn.prod.host
<Production Host>
Hostname der Produktionssite, z. B. www.yourdomain.com
cdn.prod.type
fastly
cdn.prod.serviceId
<Fastly Service ID>
Service-ID des Produktionsdienstes
cdn.prod.authToken
<Fastly API Token>

Fastly-API-Token erstellen

  • gehen Sie zu Persönliche API-Token,
  • Klicken Sie auf "Token erstellen",
  • Geben Sie einen Namen ein (z. B. "Production Site Purge Token"),
  • Wählen Sie "Ein spezifischer Dienst"und Ihren Produktionsdienst aus der Dropdown-Liste aus.
  • Aktivieren Sie das Kontrollkästchen "Inhalt bereinigen (bereinigen_select) — Nach URL oder Ersatzschlüssel bereinigen",
  • Wählen Sie "Niemals ablaufen",
  • Klicken Sie auf "Token erstellen",
  • Kopieren Sie den generierten Token-Wert, der im Popup-Fenster angezeigt wird.

Sie können die Anmeldeinformationen damit validieren Tool.

Akamai

Konfigurationseigenschaften

key
value
Kommentar
cdn.prod.host
<Production Host>
Hostname der Produktionssite, z. B. www.yourdomain.com
cdn.prod.type
akamai
cdn.prod.endpoint
<host>
API-Anmeldeinformationen für schnelle Bereinigung
cdn.prod.clientSecret
<client_secret>
API-Anmeldeinformationen für schnelle Bereinigung
cdn.prod.clientToken
<client_token>
API-Anmeldeinformationen für schnelle Bereinigung
cdn.prod.accessToken
<access_token>
API-Anmeldeinformationen für schnelle Bereinigung

Die Push-Invalidierung verwendet die Akamai Fast Purge API, insbesondere Nach URL löschen und Löschen nach Cache-Tag.

Die API-Anmeldeinformationen für die schnelle Bereinigung bestehen aus

host = akaa-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX.luna.akamaiapis.net
client_token = akab-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX
client_secret = XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
access_token = akab-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX

Sie können generiert werden, indem Sie die Anweisungen unter Erstellen eines API-Clients mit benutzerdefinierten Berechtigungen.

Identitäts- und Zugriffsverwaltung

API-Client erstellen



Erforderliche Gruppen-/Rollenberechtigungen:

Sie können die Anmeldeinformationen damit validieren Tool.

Cloudflare

Konfigurationseigenschaften

key
value
Kommentar
cdn.prod.host
<Production Host>
Hostname der Produktionssite, z. B. www.yourdomain.com
cdn.prod.type
cloudflare
cdn.prod.plan
e.g. free

-Werte: free, pro, business, enterprise

Standard: free

Nur der Enterprise-Plan unterstützt Bereinigung nach Tag

cdn.prod.zoneId
<Cloudflare Zone ID>
Kennung der Produktionszone
cdn.prod.apiToken
<Cloudflare API Token>

API-Token erstellen

  • gehen Sie zu API-Token
  • Klicken Sie auf "Token erstellen",
  • Gehen Sie unten zu "Benutzerdefiniertes Token erstellen"und klicken Sie auf "Erste Schritte".
  • Geben Sie einen Token-Namen ein (z. B. "Production Site Purge Token"),
  • Berechtigungen: "Zone", "Cache Purge", "Purge"
  • Bereichsressourcen: "Include", "Specific zone", "&quot;<your production="" zone="">"
  • Klicken Sie auf "Weiter zur Zusammenfassung".
  • Klicken Sie auf "Token erstellen",
  • Kopieren Sie den generierten Tokenwert.

Beachten Sie, dass nur Sites im Unternehmensplan durch URL- und Cache-Schlüssel chirurgisch bereinigt werden. A Alle bereinigen wird stattdessen jedes Mal auf Nicht-Enterprise-Sites ausgeführt, wenn ein Autor eine Inhaltsänderung veröffentlicht.

Sie können die Anmeldeinformationen damit validieren Tool.

CloudFront

NB: CloudFront unterstützt NICHT die Bereinigung durch Cache-Tag/-Schlüssel. Nach Cache-Tag/-Schlüssel bereinigen wird immer eine Bereinigung Trigger.

Konfigurationseigenschaften

key
value
Kommentar
cdn.prod.host
<Production Host>
Hostname der Produktionssite, z. B. www.yourdomain.com
cdn.prod.type
cloudfront
cdn.prod.distributionId
<Cloudfront Distribution ID>
cdn.prod.accessKeyId
<AWS Access key ID>
AWS-Anmeldeinformationen
cdn.prod.secretAccessKey
<AWS Secret access key>
AWS-Anmeldeinformationen

Erstellen der AWS-Anmeldeinformationen

Öffnen Sie in der AWS-Konsole das IAM-Dashboard:

Wählen Sie Benutzer > Benutzer hinzufügen aus:

Geben Sie einen Benutzernamen ein und aktivieren Sie die Option "Zugriffsschlüssel - Programmgesteuerter Zugriff":

Klicken Sie im Bereich "Berechtigungen festlegen"auf "Gruppe erstellen":

Geben Sie einen Gruppennamen ein und wählen Sie die CloudFrontFullAccess-Richtlinie aus:

Erstellen Sie den Benutzer:

Kopieren Sie abschließend die Werte Zugriffsschlüssel-ID und geheimer Zugriffsschlüssel:

Sie können die Anmeldeinformationen damit validieren Tool.

Opt-in-Anfragekopfzeile

Das Produktions-CDN muss die folgende Opt-in-Kopfzeile an den Herkunftsort senden, um TTLs mit langer Cache-Kapazität zu aktivieren:

X-Push-Invalidation: enabled

recommendation-more-help
10a6ce9d-c5c5-48d9-8ce1-9797d2f0f3ec