Cambia modalità cache

Questa pagina fornisce istruzioni per modificare le modalità cache con Cloud CDN. Le modalità cache ti consentono di configurare il modo in cui Cloud CDN memorizza i tuoi contenuti.

Prima di iniziare

  • Ulteriori informazioni sulle modalità cache e sui contenuti statici.

  • Assicurati che Cloud CDN sia abilitato. Per le istruzioni, vedi Utilizzo di Cloud CDN.

  • Se necessario, esegui l'aggiornamento alla versione più recente di Google Cloud CLI:

    gcloud components update
    

Impostazione della modalità cache

Cloud CDN offre tre modalità cache che definiscono il modo in cui le risposte vengono memorizzate nella cache, se Cloud CDN rispetta le direttive di cache inviate dall'origine e come vengono applicati i TTL della cache.

Le modalità cache disponibili sono mostrate nella tabella seguente:

Modalità cache Comportamento
CACHE_ALL_STATIC Memorizza automaticamente nella cache le risposte riuscite con contenuti statici che non sono altrimenti non memorizzabili nella cache. Anche le risposte provenienti dall'origine, che impostano valide direttive di memorizzazione nella cache, vengono memorizzate nella cache.

Questo è il comportamento predefinito per i backend abilitati per Cloud CDN creati utilizzando Google Cloud CLI o l'API REST.

USE_ORIGIN_HEADERS Richiede risposte dell'origine riuscite per impostare istruzioni di cache valide e intestazioni di memorizzazione nella cache valide. Le risposte riuscite senza queste istruzioni vengono inoltrate dall'origine.
FORCE_CACHE_ALL Memorizza nella cache le risposte riuscite in modo incondizionato, eseguendo l'override di eventuali istruzioni di memorizzazione nella cache impostate dall'origine. Questa modalità non è appropriata se il backend pubblica contenuti privati per utente, come risposte HTML dinamiche o API.

Le risposte di errore possono essere memorizzate nella cache anche in assenza di istruzioni di cache valide.

