Annullamento dei contenuti inseriti nella cache

Questa pagina descrive come invalidare i contenuti memorizzati nella cache di Cloud CDN.

Ad esempio, se un file situato all'indirizzo /images/file.jpg è stato memorizzato nella cache e deve invalidato, puoi usare diversi metodi per invalidarlo, a seconda se vuoi influire solo su quel file o su un ambito più ampio. In ogni caso, puoi invalidare per tutti i nomi host o solo per un nome host.

Per scoprire di più sull'annullamento della convalida della cache, consulta Panoramica dell'annullamento della convalida della cache.

Prima di iniziare

Puoi utilizzare Google Cloud CLI o la console Google Cloud eseguire le invalidazioni.

Puoi accedere a Google Cloud CLI in due modi:

• Installa Google Cloud CLI seguendo le istruzioni all'indirizzo Installazione con apt-get. Se non hai utilizzato Google Cloud CLI in precedenza, esegui prima gcloud init per l'autenticazione.

• Utilizzare Cloud Shell. che è già installato con gcloud.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni o dei seguenti ruoli IAM.

Autorizzazioni

• compute.urlMaps.get
• compute.urlMaps.invalidateCache

Ruoli

• roles/compute.networkAdmin
• roles/compute.loadBalancerAdmin

Per creare un ruolo personalizzato con le autorizzazioni richieste, consulta Creazione e gestione di ruoli personalizzati.

Per aggiungere un ruolo predefinito, utilizza la IAM Guida rapida.

Nota: se utilizzi un bilanciatore del carico delle applicazioni esterno globale con VPC condiviso i riferimenti ai servizi tra progetti, predefinita, gli amministratori dei progetti di servizio non disporranno delle autorizzazioni necessarie per richiedere le invalidazioni della cache. Questo perché l'annullamento della convalida della cache è configurato nel progetto frontend (ovvero il progetto che include la regola di forwarding, proxy e una mappa URL del bilanciatore del carico). Gli amministratori di servizi che controllano il provisioning dei servizi di backend in un progetto separato possono collaborare con l'amministratore del bilanciatore del carico del progetto frontend per emettere l'invalidazione della cache per i propri servizi tra progetti. Per le riscritture degli URL, assicurati che l'annullamento della convalida corrisponde all'host e al percorso di pre-riscrittura inviati dal client.

Annulla la convalida di un solo file

Console

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

   Vai alla pagina di Cloud CDN

2. In Bilanciatori del carico associati, fai clic sul nome del bilanciatore del carico.
3. Fai clic sulla scheda Invalidazione della cache.
4. Inserisci il percorso del file.
   • Se vuoi invalidare un percorso per tutti i nomi host, inserisci solo il (ad esempio: /images/file.jpg).
   • Se vuoi invalidare un percorso per un solo nome host, specifica Il nome host come parte del percorso (ad esempio: example.com/images/file.jpg).
5. Fai clic su Annulla convalida.

gcloud

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --path "/images/file.jpg"

Il nome del bilanciatore del carico delle applicazioni esterno e il nome della mappa URL sono uguali.

Sostituisci LOAD_BALANCER_NAME con il nome del tuo con il bilanciatore del carico di rete passthrough esterno regionale. Per elencare i bilanciatori del carico, utilizza Comando gcloud compute url-maps list.

(Facoltativo) Per annullare l'autenticazione per un solo host, aggiungi il flag --host (--host example.com).

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --host HOSTNAME \
    --path "/images/file.jpg"

Per impostazione predefinita, Google Cloud CLI attende il completamento dell'invalidazione. Per eseguire l'annullamento in background, aggiungi --async alla riga di comando.

Rendi nulla l'intera directory

Console

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

   Vai alla pagina Cloud CDN

2. In Bilanciatori del carico associati, fai clic sul nome del bilanciatore del carico.
3. Fai clic sulla scheda Annullamento convalida cache.
4. Inserisci il percorso della directory e il carattere jolly (/path/to/file/*).
   • Se vuoi invalidare l'intera directory per tutti i nomi host, inserisci solo il percorso e il carattere jolly (ad esempio: /images/*).
   • Se vuoi invalidare l'intera directory per un solo nome host, specifica il nome host come parte del percorso (ad esempio: example.com/images/*).
5. Fai clic su Annulla convalida.

gcloud

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --path "/images/*"

Sostituisci LOAD_BALANCER_NAME con il nome del tuo con il bilanciatore del carico di rete passthrough esterno regionale. Per elencare i bilanciatori del carico, utilizza Comando gcloud compute url-maps list.

(Facoltativo) Per annullare l'autenticazione per un solo host, aggiungi il flag --host (--host example.com).

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --host HOSTNAME \
    --path "/images/*"

Per impostazione predefinita, Google Cloud CLI attende che l'annullamento della convalida completata. Per eseguire l'annullamento in background, aggiungi --async alla riga di comando.

Rendi nullo tutto

Console

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

   Vai alla pagina di Cloud CDN

2. In Bilanciatori del carico associati, fai clic sul nome del bilanciatore del carico.
3. Fai clic sulla scheda Annullamento convalida cache.
4. Inserisci solo la radice e il carattere jolly (/*).
   • Se vuoi invalidare tutto per tutti i nomi host, inserisci solo /* in campo.
   • Se vuoi invalidare tutto per un solo nome host, specifica il nome host come parte del percorso (ad esempio: example.com/*).
5. Fai clic su Annulla convalida.

gcloud

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --path "/*"

Sostituisci quanto segue:

• LOAD_BALANCER_NAME: il nome del bilanciatore del carico
• /*: il percorso dell'URL che vuoi invalidare. non include il nome host; il percorso può utilizzare un nome file esplicito o un carattere jolly

(Facoltativo) Per annullare l'autenticazione per un solo host, aggiungi il flag --host (--host example.com).

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --host HOSTNAME \
    --path "/*"

Per impostazione predefinita, Google Cloud CLI attende il completamento dell'invalidazione. Per eseguire l'annullamento in background, aggiungi --async alla riga di comando.

Passaggi successivi

• Per verificare se Cloud CDN fornisce risposte dalla cache, consulta Visualizzazione dei log.
• Per scoprire quali contenuti possono essere memorizzati o meno nella cache, consulta: Panoramica della memorizzazione nella cache.