Cache-Inhalte entwerten

Auf dieser Seite wird beschrieben, wie Sie Cache-Inhalte in Cloud CDN entwerten.

Wenn beispielsweise eine Datei unter /images/file.jpg im Cache gespeichert wurde und entwertet werden muss, stehen Ihnen mehrere Optionen zur Verfügung, je nachdem, ob Sie nur diese Datei oder einen größeren Bereich entwerten möchten. In jedem Fall können Sie die Entwertung entweder für alle Hostnamen oder nur für einen bestimmten Hostnamen vornehmen.

Weitere Informationen zur Cache-Entwertung finden Sie im Überblick zur Cache-Entwertung.

Vorbereitung

Sie können für Entwertungen die Google Cloud CLI oder die Google Cloud Console verwenden.

Sie haben zwei Möglichkeiten, auf die Google Cloud CLI zuzugreifen:

• Installieren Sie die Google Cloud CLI. Folgen Sie dazu der Anleitung unter Mit apt-get installieren. Wenn Sie die Google Cloud CLI noch nicht verwendet haben, führen Sie zuerst gcloud init zur Authentifizierung aus.

• Verwenden Sie Google Cloud Shell. Dort ist gcloud bereits installiert.

Erforderliche Berechtigungen für diese Aufgabe

Zum Ausführen dieser Aufgabe müssen Sie die folgenden Berechtigungen oder die folgenden IAM-Rollen haben.

Berechtigungen

• compute.urlMaps.get
• compute.urlMaps.invalidateCache

Rollen

• roles/compute.networkAdmin
• roles/compute.loadBalancerAdmin

Informationen zum Erstellen einer benutzerdefinierten Rolle mit den erforderlichen Berechtigungen finden Sie unter Benutzerdefinierte Rollen erstellen und verwalten.

Informationen zum Hinzufügen einer vordefinierten Rolle finden Sie in der IAM-Kurzanleitung.

Nur eine Datei entwerten

Console

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

   Zur Cloud CDN-Seite

2. Klicken Sie unter Zugeordnete Load-Balancer auf den Namen des Load-Balancers.
3. Klicken Sie auf den Tab Cache-Entwertung.
4. Geben Sie den Pfad zur Datei ein.
   • Wenn Sie einen Pfad für alle Hostnamen entwerten möchten, geben Sie nur den Pfad ein (z. B. /images/file.jpg).
   • Wenn Sie einen Pfad nur für einen bestimmten Hostnamen entwerten möchten, geben Sie den Hostnamen als Teil des Pfades ein (z. B. example.com/images/file.jpg).
5. Klicken Sie auf Entwerten.

gcloud

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --path "/images/file.jpg"

Der Name des externen HTTP(S)-Load-Balancers und der Name der URL-Zuordnung sind identisch.

Ersetzen Sie LOAD_BALANCER_NAME durch den Namen des Load-Balancers: Verwenden Sie den Befehl gcloud compute url-maps list, um Ihre Load-Balancer aufzulisten.

Optional: Wenn Sie nur einen Host entwerten möchten, fügen Sie das Flag --host hinzu. (--host example.com)

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --host HOSTNAME \
    --path "/images/file.jpg"

Standardmäßig wartet die Google Cloud CLI, bis die Entwertung abgeschlossen ist. Um die Entwertung im Hintergrund auszuführen, hängen Sie --async an die Befehlszeile an.

Gesamtes Verzeichnis entwerten

Console

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

   Zur Cloud CDN-Seite

2. Klicken Sie unter Zugeordnete Load-Balancer auf den Namen des Load-Balancers.
3. Klicken Sie auf den Tab Cache-Entwertung.
4. Geben Sie den Verzeichnispfad und den Platzhalter ein. (/path/to/file/*)
   • Wenn Sie das gesamte Verzeichnis für alle Hostnamen entwerten möchten, geben Sie nur den Pfad und Platzhalter ein (z. B. /images/*).
   • Wenn Sie das gesamte Verzeichnis nur für einen bestimmten Hostnamen entwerten möchten, geben Sie den Hostnamen als Teil des Pfades ein (z. B. example.com/images/*).
5. Klicken Sie auf Entwerten.

gcloud

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --path "/images/*"

Ersetzen Sie LOAD_BALANCER_NAME durch den Namen des Load-Balancers: Verwenden Sie den Befehl gcloud compute url-maps list, um Ihre Load-Balancer aufzulisten.

Optional: Wenn Sie nur einen Host entwerten möchten, fügen Sie das Flag --host hinzu. (--host example.com)

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --host HOSTNAME \
    --path "/images/*"

Standardmäßig wartet die Google Cloud CLI, bis die Entwertung abgeschlossen ist. Um die Entwertung im Hintergrund auszuführen, hängen Sie --async an die Befehlszeile an.

Alles entwerten

Console

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

   Zur Cloud CDN-Seite

2. Klicken Sie unter Zugeordnete Load-Balancer auf den Namen des Load-Balancers.
3. Klicken Sie auf den Tab Cache-Entwertung.
4. Geben Sie nur das Stammverzeichnis und den Platzhalter ein (/*).
   • Wenn Sie alles für alle Hostnamen entwerten möchten, geben Sie nur /* in das Feld ein.
   • Wenn Sie für einen bestimmten Hostnamen alles entwerten möchten, geben Sie den Hostnamen als Teil des Pfades ein (z. B. example.com/*).
5. Klicken Sie auf Entwerten.

gcloud

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --path "/*"

Dabei gilt:

• LOAD_BALANCER_NAME: Der Name des Load-Balancers
• /* – Der URL-Pfad, den Sie entwerten möchten. Dieser enthält nicht den Hostnamen. Der Pfad kann einen expliziten Dateinamen oder einen Platzhalter verwenden.

Optional: Wenn Sie nur einen Host entwerten möchten, fügen Sie das Flag --host hinzu. (--host example.com)

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --host HOSTNAME \
    --path "/*"

Standardmäßig wartet die Google Cloud CLI, bis die Entwertung abgeschlossen ist. Um die Entwertung im Hintergrund auszuführen, hängen Sie --async an die Befehlszeile an.

Weitere Informationen

• Informationen zum Prüfen, ob Cloud CDN Antworten aus dem Cache bereitstellt, finden Sie unter Logs ansehen.
• Mehr darüber, welche Inhalte im Cache gespeichert werden können und welche nicht, erfahren Sie unter Caching-Details.