Utilizzo della memorizzazione negativa nella cache

Questa pagina fornisce istruzioni per l'utilizzo della memorizzazione nella cache negativa con Cloud CDN. La memorizzazione nella cache negativa consente di impostare un TTL diverso per ogni codice di stato.

Il motivo è applicare un controllo granulare sulla memorizzazione nella cache per reindirizzamenti o errori comuni. Ciò può ridurre il carico sulle origini e migliorare l'esperienza dell'utente finale riducendo la latenza di risposta.

Prima di iniziare

• Scopri di più sulle modalità della cache e sui contenuti statici.

• Assicurati che Cloud CDN sia abilitato. Per istruzioni, consulta Utilizzare Cloud CDN.

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

  gcloud components update
  

Codici di stato e TTL predefiniti

La memorizzazione nella cache negativa si applica a codici di stato specifici, elencati nella tabella riportata di seguito.

Cloud CDN applica i seguenti TTL predefiniti a questi codici di stato:

Puoi eseguire l'override di questi valori predefiniti utilizzando la memorizzazione nella cache negativa per impostare un TTL della cache per il codice di stato HTTP specificato.

Configurare la memorizzazione nella cache negativa

La memorizzazione nella cache negativa ti consente di configurare il servizio in modo da memorizzare nella cache sia i fallimenti sia i risultati positivi. In questo modo, Cloud CDN protegge le origini dalle richieste che generano errori (come 404 Not Found) nello stesso modo in cui protegge le origini dalle richieste che generano risposte positive.

gcloud compute backend-buckets (create | update) BACKEND_BUCKET_NAME
    --negative-caching

gcloud compute backend-services (create | update) BACKEND_SERVICE_NAME
    --negative-caching

gcloud compute backend-services update BACKEND_SERVICE_NAME \
    --negative-caching \
    --cache-mode=CACHE_ALL_STATIC \
    --default-ttl=86400 \
    --negative-caching-policy='404=60,405=120'

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

"cdnPolicy": {
  "negativeCaching": ON,
  "negativeCachingPolicy": [
    {
      "code": STATUS_CODE,
      "ttl": TTL_SECONDS
    }
  ]
}

Per configurare le impostazioni di negativeCachingPolicy, è necessario attivare la memorizzazione nella cache negativa. Se ometti il criterio e hai attivato negativeCaching, Cloud CDN utilizza i valori predefiniti elencati in Codici di stato e TTL predefiniti.

Quando specifichi un criterio di memorizzazione nella cache negativa, assicurati di specificare un TTL della cache per tutti i codici di risposta che vuoi memorizzare nella cache. Cloud CDN non applica alcuna memorizzazione nella cache negativa predefinita se esiste una norma.

Per STATUS_CODE, puoi specificare i seguenti codici di stato HTTP:

• 300, 301, 302, 307, 308
• 404, 405, 410, 421, 451
• 501

Per ogni codice di stato, puoi specificare il numero di secondi per memorizzare nella cache le risposte. Per disattivare la memorizzazione nella cache negativa per il codice di stato, escludi il codice dal criterio di memorizzazione nella cache negativa.

Il valore massimo consentito è 1800 secondi (30 minuti); tuttavia, gli oggetti a cui si accede raramente potrebbero essere espulsi dalla cache prima del TTL definito.

Quando la modalità cache è impostata su CACHE_ALL_STATIC o USE_ORIGIN_HEADERS, la memorizzazione nella cache negativa viene applicata alle risposte con il codice di risposta specificato che non contengono intestazioni Cache-Control o Expires.

Quando la modalità cache è impostata su FORCE_CACHE_ALL, la memorizzazione nella cache negativa sostituisce tutte le intestazioni di memorizzazione nella cache impostate dall'origine e Cloud CDN memorizza nella cache la risposta per il periodo di tempo specificato dal TTL oppure non la memorizza affatto se non è impostato alcun TTL.

Inoltre, quando la modalità cache è impostata su FORCE_CACHE_ALL, Cloud CDN modificherà anche il max-age inviato al client nell'intestazione Cache-Control. In particolare, se per un determinato errore è configurata un'impostazione TTL, Cloud CDN prenderà il valore più basso tra questa impostazione e l'impostazione di configurazione client_ttl e invierà un'intestazione Cache-Control: public,max-age=N con questo valore. Se per un determinato errore non è configurata un'impostazione TTL, Cloud CDN rimuoverà qualsiasi intestazione Cache-Control inviata dall'origine. Cloud CDN rimuoverà sempre anche qualsiasi intestazione Expires inviata dall'origine.

Se per un'origine la memorizzazione nella cache negativa è inizialmente attivata, ma poi viene disattivata (manualmente o disattivando la memorizzazione nella cache per un determinato codice di risposta), le risposte agli errori memorizzate nella cache sono considerate valide solo in base alle intestazioni Cache-Control o Expires. Pertanto, una volta disattivata la memorizzazione nella cache negativa, una risposta senza direttive di età della memorizzazione nella cache nelle intestazioni non viene pubblicata dalla cache.

Cloud CDN memorizza nella cache in risposta alle richieste GET. Per ulteriori informazioni, consulta Contenuti cacheabili.

Ogni voce della cache è identificata da una chiave della cache.

Disattivare la memorizzazione nella cache negativa

gcloud compute backend-services (create | update) (BACKEND_SERVICE_NAME | BACKEND_BUCKET_NAME)
    --no-negative-caching

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

"cdnPolicy": {
  "negativeCaching": OFF
}