Limpeza de cache no Azure Front Door usando a CLI do Azure

O Azure Front Door armazena os ativos em cache até a vida útil (TTL) do ativo expirar. Quando um cliente solicita um ativo com um TTL expirado, o Azure Front Door recupera uma nova cópia do ativo, atende à solicitação e atualiza o cache.

Para garantir que os usuários sempre obtenham os ativos mais recentes, atualize seus ativos para cada atualização e publique-os com novas URLs. O Azure Front Door busca os novos ativos para solicitações de cliente subsequentes. Às vezes, pode ser necessário limpar o conteúdo armazenado em cache de todos os nós de borda para forçá-los a recuperar ativos atualizados. Essa ação é útil quando são feitas atualizações em seu aplicativo ou precisam corrigir informações incorretas.

Pré-requisitos

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

• Examine o Cache com o Azure Front Door para entender como funciona o cache.
• Verifique se você tem um perfil funcional do Azure Front Door. Consulte Criar um Azure Front Door – CLI para saber como criar um perfil.

Configurar limpeza de cache

Execute az afd endpoint purge com os parâmetros necessários:

• Nome do grupo de recursos
• Nome do perfil do Azure Front Door no grupo de recursos
• Pontos de extremidade com ativos a serem limpos
• Domínios/subdomínios com ativos a serem limpos

Importante

Não há suporte para limpeza de cache para domínios curinga. Especifique um subdomínio para limpeza de cache para um domínio curinga. Você pode adicionar muitos subdomínios de nível único do domínio curinga. Por exemplo, para o domínio curinga *.afdxgatest.azfdtest.xyz, você pode adicionar subdomínios como contoso.afdxgatest.azfdtest.xyz ou cart.afdxgatest.azfdtest.xyz. Para obter mais informações, confira Domínios curinga no Azure Front Door.

• O caminho para o conteúdo a ser limpo:
  • Formatos com suporte:
    • Limpeza de caminho único: especifique o caminho completo do ativo (sem o protocolo e o domínio), incluindo a extensão de arquivo, por exemplo, /pictures/strasbourg.png.
    • Limpeza do domínio raiz: limpe a raiz do ponto de extremidade com "/*" no caminho.

az afd endpoint purge \
    --resource-group myRGFD \
    --profile-name contosoafd \
    --endpoint-name myendpoint \
    --domains www.contoso.com \
    --content-paths '/scripts/*'

Limpezas de cache no perfil do Azure Front Door não diferenciam maiúsculas de minúsculas e consultam cadeia de caracteres independente, o que significa que limpar uma URL limpa todas as suas variações de cadeia de caracteres de consulta.

Observação

A limpeza de cache pode levar até 10 minutos para ser propagada por toda a rede e em todos os locais de borda.

Próximas etapas

Para continuar, saiba como criar um perfil do Azure Front Door.