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.

Hinweise

Sie können die Google Cloud CLI oder die Google Cloud Console verwenden, um Entwertungen durchzufü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 projektübergreifenden Dienstverweisen für freigegebene VPC VPCs verwenden, haben Dienstprojektadministratoren standardmäßig nicht die erforderlichen Berechtigungen, um Cache-Entwertungen anzufordern. Dies liegt daran, dass die Cache-Entwertung im Front-End-Projekt konfiguriert ist (d. h. im Projekt mit der Weiterleitungsregel, dem Zielproxy und der URL-Zuordnung des Load-Balancers). Dienstadministratoren, die die Bereitstellung der Back-End-Dienste in einem separaten Projekt steuern, können gemeinsam mit dem Load-Balancer-Administrator des Front-End-Projekts die Cache-Entwertung für ihre projektübergreifenden Dienste veranlassen. Achten Sie bei URL-Umschreibungen darauf, dass die Entwertung mit dem Host und Pfad vor der Umschreibung übereinstimmt, die der Client sendet.

Nur eine Datei entwerten

Console

Rufen Sie in der Google Cloud Console die Seite Cloud CDN auf.
Zur Cloud CDN-Seite
Klicken Sie unter Zugeordnete Load-Balancer auf den Namen des Load-Balancers.
Klicken Sie auf den Tab Cache-Entwertung.
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).
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

Rufen Sie in der Google Cloud Console die Seite Cloud CDN auf.
Zur Cloud CDN-Seite
Klicken Sie unter Zugeordnete Load-Balancer auf den Namen des Load-Balancers.
Klicken Sie auf den Tab Cache-Entwertung.
Geben Sie den Verzeichnispfad und den Platzhalter (/path/to/file/*) ein.
- 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/*).
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

Rufen Sie in der Google Cloud Console die Seite Cloud CDN auf.
Zur Cloud CDN-Seite
Klicken Sie unter Zugeordnete Load-Balancer auf den Namen des Load-Balancers.
Klicken Sie auf den Tab Cache-Entwertung.
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/*).
Klicken Sie auf Entwerten.

gcloud

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

Ersetzen Sie Folgendes:

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.

Nächste Schritte

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.