Vidage du cache dans Azure Front Door avec Azure CLI
Azure Front Door met en cache des ressources jusqu’à ce que leur durée de vie (TTL) expire. Lorsqu’un client demande une ressource expirée, Azure Front Door récupère une nouvelle copie de la ressource, traite la demande et met à jour le cache.
Pour vous assurer que les utilisateurs obtiennent toujours les dernières ressources, définissez une version pour vos ressources pour chaque mise à jour et publiez-les avec de nouvelles URL. Azure Front Door récupère les nouvelles ressources pour les demandes clientes suivantes. Parfois, vous devrez peut-être vider le contenu mis en cache à partir de tous les nœuds de périphérie pour les forcer à récupérer les ressources mises à jour. Cette action est nécessaire lorsque votre application est mise à jour ou pour corriger 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.
- Vérifiez que vous disposez d’un profil Azure Front Door fonctionnel. Reportez-vous à Créer une instance Front Door avec CLI pour en savoir plus.
Configurer le vidage du cache
Exécutez az afd endpoint purge avec les paramètres nécessaires :
- Nom du groupe ressources
- Nom du profil Azure Front Door dans le groupe de ressources
- Points de terminaison avec des ressources à vider
- Domaines/sous-domaines avec des ressources à vider
Important
Le vidage du cache pour les domaines génériques n’est pas pris en charge. Spécifiez un sous-domaine pour le vidage du cache pour un domaine générique. Vous pouvez ajouter plusieurs sous-domaines à un domaine générique. Par exemple, pour le domaine générique *.afdxgatest.azfdtest.xyz, vous pouvez ajouter des sous-domaines comme contoso.afdxgatest.azfdtest.xyz ou cart.afdxgatest.azfdtest.xyz. Pour plus d’informations, consultez la rubrique Domaines génériques dans Azure Front Door.
- Chemin du contenu à vider :
- Formats pris en charge :
- Vidage de chemin d’accès unique : spécifiez le chemin complet de la ressource (sans le protocole et le domaine), y compris l’extension de fichier, par exemple /pictures/strasbourg.png.
- Vidage du domaine racine : Videz la racine du point de terminaison avec « /* » dans le chemin.
- Formats pris en charge :
az afd endpoint purge \
--resource-group myRGFD \
--profile-name contosoafd \
--endpoint-name myendpoint \
--domains www.contoso.com \
--content-paths '/scripts/*'
Les purges de cache sur le profil Azure Front Door ne respectent pas la casse et sont indépendantes de la chaîne de requête, ce qui signifie que le vidage d’une URL vide toutes ses variantes de chaîne de requête.
Remarque
Le vidage du cache peut prendre jusqu’à 10 minutes pour se propager sur le réseau et sur tous les emplacements périphériques.
Étapes suivantes
Pour continuer, découvrez comment Créer un profil Azure Front Door.