Invalider un contenu mis en cache

Cette page explique comment invalider du contenu Cloud CDN mis en cache.

Par exemple, si un fichier situé à l'emplacement /images/foo.jpg a été mis en cache et doit être invalidé, vous pouvez utiliser pour cela plusieurs méthodes, selon que vous souhaitez affecter uniquement ce fichier ou un champ d'application plus étendu. Dans chaque cas, vous pouvez invalider le contenu pour tous les noms d'hôte ou un seul nom d'hôte.

Pour en savoir plus sur l'invalidation de cache, consultez la section Présentation de l'invalidation de cache.

Avant de commencer

Vous pouvez effectuer des invalidations à l'aide de l'interface de ligne de commande gcloud ou de Google Cloud Console.

Vous pouvez accéder à l'outil de ligne de commande gcloud de deux manières :

• Installez le SDK Cloud en suivant les instructions de la page Installer avec apt-get. Si vous n'avez jamais exécuté l'outil de ligne de commande gcloud, exécutez d'abord gcloud init pour vous authentifier.

• Utilisez Cloud Shell, qui comprend déjà gcloud.

Autorisations requises pour cette tâche

Pour effectuer cette tâche, vous devez avoir reçu les autorisations OU les rôles IAM suivants :

Autorisations

• compute.urlMaps.get
• compute.urlMaps.invalidateCache

Rôles

• roles/compute.networkAdmin
• roles/compute.loadBalancerAdmin

Pour créer un rôle personnalisé ayant l'autorisation requise, consultez la section Créer et gérer les rôles personnalisés.

Pour ajouter un rôle prédéfini, utilisez le guide de démarrage rapide IAM.

Invalider un seul fichier

Console

1. Dans Google Cloud Console, accédez à la page Cloud CDN.

   Accéder à la page "Cloud CDN"

2. Sous Équilibreurs de charge associés, cliquez sur le nom de l'équilibreur de charge.
3. Cliquez sur l'onglet Invalidation de cache.
4. Saisissez le chemin du fichier.
   • Si vous souhaitez invalider un chemin pour tous les noms d'hôte, ne saisissez que le chemin (par exemple, /images/foo.jpg).
   • Si vous souhaitez invalider un chemin d'accès pour un seul nom d'hôte, spécifiez le nom d'hôte dans le chemin (par exemple : example.com/images/foo.jpg).
5. Cliquez sur Invalider.

gcloud

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --path "/images/foo.jpg"

Remplacez URL_MAP_NAME par le nom de la ressource de mappage d'URL dans votre équilibreur de charge. Pour répertorier vos mappages d'URL, utilisez la commande gcloud compute url-maps list.

Facultatif : pour invalider un seul hôte, ajoutez l'option --host (--host example.com).

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host HOSTNAME \
    --path "/images/foo.jpg"

Par défaut, l'outil de ligne de commande gcloud attend la fin de l'invalidation. Pour effectuer l'invalidation en arrière-plan, ajoutez --async à la ligne de commande.

Invalider l'intégralité du répertoire

Console

1. Dans Google Cloud Console, accédez à la page Cloud CDN.

   Accéder à la page "Cloud CDN"

2. Sous Équilibreurs de charge associés, cliquez sur le nom de l'équilibreur de charge.
3. Cliquez sur l'onglet Invalidation de cache.
4. Saisissez le chemin du répertoire et le caractère générique (/path/to/file/*).
   • Si vous souhaitez invalider tout le répertoire pour tous les noms d'hôte, saisissez uniquement le chemin d'accès et le caractère générique (par exemple, /images/*).
   • Si vous souhaitez invalider tout le répertoire pour un seul nom d'hôte, spécifiez le nom d'hôte dans le chemin (par exemple, example.com/images/*).
5. Cliquez sur Invalider.

gcloud

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --path "/images/*"

Remplacez URL_MAP_NAME par le nom de la ressource de mappage d'URL dans votre équilibreur de charge. Pour répertorier vos mappages d'URL, utilisez la commande gcloud compute url-maps list.

Facultatif : pour invalider un seul hôte, ajoutez l'option --host (--host example.com).

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host HOSTNAME \
    --path "/images/*"

Par défaut, l'outil de ligne de commande gcloud attend la fin de l'invalidation. Pour effectuer l'invalidation en arrière-plan, ajoutez --async à la ligne de commande.

Invalider la totalité du contenu

Console

1. Dans Google Cloud Console, accédez à la page Cloud CDN.

   Accéder à la page "Cloud CDN"

2. Sous Équilibreurs de charge associés, cliquez sur le nom de l'équilibreur de charge.
3. Cliquez sur l'onglet Invalidation de cache.
4. Saisissez uniquement la racine et le caractère générique (/*).
   • Si vous souhaitez invalider la totalité du contenu pour tous les noms d'hôte, saisissez uniquement /* dans le champ.
   • Si vous souhaitez invalider la totalité du contenu pour un seul nom d'hôte, spécifiez le nom d'hôte dans le chemin (par exemple : example.com/*).
5. Cliquez sur Invalider.

gcloud

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --path "/*"

Remplacez l'élément suivant :

• URL_MAP_NAME : nom de la ressource de mappage d'URL dans l'équilibreur de charge.
• /* : chemin d'URL que vous souhaitez invalider (n'inclut pas le nom d'hôte). Le chemin peut utiliser un nom de fichier explicite ou un caractère générique.

Facultatif : pour invalider un seul hôte, ajoutez l'option --host (--host example.com).

gcloud compute url-maps invalidate-cdn-cache URL_MAP_NAME \
    --host HOSTNAME \
    --path "/*"

Par défaut, l'outil de ligne de commande gcloud attend la fin de l'invalidation. Pour effectuer l'invalidation en arrière-plan, ajoutez --async à la ligne de commande.

Étapes suivantes

• Consultez la page Afficher les journaux pour vérifier si Cloud CDN diffuse des réponses à partir d'un cache.
• Pour savoir quels contenus peuvent être mis en cache ou non, consultez la page Présentation de la mise en cache.
• Pour trouver des points de présence GFE, consultez la section Emplacements de cache.