Zawartość aplikacji w pamięci podręcznej

Cloud CDN to kluczowy element obsługi aplikacji internetowej przez App Hosting. Każde żądanie do backendu przechodzi najpierw przez Cloud CDN. Treści, które są już zapisane w pamięci podręcznej w sieci CDN, są natychmiast udostępniane użytkownikowi, bez konieczności przesyłania ich do usługi Cloud Run, w której działa kod serwera aplikacji internetowej. Więcej informacji o ogólnych zaletach sieci CDN znajdziesz na stronie web.dev.

Chociaż podstawowa konfiguracja Cloud CDN jest ustawiana przez App Hosting i nie można jej modyfikować, możesz wykonać szereg czynności, aby zoptymalizować buforowanie w celu zwiększenia szybkości wczytywania strony, zmniejszenia ilości rozliczanych treści niebuforowanych i zminimalizowania ruchu do Cloud Run.

Treść podlegająca zapisywaniu w pamięci podręcznej

Cloud CDN przechowuje odpowiedzi w pamięci podręcznej, jeśli spełnione są WSZYSTKIE te warunki:

  1. Żądanie jest typu GET.

  2. Odpowiedź ma kod stanu 200, 203, 204, 206, 300, 301, 302, 307, 308, 404, 405, 410, 421, 451 lub 501.

  3. Odpowiedź zawiera nagłówek Cache-Control z dyrektywą max-age lub s-maxage albo nagłówek Expires z sygnaturą czasową w przyszłości.

  4. Odpowiedź zawiera nagłówek Age lub Cache-Control z wyraźną dyrektywą public.

  5. Odpowiedź ma rozmiar nie większy niż 10 MiB.

oraz ŻADNE z tych stwierdzeń nie jest prawdziwe:

  1. Odpowiedź zawiera nagłówek Set-Cookie

  2. Odpowiedź zawiera nagłówek Vary o wartości innej niż Accept, 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, Next-Router-Segment-Prefetch lub Next-Url.

  3. Odpowiedź zawiera nagłówek Cache-Control z dyrektywą no-store lub private.

  4. Żądanie zawiera nagłówek Cache-Control z dyrektywą no-store.

  5. Żądanie ma nagłówek Authorization, chyba że odpowiedź zawiera wyraźną dyrektywę kontroli pamięci podręcznej.

Dostosowywanie działania za pomocą dyrektyw kontroli pamięci podręcznej

Next.js

Next.js ustawia dyrektywy kontroli pamięci podręcznej niejawnie na podstawie wielu czynników. Możesz jednak zastąpić te ustawienia, ręcznie ustawiając nagłówek w pliku next.config.js. Aby na przykład upewnić się, że strona nie jest przechowywana w pamięci podręcznej Cloud CDN:

  /** @type {import('next').NextConfig} */
  const nextConfig = {
      headers: async () => [{
          source: "/YOUR_PRIVATE_PAGE",
          headers: [{
              key: "Cache-Control",
              value: "private"
          }],
      }],
  };

Angular

Angular SSR nie ustawia domyślnie jawnych dyrektyw kontroli pamięci podręcznej. Możesz dodać własne, określając nagłówki cache-control w trasach serwera. Aby na przykład umożliwić Cloud CDN zapisywanie wszystkich stron w pamięci podręcznej przez godzinę:

import { RenderMode, ServerRoute } from '@angular/ssr';

export const serverRoutes: ServerRoute[] = [
  {
    path: '**',
    renderMode: RenderMode.Prerender,
    headers: {
      'Cache-Control': 'public, max-age=3600',
    }
  }
];

Aby mieć pewność, że określona strona nie zostanie zapisana w pamięci podręcznej:

import { RenderMode, ServerRoute } from '@angular/ssr';

export const serverRoutes: ServerRoute[] = [
  // ... other routes
  {
    path: 'YOUR_PRIVATE_PAGE',
    renderMode: RenderMode.Server,
    headers: {
      'Cache-Control': 'private',
    }
  }
];

Obowiązkowe dyrektywy

Instancja Cloud CDN Firebase App Hosting uwzględnia te dyrektywy kontroli pamięci podręcznej:

