Remoção da cache no Azure Front Door com a CLI do Azure

O Azure Front Door coloca os recursos em cache até que o TTL (time-to-live) do recurso expire. Sempre que um cliente solicita um recurso com TTL expirado, o ambiente do Azure Front Door obtém uma nova cópia atualizada do recurso para servir o pedido e, em seguida, armazena a cache atualizada.

A melhor prática é garantir que os seus utilizadores obtêm sempre a cópia mais recente dos seus recursos. A forma de o fazer é controlar a versão dos seus recursos para cada atualização e publicá-los como novos URLs. O Azure Front Door Standard/Premium irá obter imediatamente os novos recursos para os próximos pedidos de cliente. Por vezes, pode querer remover conteúdos em cache de todos os nós perifícios e forçá-los a todos a obter novos recursos atualizados. A razão pela qual pretende remover conteúdos em cache é porque fez novas atualizações à sua aplicação ou quer atualizar os recursos que contêm informações incorretas.

Pré-requisitos

• Utilize o ambiente bash no Azure Cloud Shell. Para obter mais informações, veja Início Rápido do Bash no Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, veja Como executar a CLI do Azure num contentor do Docker.

  • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de início de sessão, veja Iniciar sessão com a CLI do Azure.

  • Quando lhe for pedido, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

• Reveja Colocação em cache com o Azure Front Door para compreender como funciona a colocação em cache.
• Ter um perfil do Azure Front Door funcional. Veja Criar um Front Door - CLI para saber como criar um.

Configurar a remoção da cache

Execute az afd endpoint purge para remover a cache depois de introduzir os parâmetros necessários, como:

• Nome do grupo de recursos

• Nome do perfil do Azure Front Door no grupo de recursos com os recursos que pretende remover

• Pontos finais com recursos que pretende remover

• Domínios/Subdomínios com recursos que pretende remover

  Importante

  A remoção da cache para domínios com carateres universais não é suportada. Tem de especificar um subdomínio para remoção da cache para um domínio de carateres universais. Pode adicionar tantos subdomínios de nível único do domínio de caráter universal. Por exemplo, para o domínio de caráter *.afdxgatest.azfdtest.xyzuniversal, pode adicionar subdomínios sob a forma de contoso.afdxgatest.azfdtest.xyz ou cart.afdxgatest.azfdtest.xyz assim sucessivamente. Para obter mais informações, veja Domínios universais no Azure Front Door.

• O caminho para o conteúdo a remover.

  • Estes formatos são suportados nas listas de caminhos a remover:
    • Remoção de caminho único: remova os recursos individuais ao especificar o caminho completo do recurso (sem o protocolo e o domínio), com a extensão de ficheiro, por exemplo, /pictures/strasbourg.png.
    • Remoção de domínio raiz: remova a raiz do ponto final com "/*" no caminho.

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

As remoção de cache no perfil do Azure Front Door não são sensíveis a maiúsculas e minúsculas. Além disso, são agnósticos na cadeia de consulta, o que significa que remover um URL removerá todas as variações da cadeia de consulta do mesmo.

Nota

A remoção da cache pode demorar até 10 minutos a propagar-se em toda a rede e em todas as localizações edge.

Passos seguintes

Saiba como criar um perfil do Azure Front Door.