Invalider un contenu mis en cache

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

Par exemple, si un fichier situé à /images/foo.jpg a été mis en cache et doit être invalidé, vous pouvez l'invalider de plusieurs manières, selon que vous souhaitez n'affecter que ce fichier ou un champ d'application plus large. Dans chaque cas, vous pouvez invalider pour tous les noms d'hôte ou pour 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 fournies sur la page Installation 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 est déjà installé avec gcloud.

Invalider un seul fichier

Console

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

    Accéder à la page Cloud CDN

  2. Cliquez sur le nom d'origine de l'origine concernée.
  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/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.

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 tout le répertoire

Console

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

    Accéder à la page Cloud CDN

  2. Cliquez sur le nom d'origine de l'origine concernée.
  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 l'équilibreur de charge.

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 tout

Console

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

    Accéder à la page Cloud CDN

  2. Cliquez sur le nom d'origine de l'origine concernée.
  3. Cliquez sur l'onglet Invalidation de cache.
  4. Saisissez uniquement la racine et le caractère générique (/*).
    • Si vous souhaitez tout invalider pour tous les noms d'hôte, saisissez uniquement /* dans le champ.
    • Si vous souhaitez tout invalider 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 \
    --host HOSTNAME \
    --path "/*"

Remplacez l'élément suivant :

  • URL_MAP_NAME : nom de la ressource de mappage d'URL dans l'équilibreur de charge.
  • /* : le 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