Dyrektywa Żądanie Odpowiedź
no-store Jeśli jest obecny w żądaniu, odpowiedź nie zostanie zapisana w pamięci podręcznej. Odpowiedź z nagłówkiem no-store nie jest przechowywana w pamięci podręcznej.
no-cache Dyrektywa żądania no-cache jest ignorowana, aby uniemożliwić klientom potencjalne inicjowanie lub wymuszanie ponownej weryfikacji w źródle. Odpowiedź z nagłówkiem no-cache jest przechowywana w pamięci podręcznej, ale przed wyświetleniem musi zostać ponownie zweryfikowana przez źródło.
public Nie dotyczy Ta dyrektywa nie jest wymagana do buforowania, ale warto ją uwzględnić w przypadku treści, które powinny być buforowane przez serwery proxy.
private Nie dotyczy Odpowiedź z dyrektywą private nie jest przechowywana w pamięci podręcznej Cloud CDN, nawet jeśli w innym przypadku jest uznawana za możliwą do zapisania w pamięci podręcznej. Klienty (np. przeglądarki) mogą nadal przechowywać wynik w pamięci podręcznej. Użyj wartości no-store, aby uniemożliwić zapisywanie odpowiedzi w pamięci podręcznej.
max-age=SECONDS Dyrektywa żądania max-age jest ignorowana. Odpowiedź z pamięci podręcznej jest zwracana tak, jakby ten nagłówek nie był uwzględniony w żądaniu. Odpowiedź z dyrektywą max-age jest przechowywana w pamięci podręcznej przez określoną liczbę SEKUND.
s-maxage=SECONDS Nie dotyczy Odpowiedź z dyrektywą s-maxage jest przechowywana w pamięci podręcznej przez określoną liczbę SEKUND. Jeśli występują oba nagłówki max-age i s-maxage, Cloud CDN używa nagłówka s-maxage. Odpowiedzi z tą dyrektywą nie są wyświetlane jako nieaktualne. s-max-age (2 łączniki) nie jest prawidłową wartością na potrzeby buforowania.
max-stale=SECONDS Dyrektywa żądania max-stale określa maksymalną nieaktualność (w sekundach), którą klient jest w stanie zaakceptować. Cloud CDN uwzględnia to i zwraca nieaktualną odpowiedź z pamięci podręcznej tylko wtedy, gdy nieaktualność odpowiedzi jest mniejsza niż dyrektywa max-stale. W przeciwnym razie ponownie sprawdza poprawność przed obsłużeniem żądania. Nie dotyczy
stale-while-revalidate=SECONDS Nie dotyczy Odpowiedź z nagłówkiem stale-while-revalidate jest wyświetlana klientowi przez maksymalnie SECONDS, podczas gdy ponowna weryfikacja odbywa się asynchronicznie.
must-revalidate Nie dotyczy Odpowiedź z nagłówkiem must-revalidate jest po wygaśnięciu ponownie sprawdzana na serwerze pierwotnym. Odpowiedzi z tą dyrektywą nie są wyświetlane jako nieaktualne.
proxy-revalidate Odpowiedź z nagłówkiem proxy-revalidate jest po wygaśnięciu ponownie sprawdzana na serwerze pierwotnym. Odpowiedzi z tą dyrektywą nie są wyświetlane jako nieaktualne.
no-transform Nie dotyczy Cloud CDN nie stosuje żadnych przekształceń.

Pomiar ruchu w pamięci podręcznej i poza nią

Na karcie App Hosting > Wykorzystanie w konsoli Firebase wykres „Cloud CDN – przepustowość dla ruchu wychodzącego” pokazuje liczbę bajtów obsłużonych z pamięci podręcznej i bez niej. Każde wdrożenie jest oznaczone na wykresie. Za pomocą tego wykresu możesz mierzyć skuteczność działań związanych z optymalizacją pamięci podręcznej.

Możesz też wyświetlić współczynnik trafień w pamięci podręcznej dla konkretnych tras w aplikacji internetowej, korzystając z monitorowania opartego na trasach.