Cache-Schlüssel anpassen

Auf dieser Seite wird erläutert, wie Cloud CDN-Cache-Schlüssel angepasst werden.

Eine Änderung der Cache-Schlüsselkonfiguration kann einen plötzlichen Rückgang bei der Cache-Trefferquote zur Folge haben, wenn neue Anfragen Cache-Schlüssel verwenden, die sich von alten Cache-Schlüsseleinträgen unterscheiden. Ebenso werden beim Ändern des Cache-Schlüsselerstellers die im Cache gespeicherten Einträge nicht zwangsläufig entwertet, wenn in neuen Anfragen alte Cache-Schlüssel verwendet werden. Informationen zur Entwertung von im Cache gespeicherten Einträgen finden Sie unter Cache-Inhalte entwerten.

Hinweise

Im Folgenden wird vorausgesetzt, dass Sie mit Cloud CDN, Cloud CDN-Cache-Schlüsseln und Backend-Diensten mit Load-Balancing vertraut sind. Wir empfehlen Ihnen, diese Seiten zu lesen, bevor Sie fortfahren.

Cloud CDN aktivieren und Cache-Schlüssel anpassen

Mit dieser Anleitung wird Cloud CDN für ein Backend mit Load-Balancing aktiviert und passen Sie den Cache-Schlüssel an, indem Sie einen oder mehrere Komponenten. Wenn Sie noch keinen Load-Balancer als Ursprung verwenden, lesen Sie den externen Application Load Balancer in der Dokumentation.

Back-End-Buckets enthalten das Protokoll oder den Host nicht im Cache-Schlüssel, Diese haben keinen Einfluss darauf, wie Objekte in Cloud Storage referenziert werden. Bucket. Sie enthalten jedoch eine Reihe von Abfragestringparametern, was sich auf die Antwort auswirken und durch eine anpassbare Liste von Parameternamen erweitert werden.

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud CDN.

    Zu Cloud CDN

  2. Klicken Sie auf Ursprung hinzufügen.
  3. Klicken Sie im Drop-down-Menü Ursprung auf Ursprung auswählen.
  4. Wählen Sie den Ursprung aus, für den Sie CDN aktivieren möchten.
  5. Klicken Sie in der Zeile des Ursprungs auf Konfigurieren.

    Wenn Cloud CDN für diesen Ursprung bereits aktiviert ist, klicken Sie zuerst auf das Menü , wählen Sie Bearbeiten aus und klicken dann auf Konfigurieren.

  6. Heben Sie die Auswahl der Kästchen für alle Felder auf, die Sie aus dem Cache-Schlüssel für diesen Backend-Dienst ausschließen möchten.

  7. Klicken Sie auf Speichern.

  8. Klicken Sie auf Hinzufügen.

gcloud

Geben Sie mindestens eines der optionalen Flags an, um die Komponente auszuschließen aus den Cache-Schlüsseln für diesen Back-End-Dienst.

gcloud compute backend-services update BACKEND_SERVICE \
    --enable-cdn

Optionale Flags:

  • --no-cache-key-include-protocol
  • --no-cache-key-include-host
  • --no-cache-key-include-query-string

Cache-Schlüssel aktualisieren, um Protokoll, Host und Abfragestring wieder hinzuzufügen

Backend-Dienste, die für die Verwendung von Cloud CDN konfiguriert sind, enthalten standardmäßig alle Komponenten des Anfrage-URI in Cache-Schlüsseln. Wenn Sie zuvor angegeben haben, dass eine oder mehrere Komponenten ausgeschlossen werden sollen, können Sie diese wie unten beschrieben wieder einschließen.

