Cache-Inhalte entwerten

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

Wenn beispielsweise eine Datei unter /images/foo.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 gcloud-Befehlszeile oder die Google Cloud Console verwenden.

Sie haben zwei Möglichkeiten, auf das gcloud-Befehlszeilentool zuzugreifen:

• Installieren Sie das Cloud SDK gemäß der Anleitung unter Mit apt-get installieren. Wenn Sie das gcloud-Befehlszeilentool bisher noch nicht verwendet haben, müssen Sie zur Authentifizierung zuerst gcloud init ausführen.

• 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 der erforderlichen Berechtigung 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/foo.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/foo.jpg).
5. Klicken Sie auf Entwerten.

gcloud

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --path "/images/foo.jpg"

Ersetzen Sie URL_MAP_NAME durch den Namen der URL-Zuordnungsressource in Ihrem Load-Balancer. Zum Auflisten der URL-Zuordnungen verwenden Sie den Befehl gcloud compute url-maps list.

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 URL_MAP_NAME \
    --host HOSTNAME \
    --path "/images/foo.jpg"

Standardmäßig wartet das gcloud-Befehlszeilentool, 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 URL_MAP_NAME \
    --path "/images/*"

Ersetzen Sie URL_MAP_NAME durch den Namen der URL-Zuordnungsressource in Ihrem Load-Balancer. Zum Auflisten der URL-Zuordnungen verwenden Sie den Befehl gcloud compute url-maps list.

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 URL_MAP_NAME \
    --host HOSTNAME \
    --path "/images/*"

Standardmäßig wartet das gcloud-Befehlszeilentool, 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 URL_MAP_NAME \
    --path "/*"

Dabei gilt:

• URL_MAP_NAME – Der Name der URL-Zuordnungsressource in Ihrem Load-Balancer.
• /* – 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 URL_MAP_NAME \
    --host HOSTNAME \
    --path "/*"

Standardmäßig wartet das gcloud-Befehlszeilentool, 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.
• Informationen zu GFE-Points-of-Presence finden Sie unter Cache-Speicherorte.