Annullamento dei contenuti inseriti nella cache

Questa pagina descrive come annullare la convalida dei 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 farlo, a seconda che tu voglia influire solo su quel file o su un ambito più ampio. In ogni caso, puoi annullare la convalida per tutti i nomi host o per un solo nome host.

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

Prima di iniziare

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

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 mai utilizzato Google Cloud CLI, esegui prima gcloud init per autenticarti.

  • Utilizza Cloud Shell, che include gcloud già installato.

Per creare un ruolo personalizzato con le autorizzazioni richieste, consulta Creare e gestire i ruoli personalizzati.

Per aggiungere un ruolo predefinito, utilizza la guida introduttiva IAM.

Annullare la convalida di un solo file

Console

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

    Vai a Cloud CDN

  2. Fai clic su un'origine.

  3. Fai clic sulla scheda Invalidazione della cache.

  4. In Bilanciatori del carico associati, seleziona il bilanciatore del carico.

  5. In Specifica gli oggetti di cui annullare la convalida:

    • Per Host, specifica un nome host, a meno che tu non voglia invalidare il percorso per tutti i nomi host.
    • In Percorso, specifica il percorso e il nome del file, ad esempio /images/file.jpg.

  6. Fai clic su Invalida.

gcloud

Utilizza il comando gcloud compute url-maps invalidate-cdn-cache.

Per specificare un solo file da invalidare, utilizza il flag --path con il nome del file.

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

Sostituisci URL_MAP_NAME con il nome della mappa di URL. Per elencare le mappe URL, utilizza il comando gcloud compute url-maps list.

Per annullare l'autenticazione per un solo host, aggiungi il flag --host, ad esempio --host host1.com.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host host1.com \
    --path "/images/file.jpg"

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

API

Utilizza il metodo urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Sostituisci quanto segue:

  • PROJECT_ID: il tuo Google Cloud ID progetto della console
  • URL_MAP_NAME: il nome della mappa URL

Per specificare un file da invalidare, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "path": "/images/file.jpg"
}

Per invalidare il file per un solo host, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "host": "host1.com",
  "path": "/images/file.jpg"
}

Annullare l'intera directory

