Vidage du cache dans Azure Front Door avec Azure CLI

Azure Front Door met en cache les ressources tant que leur durée de vie (TTL) n’est pas arrivée à expiration. Chaque fois qu’un client demande une ressource dont la durée de vie a expiré, l’environnement Azure Front Door en récupère une nouvelle copie mise à jour pour servir la demande, puis stocke le cache actualisé.

En guise de bonne pratique, veillez à ce que vos utilisateurs obtiennent toujours la dernière copie de vos ressources. Pour cela, versionnez vos ressources à chaque mise à jour et publiez-les avec de nouvelles URL. Azure Front Door Standard/Premium récupère immédiatement les nouvelles ressources pour les demandes de client suivantes. Il est parfois souhaitable de vider le contenu mis en cache sur tous les nœuds de périphérie et de tous les forcer à récupérer de nouvelles ressources mises à jour. Le vidage du contenu mis en cache peut en effet s’avérer utile si vous avez procédé à de nouvelles mises à jour de votre application, ou si vous souhaitez mettre à jour des ressources qui contiennent des informations incorrectes.

Prérequis

• Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.

  

• Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.

  • Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.

  • Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.

  • Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

• Consultez Mise en cache avec Azure Front Door pour comprendre le fonctionnement de la mise en cache.
• Avoir un profil Azure Front Door fonctionnel. Reportez-vous à Créer une instance Front Door – CLI pour découvrir comment en créer une.

Configurer le vidage du cache

Exécutez az afd endpoint purge pour vider le cache après avoir entré les paramètres nécessaires comme ceux-ci :

• nom du groupe de ressources

• Nom du profil Azure Front Door au sein du groupe de ressources contenant les ressources à vider

• Points de terminaison contenant les ressources à vider

• Domaines/Sous-domaines contenant les ressources à vider

  Important

  La purge du cache pour les domaines génériques n’est pas prise en charge, vous devez spécifier un sous-domaine pour la purge du cache pour un domaine générique. Vous pouvez ajouter autant de sous-domaines à un seul niveau que le domaine générique. Par exemple, pour le domaine générique *.afdxgatest.azfdtest.xyz, vous pouvez ajouter des sous-domaines sous la forme contoso.afdxgatest.azfdtest.xyz ou cart.afdxgatest.azfdtest.xyz, et ainsi de suite. Pour plus d’informations, consultez la rubrique Domaines génériques dans Azure Front Door.

• Chemin du contenu à vider.

  • Ces formats sont pris en charge dans les listes de chemins d’accès à vider :
    • Vidage à chemin unique : Supprimez des ressources individuelles en spécifiant leur chemin complet (sans le protocole ni le domaine) avec l’extension de fichier, par exemple /pictures/strasbourg.png.
    • Vidage du domaine racine : Videz la racine du point de terminaison avec « /* » dans le chemin.

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

Les vidages du cache dans le profil Azure Front Door ne tiennent pas compte de la casse. Par ailleurs, ils ne prennent pas en compte les chaînes de requête, ce qui signifie que le vidage d’une URL a pour effet de vider toutes ses variantes constituées de chaînes de requête.

Étapes suivantes

Découvrez comment Créer un profil Azure Front Door.