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 effectuer des invalidations à l'aide de Google Cloud CLI ou de la console Google Cloud.

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érence de service inter-projets sur les VPC partagés, les administrateurs de projet de service ne disposent pas par défaut des autorisations nécessaires pour demander des invalidations de cache. En effet, l'invalidation du cache est configurée dans le projet d'interface (c'est-à-dire le projet qui contient la règle de transfert, le proxy cible et le mappage d'URL de l'équilibreur de charge). Les administrateurs de service 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 l'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 de pré-réécriture envoyés par le client.

Invalider un seul fichier

Console

1. Dans la console Google Cloud, 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. Entrez 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 la console Google Cloud, 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 d'accès au 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 la console Google Cloud, 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.