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 in /images/file.jpg è stato memorizzato nella cache e deve essere invalidato, puoi utilizzare diversi metodi per invalidarlo, a seconda che tu voglia influire solo su quel file o su un ambito più ampio. In ogni caso, puoi invalidare la proprietà per tutti i nomi host o per un solo 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 per eseguire le invalidazioni.

Puoi accedere a Google Cloud CLI in due modi:

Installa Google Cloud CLI seguendo le istruzioni in Installazione con apt-get. Se non hai già utilizzato Google Cloud CLI, esegui prima gcloud init per l'autenticazione.
Utilizza Cloud Shell, che viene fornito con gcloud già installato.

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 guida rapida di IAM.

Nota: se utilizzi un bilanciatore del carico delle applicazioni esterno globale con riferimento al servizio tra progetti 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 nel progetto che ha la regola di forwarding, il proxy di destinazione e la mappa URL del bilanciatore del carico. Gli amministratori dei servizi che controllano il provisioning dei servizi di backend in un progetto separato possono collaborare con l'amministratore del bilanciatore del carico del progetto di frontend per emettere l'annullamento della convalida della cache per i loro servizi tra progetti. Per le riscrittura degli URL, assicurati che l'annullamento della convalida corrisponda all'host di pre-riscrittura e al percorso inviati dal client.

Annullare la convalida di un solo file

Console

Nella console Google Cloud, vai alla pagina Cloud CDN.
Vai alla pagina di Cloud CDN
In Bilanciatori del carico associati, fai clic sul nome del bilanciatore del carico.
Fai clic sulla scheda Convalida della cache.
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 all'interno del percorso (ad esempio: example.com/images/file.jpg).
Fai clic su Annulla validità.

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 quello della mappa URL coincidono.

Sostituisci LOAD_BALANCER_NAME con il nome del bilanciatore del carico. Per elencare i bilanciatori del carico, utilizza il comando gcloud compute url-maps list.

(Facoltativo) Per rendere nulla la validità di 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. Per eseguire l'annullamento della convalida in background, aggiungi --async alla riga di comando.

Annulla l'intera directory

Console

Nella console Google Cloud, vai alla pagina Cloud CDN.
Vai alla pagina di Cloud CDN
In Bilanciatori del carico associati, fai clic sul nome del bilanciatore del carico.
Fai clic sulla scheda Convalida della cache.
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/*).
Fai clic su Annulla validità.

gcloud

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

Sostituisci LOAD_BALANCER_NAME con il nome del bilanciatore del carico. Per elencare i bilanciatori del carico, utilizza il comando gcloud compute url-maps list.

(Facoltativo) Per rendere nulla la validità di 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. Per eseguire l'annullamento della convalida in background, aggiungi --async alla riga di comando.

Annulla tutto

Console

Nella console Google Cloud, vai alla pagina Cloud CDN.
Vai alla pagina di Cloud CDN
In Bilanciatori del carico associati, fai clic sul nome del bilanciatore del carico.
Fai clic sulla scheda Convalida della cache.
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/*).
Fai clic su Annulla validità.

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 rendere nulla la validità di 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. Per eseguire l'annullamento della convalida in background, aggiungi --async alla riga di comando.

Passaggi successivi

Per verificare se Cloud CDN sta fornendo risposte dalla cache, consulta Visualizzazione dei log.
Per informazioni su quali contenuti possono essere memorizzati nella cache o meno, consulta Panoramica della memorizzazione nella cache.