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/file.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 utiliser la Google Cloud CLI ou la console Google Cloud pour effectuer des invalidations.

Vous pouvez accéder à Google Cloud CLI de deux manières :

• Installez Google Cloud CLI en suivant les instructions fournies sur la page Installation avec apt-get. Si vous n'avez pas encore utilisé Google Cloud CLI, 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.

Remarque : Si vous utilisez un équilibreur de charge d'application externe global avec référencement de service inter-projets de VPC partagé, par défaut, les administrateurs de projet de service ne disposent pas des autorisations requises pour invalider un cache. En effet, l'invalidation de cache est configurée dans le projet d'interface (c'est-à-dire le projet contenant la règle de transfert, le proxy cible et le mappage d'URL de l'équilibreur de charge). Les administrateurs de services qui contrôlent le provisionnement des services de backend dans un projet distinct peuvent collaborer avec l'administrateur de l'équilibreur de charge du projet d'interface pour émettre une invalidation de cache pour leurs services inter-projets. Pour les réécritures d'URL, assurez-vous que l'invalidation correspond à l'hôte et au chemin d'accès avant réécriture que le client envoie.

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/file.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/file.jpg).
5. Cliquez sur Invalider.

gcloud

gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \
    --path "/images/file.jpg"

Le nom de l'équilibreur de charge d'application externe et celui du mappage d'URL sont identiques.

Remplacez LOAD_BALANCER_NAME par le nom de votre équilibreur de charge. Pour répertorier vos équilibreurs de charge, 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 LOAD_BALANCER_NAME \
    --host HOSTNAME \
    --path "/images/file.jpg"

Par défaut, Google Cloud CLI 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 LOAD_BALANCER_NAME \
    --path "/images/*"

Remplacez LOAD_BALANCER_NAME par le nom de votre équilibreur de charge. Pour répertorier vos équilibreurs de charge, 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 LOAD_BALANCER_NAME \
    --host HOSTNAME \
    --path "/images/*"

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

Tout invalider

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 LOAD_BALANCER_NAME \
    --path "/*"

Remplacez les éléments suivants :

• LOAD_BALANCER_NAME : nom de votre é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 LOAD_BALANCER_NAME \
    --host HOSTNAME \
    --path "/*"

Par défaut, Google Cloud CLI 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.