Prima di impostare la modalità cache su FORCE_CACHE_ALL, considera i seguenti comportamenti:

  • Per URL firmati o cookie firmati, FORCE_CACHE_ALL sostituisce l'età massima specificata tramite l'impostazione Età massima delle voci della cache nella console Google Cloud o l'opzione gcloud --signed-url-cache-max-age.

  • FORCE_CACHE_ALL modifica la durata (TTL) di eventuali contenuti precedentemente memorizzati nella cache. Questa modifica può far sì che alcune voci precedentemente considerate aggiornate (a causa della presenza di TTL più lunghi dalle intestazioni dell'origine) vengano considerate inattive. Inoltre, alcune voci precedentemente considerate obsolete possono essere considerate come nuove.

  • FORCE_CACHE_ALL esegue l'override delle istruzioni cache (Cache-Control e Expires), ma non di altre intestazioni della risposta dell'origine. In particolare, un'intestazione Vary viene comunque rispettata e potrebbe eliminare la memorizzazione nella cache anche in presenza di FORCE_CACHE_ALL. Per ulteriori informazioni, consulta Intestazioni Vary.

Per configurare le modalità cache per un backend abilitato per Cloud CDN:

Console

  1. Nella console Google Cloud, vai alla pagina Bilanciamento del carico.

    Vai alla pagina Bilanciamento del carico

  2. Fai clic sul nome del bilanciatore del carico delle applicazioni esterno.
  3. Fai clic su Modifica .
  4. In Configurazione backend, seleziona un backend e fai clic su Modifica .
  5. Assicurati che l'opzione Abilita Cloud CDN sia selezionata.
  6. In Modalità cache, seleziona una delle seguenti opzioni:
    • Memorizza nella cache contenuti statici (opzione consigliata): i contenuti statici sono asset web che non cambiano per ogni utente. I contenuti statici si basano sul valore Content-Type della risposta. Per maggiori informazioni, vedi Contenuti statici.
    • Utilizza le impostazioni dell'origine in base alle intestazioni Cache-Control: memorizza nella cache le risposte con istruzioni di cache valide nelle intestazioni delle risposte.
    • Forza memorizzazione nella cache di tutti i contenuti: memorizza nella cache tutti i contenuti pubblicati correttamente dall'origine, ignorando eventuali istruzioni private o no-store.
  7. Fai clic su Salva.

gcloud

Per i servizi di backend, utilizza il comando gcloud compute backend-services create o gcloud compute backend-services update con il flag --cache-mode.

Per i bucket di backend, utilizza il comando gcloud compute backend-buckets create o gcloud compute backend-buckets update con il flag --cache-mode.

gcloud compute backend-services (create | update) BACKEND_SERVICE_NAME
    --cache-mode=CACHE_MODE
gcloud compute backend-buckets (create | update) BACKEND_BUCKET_NAME
    --cache-mode=CACHE_MODE

Sostituisci CACHE_MODE con uno dei seguenti:

  • CACHE_ALL_STATIC (impostazione predefinita): memorizza automaticamente nella cache i contenuti statici. Le risposte contrassegnate come non memorizzabili nella cache (istruzioni private o no-store nelle intestazioni delle risposte Cache-Control) non vengono memorizzate nella cache. Per memorizzare nella cache contenuti dinamici, questi devono avere intestazioni di memorizzazione nella cache valide.

  • USE_ORIGIN_HEADERS: richiede l'origine per impostare intestazioni di memorizzazione nella cache valide per memorizzare i contenuti nella cache. Le risposte senza queste intestazioni non vengono memorizzate nella cache a livello perimetrale di Google e richiedono un viaggio completo verso l'origine per ogni richiesta, con possibili ripercussioni sulle prestazioni e aumento del carico sul server di origine.

  • FORCE_CACHE_ALL: memorizza nella cache tutti i contenuti (ovvero le risposte riuscite), ignorando eventuali istruzioni private o no-store nelle intestazioni delle risposte Cache-Control. Ciò potrebbe causare la memorizzazione nella cache di contenuti privati per utente (identificabile dall'utente). Abilita questa opzione solo sui backend che non gestiscono contenuti privati o dinamici, come i bucket Cloud Storage. Non abilitare questa opzione sui backend che pubblicano contenuti privati o dinamici.

API

Per i bucket di backend, utilizza la chiamata API Method: backendBuckets.insert o Method: backendBuckets.update.

Per i servizi di backend, utilizza la chiamata API Method: backendServices.insert o Method: backendServices.update.

Utilizza una delle seguenti chiamate API:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendBuckets/BACKEND_BUCKET
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices
PUT https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/backendServices/BACKEND_SERVICE

Aggiungi il seguente snippet al corpo della richiesta JSON:

"cdnPolicy": {
  "cacheMode": (CACHE_ALL_STATIC | USE_ORIGIN_HEADERS | FORCE_CACHE_ALL)

Sostituisci CACHE_MODE con uno dei seguenti:

  • CACHE_ALL_STATIC (impostazione predefinita): memorizza automaticamente nella cache contenuti statici se l'origine non imposta intestazioni di memorizzazione nella cache valide. Le risposte contrassegnate come non memorizzabili nella cache (istruzioni private o no-store nelle intestazioni delle risposte Cache-Control) non vengono memorizzate nella cache. Per memorizzare nella cache i contenuti dinamici, questi devono avere intestazioni di memorizzazione nella cache valide.

  • USE_ORIGIN_HEADERS: richiede l'origine dell'impostazione di intestazioni di memorizzazione nella cache valide per memorizzare i contenuti nella cache. Le risposte senza queste intestazioni non vengono memorizzate nella cache a livello perimetrale di Google e richiedono un viaggio completo verso l'origine per ogni richiesta, con possibili ripercussioni sulle prestazioni e aumento del carico sul server di origine.

  • FORCE_CACHE_ALL: memorizza nella cache tutti i contenuti (ovvero le risposte riuscite), ignorando eventuali istruzioni private o no-store nelle intestazioni delle risposte Cache-Control. Ciò potrebbe causare la memorizzazione nella cache di contenuti privati per utente (identificabile dall'utente). Abilita questa opzione solo sui backend che non gestiscono contenuti privati o dinamici, come i bucket Cloud Storage.