Questa pagina spiega come personalizzare le chiavi della cache Cloud CDN.
La modifica della configurazione della chiave della cache potrebbe comportare un calo improvviso del rapporto di hit della cache se le nuove richieste iniziano a utilizzare chiavi della cache diverse dalle voci delle vecchie chiavi della 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 Annullamento convalida dei contenuti inseriti nella cache.
Prima di iniziare
Questa pagina presuppone la conoscenza di Cloud CDN, delle chiavi della cache di Cloud CDN e dei servizi di backend con bilanciamento del carico. Ti consigliamo di esaminare queste pagine prima di procedere.
Attiva Cloud CDN e personalizza le chiavi della 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 la documentazione del bilanciatore del carico delle applicazioni esterno per istruzioni su come crearne uno.
I bucket di backend non includono il protocollo o l'host nella chiave della cache perché non influiscono sulla modalità di riferimento agli oggetti all'interno di un bucket Cloud Storage. 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
- Nella console Google Cloud, vai alla pagina Cloud CDN.
- Fai clic su Aggiungi origine.
- Nel menu a discesa Origine, fai clic su Seleziona origine.
- Seleziona l'origine per la quale vuoi attivare la CDN.
Nella riga dell'origine, fai clic su Configura.
Se Cloud CDN è già attivato per questa origine, fai prima clic sul menu , seleziona Modifica e poi Configura.
Deseleziona le caselle di controllo per i campi che vuoi omettere dalla chiave della cache per questo servizio di backend.
Fai clic su Salva.
Fai clic su Aggiungi.
gcloud
Specifica uno o più flag facoltativi per escludere il componente dalle chiavi della 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 della 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 hai indicato che uno o più componenti devono essere esclusi, puoi seguire i passaggi riportati di seguito per includerli di nuovo.
Queste istruzioni aggiungono nuovamente il protocollo, l'host e la stringa di query alla chiave della cache per un servizio di backend esistente in cui è già attivato Cloud CDN.
Console
- Nella console Google Cloud, vai alla pagina Cloud CDN.
- Nella riga del bilanciatore del carico, fai clic su Menu e poi su Modifica.
- Nella riga del servizio di backend o del bucket di backend da modificare, fai clic su Configura.
- In Cache key (Chiave cache), seleziona Custom (Personalizzata).
- Seleziona le caselle di controllo Protocollo, Host e Stringa di query.
- Lascia vuoto il campo Parametri stringa di query.
- Fai clic su Salva.
- Fai clic su Aggiorna.
gcloud
Per aggiungere nuovamente un solo componente, specifica solo il flag. Eventuali flag non specificati rimangono invariati.
gcloud compute backend-services update BACKEND_SERVICE \
--cache-key-include-protocol \
--cache-key-include-host \
--cache-key-include-query-string
Aggiorna le chiavi cache per utilizzare un elenco di inclusione o esclusione dei parametri delle stringhe di query
Queste istruzioni impostano le chiavi della cache Cloud CDN in modo da utilizzare un elenco di inclusione o un elenco di esclusione con i parametri della stringa di query.
Console
- Nella console Google Cloud, vai alla pagina Cloud CDN.
- Nella riga del bilanciatore del carico, fai clic su Menu e poi su Modifica.
- Nella riga del servizio di backend che vuoi modificare, fai clic su Configura.
- In Cache key (Chiave cache), seleziona Custom (Personalizzata).
- Verifica che la casella di controllo Stringa di query sia selezionata.
Se vuoi specificare i parametri della stringa di query che devono far parte della chiave della cache, seleziona Includi solo i parametri selezionati.
Se vuoi specificare che tutti i parametri della stringa di query, tranne quelli elencati, devono essere inclusi nella chiave della cache, seleziona Includi tutto tranne i parametri selezionati.
Inserisci l'elenco di stringhe separate da virgole nel campo Parametri della stringa di query.
Fai clic su Salva.
Fai clic su Aggiorna.
gcloud
Utilizza questo comando per impostare il parametro della stringa di query user nell'elenco include 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 nell'elenco di 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 nell'elenco include 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 della cache 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 di cache per utilizzare i cookie denominati
Queste istruzioni impostano le chiavi della cache Cloud CDN in modo da utilizzare i 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
- Per verificare se Cloud CDN serve risposte dalla cache, consulta Log e metriche per la memorizzazione nella cache.