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

O Azure Front Door armazena em cache os ativos até a TTL (vida útil) do ativo expirar. Sempre que um cliente solicita um ativo com TTL expirado, o ambiente de Front Door recupera uma nova cópia atualizada do ativo para atender à solicitação e, em seguida, armazena o cache atualizado.

A melhor prática é garantir que os usuários sempre obtenham a cópia mais recente dos seus ativos. Para isso, basta criar uma versão dos ativos para cada atualização e publicá-las como novas URLs. O Azure Front Door Standard/Premium recuperará imediatamente os novos ativos para as próximas solicitações do cliente. Às vezes, você pode desejar limpar o conteúdo do cache de todos os nós de extremidade e forçá-los a recuperar novos ativos atualizados. O motivo pelo qual você deseja limpar o conteúdo armazenado em cache é por ter feito novas atualizações no seu aplicativo ou para atualizar ativos que contêm 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 saber mais, 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.
• Tenha um perfil do Azure Front Door funcionando. Consulte Criar um Front Door – CLI para saber como criar um perfil.

Configurar limpeza de cache

Execute az afd endpoint purge para limpar o cache após inserir os parâmetros necessários, como:

• nome do grupo de recursos

• Nome do perfil do Azure Front Door dentro do grupo de recursos com ativos que você deseja limpar

• Pontos de extremidade com ativos que você deseja limpar

• Domínios/Subdomínios com ativos que você deseja limpar

  Importante

  Não há suporte para a limpeza de cache para domínio curinga, você precisa especificar 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 na forma de contoso.afdxgatest.azfdtest.xyz ou cart.afdxgatest.azfdtest.xyz e assim por diante. Para obter mais informações, confira Domínios curinga no Azure Front Door.

• O caminho para o conteúdo a ser limpo.

  • Esses formatos têm suporte nas listas de caminhos a limpar:
    • Limpeza de caminho único: limpe ativos individuais especificando o caminho completo do ativo (sem o protocolo e o domínio), com 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/*'

As limpezas de cache no perfil do Azure Front Door não diferenciam maiúsculas de minúsculas. Além disso, as limpezas são independentes da cadeia de caracteres de consulta, o que significa que a limpeza de uma URL apagará todas as variações da cadeia de caracteres de consulta.

Próximas etapas

Saiba como Criar um perfil do Azure Front Door.