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 essere invalidato, puoi utilizzare diversi metodi per invalidarlo, a seconda che desideri 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

Per eseguire le invalidazioni, puoi utilizzare Google Cloud CLI o la console Google Cloud.

Puoi accedere a Google Cloud CLI in due modi:

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

• Utilizza Cloud Shell, che è già installato con gcloud.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, ti devono essere concesse le seguenti autorizzazioni o i 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 guida rapida di IAM.

Nota: se utilizzi un bilanciatore del carico delle applicazioni esterno globale con riferimento ai servizi tra progetti con VPC condiviso, per impostazione predefinita gli amministratori dei progetti di servizio non avranno le autorizzazioni necessarie per richiedere le invalidazioni della cache. Questo perché l'annullamento della convalida della cache è configurato nel progetto frontend (ovvero il progetto che ha la regola di forwarding, il proxy di destinazione e la 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'annullamento della convalida della cache per i loro servizi tra progetti. Per le riscritture degli URL, assicurati che l'annullamento della convalida corrisponda 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 Annullamento convalida cache.
4. Inserisci il percorso del file.
   • Se vuoi invalidare un percorso per tutti i nomi host, inserisci solo il percorso (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 bilanciatore del carico. Per elencare i bilanciatori del carico, utilizza il comando gcloud compute url-maps list.

(Facoltativo) Per invalidare 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'annullamento della convalida. Per eseguire l'annullamento della convalida 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 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 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 bilanciatore del carico. Per elencare i bilanciatori del carico, utilizza il comando gcloud compute url-maps list.

(Facoltativo) Per invalidare 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 il completamento dell'annullamento della convalida. Per eseguire l'annullamento della convalida 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 /* nel 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 invalidare 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'annullamento della convalida. Per eseguire l'annullamento della convalida 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 non memorizzati nella cache, consulta Panoramica della memorizzazione nella cache.