Questa pagina spiega come personalizzare le chiavi cache di Cloud CDN.
La modifica della configurazione della chiave cache potrebbe comportare un calo improvviso del rapporto di hit della cache se le nuove richieste iniziano a utilizzare chiavi cache diverse dalle precedenti voci di chiavi cache. Analogamente, la modifica dell'autore della chiave cache non rende necessariamente le voci memorizzate nella cache se le nuove richieste utilizzano la stessa chiave delle vecchie chiavi cache. Per invalidare le voci memorizzate nella cache esistenti, consulta la pagina Annullamento dei contenuti memorizzati nella cache.
Prima di iniziare
Questa pagina presuppone una conoscenza di Cloud CDN, delle chiavi cache di Cloud CDN e dei servizi di backend con bilanciamento del carico. Ti consigliamo di rivedere queste pagine prima di procedere.
Attivazione di Cloud CDN e personalizzazione delle chiavi cache
Queste istruzioni attivano Cloud CDN per un servizio o un bucket di backend con bilanciamento del carico e personalizzano la chiave cache escludendo uno o più componenti. Se non disponi già di un bilanciatore del carico da utilizzare come origine, consulta la documentazione del bilanciatore del carico delle applicazioni esterno per istruzioni su come crearne uno.
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 cui vuoi abilitare la CDN.
Nella riga dell'origine, fai clic su Configura.
Se Cloud CDN è già abilitato su questa origine, fai clic sul menu , seleziona Modifica, quindi fai clic su Configura.
Deseleziona le caselle di controllo relative ai campi che vuoi omettere dalla chiave cache per questo servizio di backend.
Fai clic su Salva.
Fai clic su Aggiungi.
gcloud
Specifica uno o più flag facoltativi per escludere il parametro dalle chiavi cache per questo servizio di backend o bucket di backend.
gcloud compute backend-services update BACKEND_SERVICE \
--enable-cdn
gcloud compute backend-buckets update BACKEND_BUCKET \
--enable-cdn
Flag facoltativi:
--no-cache-key-include-protocol--no-cache-key-include-host--no-cache-key-include-query-string
Aggiornamento delle chiavi cache per aggiungere di nuovo il protocollo, l'host e la stringa di query
Per impostazione predefinita, i servizi di backend configurati per l'utilizzo di Cloud CDN includono tutti i componenti dell'URI della richiesta nelle chiavi cache. Se in precedenza hai indicato che uno o più componenti devono essere esclusi, puoi seguire la procedura seguente per includerli di nuovo.
Queste istruzioni consentono di aggiungere nuovamente il protocollo, l'host e la stringa di query alla chiave cache per un servizio di backend esistente in cui CDN è già abilitata.
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 che vuoi modificare, fai clic su Configura.
- In Chiave cache, seleziona 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. I flag non specificati non vengono modificati.
gcloud compute backend-services update BACKEND_SERVICE \
--cache-key-include-protocol \
--cache-key-include-host \
--cache-key-include-query-string
gcloud compute backend-buckets update BACKEND_BUCKET \
--cache-key-include-query-string
Aggiornamento delle chiavi cache per utilizzare un elenco di inclusione o esclusione di stringhe di query
Queste istruzioni impostano le chiavi cache CDN in modo che utilizzino un elenco di inclusione o di esclusione con 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 Chiave cache, seleziona 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 cache, seleziona Includi solo i parametri selezionati.
Se vuoi specificare che tutti i parametri della stringa di query tranne quelli elencati sono inclusi nella chiave cache, seleziona Includi tutti tranne quelli selezionati.
Inserisci l'elenco di stringhe separate da virgole nel campo Parametri stringa di query.
Fai clic su Salva.
Fai clic su Aggiorna.
gcloud
Utilizza questo comando per impostare la stringa user in modo che sia l'elenco di inclusione.
gcloud compute backend-services update BACKEND_SERVICE \
--cache-key-include-query-string \
--cache-key-query-string-whitelist user
Utilizza questo comando per aggiungere la stringa user a un elenco di esclusione.
gcloud compute backend-services update BACKEND_SERVICE \
--cache-key-include-query-string \
--cache-key-query-string-blacklist user
Aggiornamento delle chiavi cache per l'utilizzo delle intestazioni HTTP
Queste istruzioni impostano le chiavi cache di Cloud CDN in modo che utilizzino le intestazioni HTTP.
Console
La console Google Cloud non è attualmente 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,...]
Aggiornamento delle chiavi cache per l'utilizzo di cookie denominati
Queste istruzioni impostano le chiavi cache di Cloud CDN in modo che utilizzino i cookie HTTP.
Console
La console Google Cloud non è attualmente 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 sta fornendo risposte dalla cache, consulta Visualizzazione dei log.