Gestire la scadenza del contenuto Web nella rete per la distribuzione di contenuti di Azure

Articolo
10/01/2024

Importante

Rete CDN di Azure Standard di Microsoft (versione classica) verrà ritirato il 30 settembre 2027. Per evitare interruzioni del servizio, è importante eseguire la migrazione dei profili di Rete CDN di Azure Standard di Microsoft (versione classica) al livello Frontdoor di Azure Standard o Premium entro il 30 settembre 2027. Per altre informazioni, vedere Ritiro di Rete CDN di Azure Standard di Microsoft (versione classica).

Rete CDN di Azure di Edgio verrà ritirato 4 novembre 2025. È necessario eseguire la migrazione del carico di lavoro in Frontdoor di Azure prima di questa data per evitare interruzioni del servizio. Per altre informazioni, vedere Rete CDN di Azure da Domande frequenti sul ritiro di Edgio.

I file dai server Web di origine accessibili pubblicamente possono essere memorizzati nella cache nella rete per la distribuzione di contenuti di Azure fino al termine del tempo di durata (TTL). Il tempo di durata (TTL) viene determinato dall'intestazione Cache-Control nella risposta HTTP dal server di origine. Questo articolo descrive come impostare le intestazioni Cache-Control per la funzionalità App Web di Servizio app di Microsoft Azure, Servizi cloud di Azure, applicazioni ASP.NET e siti Internet Information Services (IIS), che hanno tutti una configurazione simile. È possibile impostare l'intestazione Cache-Control usando i file di configurazione o a livello di codice.

È inoltre possibile controllare le impostazioni della cache dal portale di Azure mediante l'impostazione delle regole di memorizzazione nella cache della rete per la distribuzione di contenuti. Se si creano una o più regole di memorizzazione nella cache e si imposta il relativo comportamento su Ignora o Ignora cache, le impostazioni di memorizzazione nella cache fornite in origine e descritte in questo articolo vengono ignorate. Per informazioni sui concetti generali sulla memorizzazione nella cache, vedere Come funziona la memorizzazione nella cache.

Suggerimento

È possibile scegliere di non impostare alcuna durata (TTL) per un file. In questo caso, la rete per la distribuzione di contenuti di Azure applica automaticamente una durata (TTL) predefinita di sette giorni, a meno che non siano state configurate le regole di memorizzazione nella cache nel portale di Azure. Questa impostazione predefinita di durata (TTL) si applica solo alle ottimizzazioni di distribuzione web generali. Per le ottimizzazioni di file di grandi dimensioni, il valore TTL predefinito è un giorno e per le ottimizzazioni dei flussi dei file multimediali, il valore TTL predefinito è un anno.

Per altre informazioni sull'uso della rete per la distribuzione di contenuti di Azure per velocizzare l'accesso a file e altre risorse, vedere Panoramica della rete per la distribuzione di contenuti (rete CDN) di Azure.

Impostazione delle intestazioni di Controllo cache tramite le regole di memorizzazione nella cache della rete per la distribuzione di contenuti

Il metodo preferito per la configurazione dell'intestazione Cache-Control di un server Web consiste nell'usare le regole di memorizzazione nella cache nel portale di Azure. Per altre informazioni sulle regole di memorizzazione nella cache della rete per la distribuzione di contenuti, vedere Controllare il comportamento di memorizzazione nella cache della rete per la distribuzione di contenuti con regole di memorizzazione nella cache.

Nota

Le regole di memorizzazione nella cache sono disponibili solo per i profili Rete CDN di Azure Standard dai profili Edgio. Per Rete CDN di Azure Premium da profili di Edgio, è necessario usare il motore regole della rete per la distribuzione di contenuti di Azure nel portale di gestione per funzionalità simili.

Per passare alla pagina delle regole di memorizzazione nella cache della rete CDN:

Nel portale di Azure selezionare un profilo della rete per la distribuzione di contenuti, quindi selezionare l'endpoint per il server Web.
In Impostazioni nel riquadro sinistro selezionare Regole di memorizzazione nella cache.

Viene visualizzata la pagina Regole di memorizzazione nella cache.

Per configurare le intestazioni Cache-Control di un server Web tramite regole di memorizzazione nella cache globali:

In Regole di memorizzazione nella cache globali, impostare Comportamento di memorizzazione nella cache della stringa di query su Ignora stringhe di query e impostare Comportamento di memorizzazione nella cache su Ignora.
Per Durata scadenza cache immettere 3600 nella casella Secondi o 1 nella casella Ore.

Questa regola di memorizzazione nella cache globale imposta una durata di un'ora per la cache e influisce su tutte le richieste per l'endpoint. Esegue l'override di qualsiasi intestazione HTTP Cache-Control o Expires inviata dal server di origine specificato dall'endpoint.
Seleziona Salva.

Per configurare le intestazioni Cache-Control di un server Web tramite regole di memorizzazione nella cache personalizzate:

