Cache opschonen in Azure Front Door met behulp van Azure CLI

Azure Front Door slaat assets in de cache op totdat hun time-to-live (TTL) verloopt. Wanneer een client een asset aanvraagt met een verlopen TTL, haalt Azure Front Door een nieuwe kopie van de asset op, dient de aanvraag en werkt de cache bij.

Om ervoor te zorgen dat gebruikers altijd de nieuwste assets krijgen, moet u uw assets voor elke update versieren en publiceren met nieuwe URL's. Azure Front Door haalt de nieuwe assets op voor volgende clientaanvragen. Soms moet u inhoud in de cache opschonen van alle Edge-knooppunten om ze af te dwingen bijgewerkte assets op te halen. Deze actie is handig wanneer er updates worden aangebracht in uw toepassing of onjuiste informatie moet corrigeren.

Vereisten

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie quickstart voor Bash in Azure Cloud Shell voor meer informatie.

  

• Installeer de Azure CLI, indien gewenst, om CLI-referentieopdrachten uit te voeren. Als u in Windows of macOS werkt, kunt u Azure CLI uitvoeren in een Docker-container. Zie De Azure CLI uitvoeren in een Docker-container voor meer informatie.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met behulp van de opdracht az login. Volg de stappen die worden weergegeven in de terminal, om het verificatieproces te voltooien. Raadpleeg Aanmelden bij Azure CLI voor aanvullende aanmeldingsopties.

  • Installeer de Azure CLI-extensie bij het eerste gebruik, wanneer u hierom wordt gevraagd. Raadpleeg Extensies gebruiken met Azure CLI voor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en afhankelijke bibliotheken te vinden. Voer az upgrade uit om te upgraden naar de nieuwste versie.

• Bekijk caching met Azure Front Door om te begrijpen hoe caching werkt.
• Zorg ervoor dat u een functionerend Azure Front Door-profiel hebt. Raadpleeg Een Azure Front Door maken - CLI voor meer informatie over het maken van een azure-exemplaar.

Cache opschonen configureren

Voer az afd endpoint purge uit met de benodigde parameters:

• Naam van de resourcegroep
• Azure Front Door-profielnaam binnen de resourcegroep
• Eindpunten met assets die moeten worden leeggeschoond
• Domeinen/subdomeinen met assets die moeten worden leeggeschoond

Belangrijk

Cache opschonen voor jokertekendomeinen wordt niet ondersteund. Geef een subdomein op voor het opschonen van de cache voor een domein met jokertekens. U kunt meerdere subdomeinen op één niveau van het domein met jokertekens toevoegen. Voor het domein *.afdxgatest.azfdtest.xyzmet jokertekens kunt u bijvoorbeeld subdomeinen toevoegen zoals contoso.afdxgatest.azfdtest.xyz of cart.afdxgatest.azfdtest.xyz. Zie Jokertekendomeinen in Azure Front Door voor meer informatie.

• Pad naar de inhoud die moet worden opgeschoond:
  • Ondersteunde indelingen:
    • Eén pad opschonen: geef het volledige pad van de asset op (zonder het protocol en domein), inclusief de bestandsextensie, bijvoorbeeld /pictures/strasbourg.png.
    • Hoofddomein opschonen: verwijder de hoofdmap van het eindpunt met '/*' in het pad.

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

Cache-opschoningen in het Azure Front Door-profiel zijn niet hoofdlettergevoelig en querytekenreeksneutraal, wat betekent dat een URL alle queryreeksvariaties opschoont.

Notitie

Het opschonen van de cache kan tot 10 minuten duren voordat het hele netwerk en op alle edge-locaties wordt doorgegeven.

Volgende stappen

Als u wilt doorgaan, leert u hoe u een Azure Front Door-profiel maakt.