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 commandegcloud
, exécutez d'abordgcloud init
pour vous authentifier.Utilisez Cloud Shell, qui comprend déjà
gcloud
.
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
- Dans Google Cloud Console, accédez à la page Cloud CDN.
- Cliquez sur le nom de l'origine concernée.
- Cliquez sur l'onglet Invalidation de cache.
- 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
).
- Si vous souhaitez invalider un chemin pour tous les noms d'hôte, ne saisissez que le chemin (par exemple,
- 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 l'intégralité du répertoire
Console
- Dans Google Cloud Console, accédez à la page Cloud CDN.
- Cliquez sur le nom de l'origine concernée.
- Cliquez sur l'onglet Invalidation de cache.
- 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/*
).
- 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,
- 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.
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
- Dans Google Cloud Console, accédez à la page Cloud CDN.
- Cliquez sur le nom de l'origine concernée.
- Cliquez sur l'onglet Invalidation de cache.
- 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/*
).
- Si vous souhaitez invalider la totalité du contenu pour tous les noms d'hôte, saisissez uniquement
- 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./*
: 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.