Limpar a cache no Azure Front Door

Aplica-se a: ✔️ Front Door Standard ✔️ Front Door Premium

O Azure Front Door armazena em cache ativos até que seu tempo de vida útil (TTL) expire. Quando um cliente solicita um ativo com um TTL expirado, o Azure Front Door recupera e armazena em cache uma nova cópia do ativo para servir o pedido.

Para garantir que os usuários sempre obtenham os ativos mais recentes, faça a versão de seus ativos para cada atualização e publique-os com novas URLs. O Azure Front Door recupera então os novos ativos em pedidos subsequentes dos clientes.

Quando atualizar a sua aplicação ou precisar de remover rapidamente conteúdo incorreto, elimine o conteúdo em cache de todas as localizações de pontos de presença (PoP). Esta ação obriga o Azure Front Door a buscar conteúdo fresco da sua origem.

Pré-requisitos

  • Um perfil do Azure Front Door. Para obter mais informações, consulte Criar uma porta frontal do Azure.

  • Azure Cloud Shell ou Azure PowerShell.

    As etapas neste artigo executam os cmdlets do Azure PowerShell interativamente no Azure Cloud Shell. Para executar os cmdlets no Cloud Shell, selecione Open Cloud Shell no canto superior direito de um bloco de código. Selecione Copiar para copiar o código e cole-o no Cloud Shell para executá-lo. Você também pode executar o Cloud Shell de dentro do portal do Azure.

    Você também pode instalar o Azure PowerShell localmente para executar os cmdlets. Se executares o PowerShell localmente, inicia sessão em Azure usando o cmdlet Connect-AzAccount.

  • Um perfil do Azure Front Door. Para obter mais informações, consulte Criar uma porta frontal do Azure.

  • Azure Cloud Shell ou CLI do Azure.

    As etapas neste artigo executam os comandos da CLI do Azure interativamente no Azure Cloud Shell. Para executar os comandos no Cloud Shell, selecione Open Cloud Shell no canto superior direito de um bloco de código. Selecione Copiar para copiar o código e cole-o no Cloud Shell para executá-lo. Você também pode executar o Cloud Shell de dentro do portal do Azure.

    Também podes instalar CLI do Azure localmente para executar os comandos. Se executares CLI do Azure localmente, inicia sessão em Azure usando o comando az login.

Limpar a cache

  1. Aceda à página de descrição geral do seu perfil do Azure Front Door e selecione Limpar cache.

    Captura de ecrã do botão de purgar cache na página de visão geral.

  2. Escolhe um endpoint e depois seleciona o domínio ou subdomínio que queres eliminar dos Front Door POPs. Pode selecionar múltiplos domínios ou subdomínios.

    Captura de ecrã da página de purgar cache.

  3. Para limpar todos os assets, selecione Purgar todos os assets dos domínios selecionados. Caso contrário, introduza os Caminhos de cada recurso que quer eliminar.

Execute Clear-AzFrontDoorCdnEndpointContent para limpar a cache, especificando parâmetros como:

  • Nome do grupo de recursos.
  • Nome do perfil do Azure Front Door dentro do grupo de recursos.
  • Endpoints com recursos por eliminar.
  • Domínios e subdomínios com ativos para eliminar.
Clear-AzFrontDoorCdnEndpointContent `
    -ResourceGroupName myRGFD `
    -ProfileName contosoafd `
    -EndpointName myendpoint `
    -Domain www.contoso.com `
    -ContentPath /scripts/*

Execute o comando az afd endpoint purge com os parâmetros necessários para purgar a cache:

  • Nome do grupo de recursos
  • Nome do perfil Azure Front Door dentro do grupo de recursos
  • Endpoints com ativos para purgar
  • Domínios e subdomínios com ativos a purgar
az afd endpoint purge \
    --resource-group myRGFD \
    --profile-name contosoafd \
    --endpoint-name myendpoint \
    --domains www.contoso.com \
    --content-paths '/scripts/*'

Formatos de caminho suportados

  • Purga de caminho único: Eliminar um ativo especificando o seu caminho completo sem protocolo e domínio, incluindo extensão de ficheiro. Por exemplo, /pictures/strasbourg.png.
  • Limpeza do domínio raiz: Limpe a raiz do endpoint quando o caminho contém /*.

Important

A limpeza da cache para domínios com wildcard não é diretamente suportada. Especifique subdomínios para domínios wildcard. Por exemplo, para *.contoso.com, especifica subdomínios como dev.contoso.com ou test.contoso.com. Para obter mais informações, consulte Domínios curinga no Azure Front Door.

As purgas da cache no Azure Front Door não diferenciam maiúsculas de minúsculas e são independentes da cadeia de consulta. A purga de uma URL elimina todas as variações de sequência de consulta dessa URL.

Note

A purga do cache pode demorar até 10 minutos a propagar-se por todas as localizações POP do Azure Front Door.

Próximo passo