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

Mit der Google Cloud CLI oder der Google Cloud Console können Sie Entwertungen durchführen.

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.

Hinweis: Wenn Sie einen globalen externen Application Load Balancer mit freigegebene VPC verwenden projektübergreifenden Dienstleistungsreferenzen, haben Dienstprojektadministratoren standardmäßig nicht die erforderlichen Berechtigungen, um Cache-Entwertungen. Dies liegt daran, dass die Cache-Entwertung in der Frontend-Projekt (d. h. das Projekt mit der Weiterleitungsregel, Proxy und die URL-Zuordnung des Load-Balancers. Dienstadministratoren, die die Bereitstellung der Backend-Dienste in einem separaten Projekt steuern, können mit dem Load-Balancer-Administrator des Frontend-Projekts zusammenarbeiten, um die Cache-Entwertung für ihre projektübergreifenden Dienste auszuführen. Stellen Sie bei URL-Umschreibungen sicher, dass die Entwertung mit dem Host und dem Pfad für die Vorumschreibung übereinstimmt, die der Client sendet.

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 Application 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.