In Regole di memorizzazione nella cache personalizzate creare due condizioni di corrispondenza:
1. Per la prima condizione di corrispondenza impostare Condizione di corrispondenza su Percorso e immettere /webfolder1/* per Valori di corrispondenza. Impostare Comportamento di memorizzazione nella cache su Override e immettere 4 nella casella Giorni.
2. Per la seconda condizione di corrispondenza impostare Condizione di corrispondenza su Percorso e immettere /webfolder1/file1.txt per Valori di corrispondenza. Impostare Comportamento di memorizzazione nella cache su Override e immettere 2 nella casella Giorni.
La prima regola di memorizzazione nella cache personalizzata imposta una durata della cache di quattro giorni per qualsiasi file nella cartella /webfolder1 nel server di origine specificato dall'endpoint. La seconda regola esegue l'override della prima regola solo per il file file1.txt e imposta una durata della cache di due giorni per tale file.
Seleziona Salva.

Impostazione delle intestazioni Cache-Control tramite dei file di configurazione

Per il contenuto statico, come immagini e fogli di stile, è possibile controllare la frequenza di aggiornamento modificando i file di configurazione applicationHost.config o Web.config per l'applicazione Web. Per impostare l'intestazione Cache-Control per il contenuto, usare l'elemento <system.webServer>/<staticContent>/<clientCache> in qualsiasi file.

Uso dei file Applicationhost.config

Il file ApplicationHost.config è il file radice del sistema di configurazione IIS. Le impostazioni di configurazione nel file ApplicationHost.config interessano tutte le applicazioni nel sito, ma se ne esegue l'override usando le impostazioni di qualsiasi altro file Web.config esistente per un'applicazione web.

Uso dei file Web.config

Con un file Web.config, è possibile personalizzare il comportamento dell'applicazione web intera o di una directory specifica sull'applicazione web. In genere, si ha almeno un file Web.config nella cartella radice dell'applicazione web. Per ciascun file Web.config in una cartella specifica, le impostazioni di configurazione influiscono su qualsiasi elemento presente nella cartella e in tutte le sottocartelle, a meno di non eseguirne l'override a livello di sottocartella da un altro file Web.config.

Ad esempio, è possibile impostare un elemento <clientCache> in un file Web.config nella cartella radice dell'applicazione web per memorizzare nella cache qualsiasi contenuto statico sull'applicazione web per tre giorni. È anche possibile aggiungere un file Web.config in una sottocartella con contenuto più variabile (ad esempio, \frequent) e impostare il relativo elemento <clientCache> per memorizzare nella cache il contenuto della sottocartella per sei ore. Il risultato è che il contenuto nell'intero sito Web è memorizzato nella cache per tre giorni, ad eccezione di qualsiasi contenuto nella directory \frequent, che verrà memorizzato nella cache solo per sei ore.

L'esempio di file di configurazione XML seguente mostra come impostare l'elemento <clientCache> per specificare una durata massima di tre giorni:

<configuration>
    <system.webServer>
        <staticContent>
            <clientCache cacheControlMode="UseMaxAge" cacheControlMaxAge="3.00:00:00" />
        </staticContent>
    </system.webServer>
</configuration>

Per usare l'attributo cacheControlMaxAge, è necessario impostare il valore dell'attributo cacheControlMode su UseMaxAge. Questa impostazione ha fatto sì che l'intestazione HTTP e la direttiva, Cache-Control: max-age=<nnn>, fossero aggiunte alla risposta. Il formato del valore dell'intervallo di tempo per l'attributo cacheControlMaxAge è <days>.<hours>:<min>:<sec>. Il valore viene convertito in secondi e viene usato come il valore della direttiva Cache-Control max-age. Per altre informazioni sull'elemento <clientCache>, vedere Cache client<clientCache>.

Impostazione delle intestazioni Cache-Control a livello di programmazione

Per le applicazioni ASP.NET, gestire a livello di codice il comportamento di memorizzazione nella cache della rete per la distribuzione dei contenuti impostando la proprietà HttpResponse.Cache dell'API.NET. Per informazioni sulla proprietà HttpResponse.Cache, vedere Proprietà HttpResponse.Cache e Classe HttpCachePolicy.

Per memorizzare nella cache il contenuto dell'applicazione in ASP.NET a livello di codice, eseguire la procedura seguente:

Verificare che il contenuto sia contrassegnato come memorizzabile nella cache impostando HttpCacheability su Public.
Impostare un validator della cache chiamando uno dei metodi HttpCachePolicy seguenti:
- Chiamare SetLastModified per impostare un valore di timestamp per l'intestazioneLast-Modified.
- Chiamare SetETag per impostare un valore per l'intestazioneETag.
Facoltativamente, specificare un'ora di scadenza della cache chiamando SetExpires per impostare un valore dell'intestazione Expires. In caso contrario, si applica l'euristica predefinita della cache descritta in precedenza in questo documento.

Ad esempio, per memorizzare nella cache il contenuto per un'ora, aggiungere il codice C# seguente:

// Set the caching parameters.
Response.Cache.SetExpires(DateTime.Now.AddHours(1));
Response.Cache.SetCacheability(HttpCacheability.Public);
Response.Cache.SetLastModified(DateTime.Now);

Test dell'intestazione Cache-Control

È possibile verificare facilmente le impostazioni di durata (TTL) del contenuto web. Con gli strumenti di sviluppo del browser verificare che il contenuto web includa l'intestazione della risposta Cache-Control. È anche possibile usare uno strumento come wget o Fiddler per esaminare le intestazioni di risposta.

Condividi tramite