Cloud CDN ist ein wichtiger Bestandteil der App Hosting-Unterstützung für Ihre Webanwendung. Jede Anfrage an Ihr Back-End wird zuerst über Cloud CDN geleitet. Inhalte, die bereits im CDN im Cache gespeichert sind, werden sofort an den Nutzer zurückgegeben, sodass der Cloud Run-Dienst, in dem der Servercode Ihrer Webanwendung ausgeführt wird, nicht aufgerufen werden muss. Weitere Informationen zu den allgemeinen Vorteilen von CDNs finden Sie unter web.dev.
Die grundlegende Cloud CDN-Konfiguration wird von App Hosting festgelegt und kann nicht geändert werden. Es gibt jedoch eine Reihe von Möglichkeiten, das Caching zu optimieren, um die Seitenladezeit zu verkürzen, die Anzahl der in Rechnung gestellten nicht im Cache gespeicherten Inhalte zu reduzieren und den Traffic zu Cloud Run zu minimieren.
Im Cache speicherbare Inhalte
Cloud CDN speichert Antworten im Cache, wenn ALLE der folgenden Bedingungen erfüllt sind:
Die Anfrage ist eine GET-Anfrage.
Die Antwort hat den Statuscode
200
,203
,204
,206
,300
,301
,302
,307
,308
,404
,405
,410
,421
,451
oder501
.Die Antwort hat einen
Cache-Control
-Header mit einermax-age
- oders-maxage
-Anweisung oder einenExpires
-Header mit einem Zeitstempel in der Zukunft.Die Antwort hat einen
Age
-Header oder einenCache-Control
-Header mit einer explizitenpublic
-Anweisung.Die Antwort darf maximal 10 MiB groß sein.
und KEINE der folgenden Aussagen treffen zu:
Die Antwort hat einen
Set-Cookie
-Header.Die Antwort hat einen
Vary
-Header mit einem anderen Wert alsAccept
,Accept-Encoding
,Access-Control-Request-Headers
,Access-Control-Request-Method
,Origin
,Sec-Fetch-Dest
,Sec-Fetch-Mode
,Sec-Fetch-Site
,X-Goog-Allowed-Resources
,X-Origin
,RSC
,Next-Router-State-Tree
,Next-Router-Prefetch
oderNext-Router-Segment-Prefetch
.Die Antwort hat einen
Cache-Control
-Header mit der Anweisungno-store
oderprivate
.Die Anfrage hat einen
Cache-Control
-Header mit einerno-store
-Anweisung.Die Anfrage hat einen
Authorization
-Header, es sei denn, die Antwort enthält eine explizite Cache-Steuerungsanweisung.
Verhalten mit Cache-Kontrollanweisungen anpassen
Next.js
In Next.js werden Cache-Steuerungsanweisungen auf der Grundlage einer Reihe von Faktoren implizit festgelegt. Sie können diese jedoch überschreiben, indem Sie die Überschrift in der next.config.js
-Datei manuell festlegen. So sorgen Sie beispielsweise dafür, dass eine Seite nicht in Cloud CDN im Cache gespeichert wird:
/** @type {import('next').NextConfig} */
const nextConfig = {
headers: async () => [{
source: "/YOUR_PRIVATE_PAGE",
headers: [{
key: "Cache-Control",
value: "private"
}],
}],
};
Angular
Bei Angular SSR werden standardmäßig keine expliziten Cache-Kontrollrichtlinien festgelegt. Du kannst eigene Header hinzufügen, indem du in deinen Server-Routen Cache-Kontroll-Header angibst. So können Sie beispielsweise festlegen, dass Cloud CDN alle Seiten für eine Stunde im Cache speichert:
import { RenderMode, ServerRoute } from '@angular/ssr';
export const serverRoutes: ServerRoute[] = [
{
path: '**',
renderMode: RenderMode.Prerender,
headers: {
'Cache-Control': 'public, max-age=3600',
}
}
];
So sorgen Sie dafür, dass eine bestimmte Seite nicht im Cache gespeichert wird:
import { RenderMode, ServerRoute } from '@angular/ssr';
export const serverRoutes: ServerRoute[] = [
// ... other routes
{
path: 'YOUR_PRIVATE_PAGE',
renderMode: RenderMode.Server,
headers: {
'Cache-Control': 'private',
}
}
];
Berücksichtigte Richtlinien
Die Cloud CDN-Instanz von Firebase App Hosting berücksichtigt die folgenden Cache-Steuerungsanweisungen:
Anweisung | Anfrage | Antwort |
---|---|---|
no-store |
Wenn dieser Header in einer Anfrage vorhanden ist, wird die Antwort nicht im Cache gespeichert. | Eine Antwort mit no-store wird nicht im Cache gespeichert. |
no-cache |
Die Anfrageanweisung no-cache wird ignoriert, um zu verhindern, dass Clients den Ursprung möglicherweise initiieren oder dessen nochmalige Validierung erzwingen. |
Eine Antwort mit no-cache wird im Cache gespeichert, muss aber noch einmal mit dem Ursprung validiert werden, bevor sie bereitgestellt wird. |
public |
– | Diese Anweisung ist für die Cache-Fähigkeit nicht erforderlich. Es empfiehlt sich jedoch, sie für Inhalte aufzunehmen, die von Proxys im Cache gespeichert werden sollen. |
private |
– | Eine Antwort mit der Anweisung private wird von Cloud CDN nicht im Cache gespeichert, auch wenn die Antwort ansonsten als cachefähig gilt. Clients wie Browser können das Ergebnis jedoch weiterhin im Cache speichern. Verwenden Sie no-store , um das gesamte Caching der Antworten zu verhindern. |
max-age=SECONDS |
Die Anfrageanweisung max-age wird ignoriert. Eine im Cache gespeicherte Antwort wird zurückgegeben, als wäre dieser Header nicht in der Anfrage enthalten. |
Eine Antwort mit der Anweisung max-age wird bis zur festgelegten Anzahl von SEKUNDEN im Cache gespeichert. |
s-maxage=SECONDS |
– | Eine Antwort mit der Anweisung s-maxage wird bis zur festgelegten Anzahl an SEKUNDEN im Cache gespeichert. Wenn sowohl max-age als auch s-maxage vorhanden sind, wird s‑maxage von Cloud CDN verwendet. Antworten mit dieser Anweisung werden nicht veraltet bereitgestellt. s-max-age (zwei Bindestriche) ist für das Caching nicht anwendbar. |
max-stale=SECONDS |
Die Anfrageanweisung max-stale gibt die maximale Veralterung in Sekunden an, die der Client akzeptiert. Cloud CDN berücksichtigt dies und gibt eine veraltete Cache-Antwort nur zurück, wenn die Veralterung der Antwort geringer als der Wert der Anweisung max-stale ist. Andernfalls wird die Anfrage noch einmal validiert, bevor die Anfrage bereitgestellt wird. |
– |
stale-while-revalidate=SECONDS |
– | Eine Antwort mit stale-while-revalidate wird bis zu SECONDS lang für einen Client bereitgestellt, während die nochmalige Validierung asynchron erfolgt. |
must-revalidate |
– | Eine Antwort mit must-revalidate wird nach dem Ablauf noch einmal mit dem Ursprungsserver validiert. Antworten mit dieser Anweisung werden nicht veraltet bereitgestellt. |
proxy-revalidate |
Eine Antwort mit proxy-revalidate wird nach dem Ablauf noch einmal mit dem Ursprungsserver validiert. Antworten mit dieser Anweisung werden nicht veraltet bereitgestellt. |
|
no-transform |
– | Cloud CDN wendet keine Transformationen an. |
Traffic mit und ohne Cache messen
Im Diagramm „Cloud CDN – Ausgehende Bandbreite“ auf dem Tab Nutzung der App Hosting-Konsole werden gecachte und nicht gecachte Bytes angezeigt, die bereitgestellt wurden. Außerdem ist für jedes Roll-out eine Markierung zu sehen. Anhand dieses Diagramms können Sie die Wirksamkeit Ihrer Cache-Optimierung messen.