Controlar o comportamento de cache da Rede de Entrega de Conteúdo do Azure com regras de cache
Importante
O Azure CDN Standard da Microsoft (clássico) será desativado em 30 de setembro de 2027. Para evitar qualquer interrupção do serviço, é importante migrar o Azure CDN Standard dos perfis Microsoft (clássicos) para o Azure Front Door Standard ou Premium até 30 de setembro de 2027. Para obter mais informações, consulte Azure CDN Standard da aposentadoria (clássica) da Microsoft.
A CDN do Azure de Edgio será aposentada em 15 de janeiro de 2025. Você deve migrar sua carga de trabalho para o Azure Front Door antes dessa data para evitar a interrupção do serviço. Para obter mais informações, consulte CDN do Azure das Perguntas frequentes sobre aposentadoria do Edgio.
Este artigo descreve como você pode usar regras de cache de rede de entrega de conteúdo para definir ou modificar o comportamento de expiração de cache padrão. Essas regras de cache podem ser globais ou com condições personalizadas, como um caminho de URL e uma extensão de arquivo.
Nota
As regras de cache estão disponíveis apenas para o Azure CDN Standard a partir de perfis Edgio . Para a CDN do Azure a partir de perfis da Microsoft, tem de utilizar o motor de regras Standard Para a CDN Premium do Azure a partir de perfis Edgio, tem de utilizar o motor de regras Edgio Premium no portal Gerir para uma funcionalidade semelhante.
A Rede de Entrega de Conteúdo do Azure oferece duas maneiras de controlar como seus arquivos são armazenados em cache:
Regras de cache: a Rede de Entrega de Conteúdo do Azure fornece dois tipos de regras de cache: global e personalizada.
Regras de cache global - Você pode definir uma regra de cache global para cada ponto de extremidade em seu perfil, o que afeta todas as solicitações para o ponto de extremidade. A regra global de colocação em cache substitui quaisquer cabeçalhos de diretivas de cache HTTP, se for definido algum.
Regras de cache personalizadas - Você pode definir uma ou mais regras de cache personalizadas para cada ponto de extremidade em seu perfil. As regras de cache personalizadas correspondem a caminhos e extensões de arquivo específicos, são processadas em ordem e substituem a regra de cache global, se definida.
Cache de cadeia de caracteres de consulta: você pode ajustar como a rede de entrega de conteúdo do Azure trata o cache para solicitações com cadeias de caracteres de consulta. Para obter informações, consulte Controlar o comportamento de cache da Rede de Entrega de Conteúdo do Azure com cadeias de caracteres de consulta. Se o arquivo não puder ser armazenado em cache, a configuração de cache da cadeia de caracteres de consulta não terá efeito, com base nas regras de cache e nos comportamentos padrão da rede de entrega de conteúdo.
Para obter informações sobre o comportamento de cache padrão e cabeçalhos de diretiva de cache, consulte Como o cache funciona.
Acessando regras de cache da Rede de Entrega de Conteúdo do Azure
Abra o portal do Azure, selecione um perfil de rede de entrega de conteúdo e, em seguida, selecione um ponto de extremidade.
No painel esquerdo, em Definições, selecione Regras de colocação em cache.
É apresentada a página Regras de colocação em cache.
Configurações de comportamento de cache
Para regras de cache globais e personalizadas, você pode especificar as seguintes configurações de comportamento de cache:
Ignorar cache: não armazene em cache e ignore cabeçalhos de diretiva de cache fornecidos pela origem.
Substituição: ignore a duração do cache fornecido pela origem; use a duração do cache fornecido em vez disso. Essa configuração não substitui o controle de cache: no-cache.
Nota
Para a CDN do Azure a partir de perfis da Microsoft , a substituição de expiração de cache só é aplicável aos códigos de status 200 e 206.
- Definir se faltar: Honrar cabeçalhos de diretiva de cache fornecidos pela origem, se existirem, caso contrário, use a duração do cache fornecida.
Duração da expiração do cache
Para regras de cache globais e personalizadas, você pode especificar a duração da expiração do cache em dias, horas, minutos e segundos:
Para as configurações de comportamento Substituir e Definir se faltar Cache, as durações válidas do cache variam entre 0 segundos e 366 dias. Por um valor de 0 segundos, a rede de entrega de conteúdo armazena o conteúdo em cache, mas deve revalidar cada solicitação com o servidor de origem.
Para a configuração Ignorar cache , a duração do cache é definida automaticamente como 0 segundos, o que não é um valor modificável.
As regras de cache personalizadas correspondem às condições
Para regras de cache personalizadas, duas condições de correspondência estão disponíveis:
Caminho: Esta condição corresponde ao caminho do URL, excluindo o nome de domínio, e suporta o símbolo curinga (*). Por exemplo, /myfile.html, /my/folder/**, e /my/images/.jpg. O comprimento máximo é de 260 caracteres.
Extensão: Esta condição corresponde à extensão de arquivo do arquivo solicitado. Você pode fornecer uma lista de extensões de arquivo separadas por vírgulas para corresponder. Por exemplo, .jpg, .mp3 ou .png. O número máximo de extensões é 50 e o número máximo de caracteres por extensão é 16.
Ordem de processamento de regras globais e personalizadas
As regras de cache globais e personalizadas são processadas na seguinte ordem:
As regras de cache global têm precedência sobre o comportamento padrão de cache da rede de entrega de conteúdo (configurações de cabeçalho de diretiva de cache HTTP).
As regras de cache personalizadas têm precedência sobre as regras de cache global, onde se aplicam. As regras de cache personalizadas são processadas em ordem de cima para baixo. Ou seja, se um pedido corresponder a ambas as condições, as regras na parte inferior da lista têm precedência sobre as regras no topo da lista. Portanto, você deve colocar regras mais específicas mais abaixo na lista.
Exemplo:
Regra de cache global:
- Comportamento de cache: Substituir
- Duração da expiração do cache: Um dia
Regra de cache personalizada #1:
- Condição de correspondência: Caminho
- Valor da correspondência: /home/*
- Comportamento de cache: Substituir
- Duração da expiração do cache: dois dias
Regra de cache personalizada #2:
- Condição de jogo: Extensão
- Valor da correspondência: .html
- Comportamento de cache: definir se estiver ausente
- Duração da expiração do cache: três dias
Quando você define essas regras, uma solicitação para <nome> de host do ponto de extremidade.azureedge.net/home/index.html aciona a regra de cache personalizada #2, que é definida como: Definir se faltar e 3 dias. Portanto, se o arquivo index.html tiver Cache-Control
Expires
cabeçalhos HTTP, eles serão honrados, caso contrário, se você não definir esses cabeçalhos, o arquivo ficará armazenado em cache por três dias.
Nota
Os arquivos armazenados em cache antes de uma alteração de regra mantêm sua configuração de duração do cache de origem. Para redefinir as durações do cache, você deve limpar o arquivo.
As alterações de configuração da Rede de Entrega de Conteúdo do Azure podem levar algum tempo para se propagar pela rede:
- Para o Azure CDN Standard a partir de perfis Edgio , a propagação geralmente é concluída em 10 minutos.
Consulte também
- How caching works (Como funciona a colocação em cache)
- Tutorial: Definir regras de cache da Rede de Entrega de Conteúdo do Azure