In dieser Anleitung werden das Protokoll, der Host und die Abfragezeichenfolge zur Cache-Schlüssel für einen vorhandenen Back-End-Dienst, der bereits über Cloud CDN verfügt aktiviert.

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud CDN.

    Zu Cloud CDN

  2. Klicken Sie in der Zeile des Load-Balancers auf Menü und dann auf Bearbeiten.
  3. Klicken Sie in der Zeile des Backend-Dienstes oder Backend-Buckets, den Sie ändern möchten, auf Konfigurieren.
  4. Wählen Sie unter Cache-Schlüssel die Option Benutzerdefiniert aus.
  5. Setzen Sie ein Häkchen bei Protokoll, Host und Abfragestring.
  6. Lassen Sie das Feld Abfragestringparameter leer.
  7. Klicken Sie auf Speichern.
  8. Klicken Sie auf Aktualisieren.

gcloud

Geben Sie zum erneuten Hinzufügen einer einzelnen Komponente nur das jeweilige Flag an. Nicht angegebene Flags bleiben unverändert.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-protocol \
    --cache-key-include-host \
    --cache-key-include-query-string

Cache-Schlüssel aktualisieren, um eine Liste von Abfragestringparametern ein- oder auszuschließen

In dieser Anleitung wird festgelegt, dass Cloud CDN-Cache-Schlüssel eine Einschlussliste verwenden. oder eine Ausschlussliste mit Abfragezeichenfolge-Parametern.

Console

  1. Wechseln Sie in der Google Cloud Console zur Seite Cloud CDN.

    Zu Cloud CDN

  2. Klicken Sie in der Zeile des Load-Balancers auf Menü und dann auf Bearbeiten.
  3. Klicken Sie in der Zeile des Backend-Dienstes, den Sie ändern möchten, auf Konfigurieren.
  4. Wählen Sie unter Cache-Schlüssel die Option Benutzerdefiniert aus.
  5. Prüfen Sie, ob ein Häkchen für Abfragestring gesetzt ist.
  6. Wenn Sie Abfragestringparameter angeben möchten, die Teil des Cache-Schlüssels sein sollen, wählen Sie Nur ausgewählte einschließen aus.

    Wenn Sie hingegen festlegen möchten, dass im Cache-Schlüssel alle Abfragestringparameter außer den angegebenen enthalten sein sollen, wählen Sie Alle nicht ausgewählten einschließen aus.

  7. Fügen Sie in das Feld Abfragestringparameter Ihre Liste mit durch Komma getrennten Strings ein.

  8. Klicken Sie auf Speichern.

  9. Klicken Sie auf Aktualisieren.

gcloud

Verwenden Sie diesen Befehl, um den Abfragestringparameter user auf den einzuschließenden Liste eines Back-End-Dienstes.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-query-string \
    --cache-key-query-string-whitelist user

Verwenden Sie diesen Befehl, um den Parameter „user“ in der Ausschlussliste eines Back-End-Dienstes festzulegen.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-query-string \
    --cache-key-query-string-blacklist user

Verwenden Sie diesen Befehl, um den Abfragestringparameter user auf den einzuschließenden Liste eines Back-End-Buckets.

gcloud compute backend-buckets update BACKEND_BUCKET \
    --cache-key-query-string-whitelist user

Cache-Schlüssel zur Verwendung von HTTP-Headern aktualisieren

Mit diesen Anweisungen wird festgelegt, dass Cloud CDN-Cache-Schlüssel HTTP-Header verwenden.

Console

Die Google Cloud Console wird für dieses Feature nicht unterstützt.

gcloud

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-http-header=[HEADER_FIELD_NAME,...]
gcloud compute backend-buckets update BACKEND_BUCKET \
    --cache-key-include-http-header=[HEADER_FIELD_NAME,...]

Cache-Schlüssel zur Verwendung benannter Cookies aktualisieren

Mit diesen Anweisungen wird festgelegt, dass Cloud CDN-Cache-Schlüssel HTTP-Cookies verwenden.

Console

Die Google Cloud Console wird für dieses Feature nicht unterstützt.

gcloud

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-named-cookie=[NAMED_COOKIE,...]

Nächste Schritte