Personalizza chiavi cache

Questa pagina spiega come personalizzare le chiavi cache di Cloud CDN.

La modifica della configurazione delle chiavi cache potrebbe causare un calo improvviso della cache percentuale di hit se le nuove richieste iniziano a usare chiavi cache diverse da le vecchie voci delle chiavi cache. Analogamente, la modifica del creatore della chiave della cache non necessariamente invalida le voci memorizzate nella cache se le nuove richieste utilizzano la stessa chiave delle vecchie chiavi della cache. Per invalidare le voci memorizzate nella cache esistenti, consulta la sezione Convalida dei contenuti memorizzati nella cache.

Prima di iniziare

Questa pagina presuppone la conoscenza di Cloud CDN, Chiavi cache di Cloud CDN, con bilanciamento del carico servizi di backend. Ti consigliamo di consultare queste pagine prima di procedere.

Abilita Cloud CDN e personalizza le chiavi cache

Queste istruzioni attivano Cloud CDN per un servizio di backend bilanciato in base al carico e personalizza la chiave della cache escludendo uno o più componenti. Se non hai già un bilanciatore del carico da utilizzare come origine, consulta Il bilanciatore del carico delle applicazioni esterno documentazione per istruzioni su come crearne uno.

I bucket di backend non includono il protocollo o l'host nella chiave cache perché non influiscono sul modo in cui viene fatto riferimento agli oggetti all'interno di un Cloud Storage di sincronizzare la directory di una VM con un bucket. Tuttavia, includono un insieme di parametri di stringa di query specifici per Cloud Storage, che potrebbero influire sulla risposta e essere estesi da un elenco personalizzabile di nomi di parametri.

Console

  1. Nella console Google Cloud, vai alla pagina Cloud CDN.

    Vai a Cloud CDN

  2. Fai clic su Aggiungi origine.
  3. Nel menu a discesa Origine, fai clic su Seleziona origine.
  4. Seleziona l'origine per cui vuoi abilitare CDN.
  5. Nella riga dell'origine, fai clic su Configura.

    Se Cloud CDN è già abilitato su questa origine, fai prima clic nel menu , seleziona Modifica, e poi fai clic su Configura.

  6. Deseleziona le caselle di controllo relative ai campi che vuoi escludere dalla chiave cache per questo servizio di backend.

  7. Fai clic su Salva.

  8. Fai clic su Aggiungi.

gcloud

Specifica uno o più flag facoltativi per escludere il componente dalle chiavi cache per questo servizio di backend.

gcloud compute backend-services update BACKEND_SERVICE \
    --enable-cdn

Flag facoltativi:

  • --no-cache-key-include-protocol
  • --no-cache-key-include-host
  • --no-cache-key-include-query-string

Aggiorna le chiavi cache per aggiungere nuovamente il protocollo, l'host e la stringa di query

Per impostazione predefinita, i servizi di backend configurati per utilizzare Cloud CDN includono tutti i componenti dell'URI della richiesta nelle chiavi della cache. Se in precedenza avevi indicato escludere uno o più componenti, puoi seguire questi passaggi per includerle di nuovo.

Queste istruzioni consentono di aggiungere nuovamente il protocollo, l'host e la stringa di query chiave cache per un servizio di backend esistente che dispone già di Cloud CDN in un bucket in cui è abilitato il controllo delle versioni.

Console

  1. Nella console Google Cloud, vai alla pagina Cloud CDN.

    Vai a Cloud CDN

  2. Nella riga del bilanciatore del carico, fai clic su Menu e quindi su Modifica.
  3. Nella riga del servizio di backend o del bucket di backend da modificare, fai clic su Configura.
  4. In Chiave cache, seleziona Personalizzata.
  5. Seleziona le caselle di controllo Protocollo, Host e Stringa di query.
  6. Lascia vuoto il campo Parametri stringa di query.
  7. Fai clic su Salva.
  8. Fai clic su Aggiorna.

gcloud

Per aggiungere nuovamente un solo componente, specifica solo il flag. Qualsiasi non specificato vengono lasciati invariati.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-protocol \
    --cache-key-include-host \
    --cache-key-include-query-string

Aggiorna le chiavi della cache per utilizzare un elenco di inclusione o esclusione dei parametri della stringa di query

Queste istruzioni impostano le chiavi cache di Cloud CDN in modo che utilizzino un elenco di inclusione o escludi un elenco con i parametri della stringa di query.

Console

  1. Nella console Google Cloud, vai alla pagina Cloud CDN.

    Vai a Cloud CDN

  2. Nella riga del bilanciatore del carico, fai clic su Menu e quindi su Modifica.
  3. Nella riga del servizio di backend che vuoi modificare, fai clic su Configura.
  4. In Chiave cache, seleziona Personalizzata.
  5. Verifica che la casella di controllo Stringa di query sia selezionata.
  6. Se vuoi specificare i parametri della stringa di query che devono far parte del la chiave cache, seleziona Includi solo gli elementi selezionati.

    Se vuoi specificare che tutti i parametri della stringa di query tranne quelli che sono inclusi nella chiave cache, seleziona Includi tutto tranne gli elementi selezionati.

  7. Inserisci un elenco di stringhe separate da virgole nella Stringa di query parametri.

  8. Fai clic su Salva.

  9. Fai clic su Aggiorna.

gcloud

Utilizza questo comando per impostare il parametro della stringa di query user sull'inclusione di un servizio di backend.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-query-string \
    --cache-key-query-string-whitelist user

Utilizza questo comando per impostare il parametro della stringa di query user sull'esclusione di un servizio di backend.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-query-string \
    --cache-key-query-string-blacklist user

Utilizza questo comando per impostare il parametro della stringa di query user sull'inclusione di un bucket di backend.

gcloud compute backend-buckets update BACKEND_BUCKET \
    --cache-key-query-string-whitelist user

Aggiorna le chiavi della cache per utilizzare le intestazioni HTTP

Queste istruzioni impostano le chiavi cache di Cloud CDN in modo che utilizzino le intestazioni HTTP.

Console

La console Google Cloud non è supportata per questa funzionalità.

gcloud

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-http-header=[HEADER_FIELD_NAME,...]
gcloud compute backend-buckets update BACKEND_BUCKET \
    --cache-key-include-http-header=[HEADER_FIELD_NAME,...]

Aggiorna le chiavi cache per utilizzare i cookie denominati

Queste istruzioni impostano le chiavi cache di Cloud CDN per l'utilizzo dei cookie HTTP.

Console

La console Google Cloud non è supportata per questa funzionalità.

gcloud

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-named-cookie=[NAMED_COOKIE,...]

Passaggi successivi