Console

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

    Vai a Cloud CDN

  2. Fai clic su un'origine.

  3. Fai clic sulla scheda Invalidazione della cache.

  4. In Bilanciatori del carico associati, seleziona il bilanciatore del carico.

  5. In Specifica gli oggetti di cui annullare la convalida:

    • Per Host, specifica un nome host, a meno che tu non voglia invalidare il percorso per tutti i nomi host.
    • Per Percorso, specifica il percorso e un asterisco come carattere jolly, ad esempio /images/*.

  6. Fai clic su Invalida.

gcloud

Utilizza il comando gcloud compute url-maps invalidate-cdn-cache.

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

Sostituisci URL_MAP_NAME con il nome della mappa di URL.

Per annullare l'autenticazione per un solo host, aggiungi il flag --host, ad esempio --host host1.com.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host host1.com \
    --path "/images/*"

API

Utilizza il metodo urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Sostituisci quanto segue:

  • PROJECT_ID: il tuo Google Cloud ID progetto della console
  • URL_MAP_NAME: il nome della mappa URL

Per specificare una directory da invalidare, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "path": "/images/*"
}

Per invalidare una directory solo per un host, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "host": "host1.com",
  "path": "/images/*"
}

Annullamento convalida per tag della cache

Console

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

    Vai a Cloud CDN

  2. Fai clic su un'origine.

  3. Fai clic sulla scheda Invalidazione della cache.

  4. In Bilanciatori del carico associati, seleziona il bilanciatore del carico.

  5. In Specifica gli oggetti di cui annullare la convalida, in Tag della cache, specifica uno o più tag da invalidare. Utilizza spazi o virgole per separare i tag.

  6. Fai clic su Invalida.

gcloud

Utilizza il comando gcloud beta compute url-maps invalidate-cdn-cache.

gcloud beta compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --tags=TAGS

Sostituisci quanto segue:

  • URL_MAP_NAME: il nome della mappa URL
  • TAGS: un tag o un elenco di tag separati da virgole. In alternativa, puoi specificare questo flag fino a 10 volte

Ad esempio, se la risposta del backend include un'intestazione Cache-Tag con un ID utente opaco, ad esempio un UUID4 o un'altra forma di GUID, puoi invalidare tutti i contenuti per un utente specifico utilizzando il flag tag. Inoltre, per invalidare i contenuti per un solo host, ad esempio per il tuo ambiente di staging, aggiungi il flag --host.

gcloud beta compute url-maps invalidate-cdn-cache url_map_1 \
    --tags="1115b8f4-f804-4861-9629-8cb9aecdeeb3" \
    --host="host1.com"

API

Utilizza il metodo urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Sostituisci quanto segue:

  • PROJECT_ID: il tuo Google Cloud ID progetto della console
  • URL_MAP_NAME: il nome della mappa URL

Per specificare i tag cache per l'invalidazione, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "cacheTags": [
    "tag1",
    "tag2"
  ]
}

Puoi specificare un singolo tag o un elenco di tag separati da virgole.

Per annullare l'aggiornamento in base ai tag cache per un solo host, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "host": "host1.com",
  "path": "tag1,tag2"
}

Invalida tutto

Sebbene tu possa invalidare tutto, questa operazione è potenzialmente rischiosa. Valuta attentamente i requisiti prima di procedere.

Console

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

    Vai a Cloud CDN

  2. Fai clic su un'origine.

  3. Fai clic sulla scheda Invalidazione della cache.

  4. In Bilanciatori del carico associati, seleziona il bilanciatore del carico.

  5. In Specifica gli oggetti di cui annullare la convalida:

    • Per Host, specifica un nome host, a meno che tu non voglia invalidare il percorso per tutti i nomi host.
    • Per Percorso, utilizza un asterisco, ad esempio /*.

  6. Fai clic su Annulla convalida e poi su Conferma per indicare che vuoi che Cloud CDN annulli la convalida di tutti gli elementi.

gcloud

Utilizza il comando gcloud compute url-maps invalidate-cdn-cache.

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

Sostituisci quanto segue:

  • URL_MAP_NAME: il nome della mappa URL
  • /*: il percorso dell'URL che vuoi invalidare; non include il nome host; il percorso può utilizzare un nome file esplicito o un asterisco come carattere jolly

Per annullare l'autenticazione per un solo host, aggiungi il flag --host, ad esempio --host host1.com.

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host host1.com \
    --path "/*"

API

Utilizza il metodo urlMaps.invalidateCache.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/urlMaps/URL_MAP_NAME/invalidateCache

Sostituisci quanto segue:

  • PROJECT_ID: il tuo Google Cloud ID progetto della console
  • URL_MAP_NAME: il nome della mappa URL

Per specificare un percorso dell'URL per l'invalidazione, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "path": "/*"
}

Per invalidare il percorso dell'URL per un solo host, utilizza il seguente corpo della richiesta JSON di esempio:

{
  "host": "host1.com",
  "path": "/*"
}

Visualizzare lo stato della richiesta di annullamento

Cloud CDN emette due righe di log per annullamento della convalida, una quando l'annullamento della convalida viene accettato e l'altra quando è completato. Il primo contiene le informazioni sull'host e sul percorso.

Per visualizzare lo stato della tua richiesta di annullamento della convalida o trovare un elenco definitivo delle richieste inviate di recente, puoi utilizzare Cloud Logging o Cloud Monitoring.

Console

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

    Vai a Cloud CDN

  2. Fai clic su un'origine.

  3. Fai clic sulla scheda Invalidazione della cache.

  4. Per visualizzare lo stato e i risultati della richiesta di annullamento della convalida, fai clic su Vai a Cloud Logging.

gcloud

Di seguito è riportato un comando di esempio che utilizza il logging:

gcloud logging read 'protoPayload.methodName="v1.compute.urlMaps.invalidateCache"' \
    --limit=10

Di seguito è riportata una query di esempio che utilizza il monitoraggio:

protoPayload.serviceName="compute.googleapis.com"
protoPayload.methodName="v1.compute.urlMaps.invalidateCache"

Passaggi successivi