Nesta página, você aprenderá a invalidar conteúdo armazenado em cache no Cloud CDN.
Por exemplo, se um arquivo localizado em /images/file.jpg
tiver sido armazenado em cache e precisar ser invalidado, você poderá usar vários métodos para invalidá-lo, dependendo de você querer afetar apenas esse arquivo ou tiver um escopo mais amplo. Em cada caso, é possível executar a invalidação para todos os nomes do host ou apenas um.
Para saber mais sobre a invalidação de cache, consulte Visão geral da invalidação de cache.
Antes de começar
Use a CLI ou o console do Google Cloud para realizar invalidações.
É possível acessar a CLI do Google Cloud de duas maneiras:
Instale a CLI do Google Cloud seguindo as instruções em Como instalar com
apt-get
. Se você nunca usou a CLI do Google Cloud, primeiro executegcloud init
para autenticar.Use o Google Cloud Shell, que já vem com a
gcloud
instalada.
Para criar um papel personalizado com a permissão necessária, consulte Como criar e gerenciar papéis personalizados.
Para adicionar um papel predefinido, use o guia de início rápido do IAM.
Invalidar apenas um arquivo
Console
- No console do Google Cloud, acesse a página do Cloud CDN.
- Em Balanceadores de carga associados, clique no nome do balanceador de carga.
- Clique na guia Invalidação de cache.
- Insira o caminho do arquivo.
- Se quiser invalidar o caminho para todos os nomes de host, insira somente o caminho, por exemplo:
/images/file.jpg
. - Se você quiser invalidar um caminho para apenas um nome de host, especifique o nome do host como parte do caminho (por exemplo:
example.com/images/file.jpg
).
- Se quiser invalidar o caminho para todos os nomes de host, insira somente o caminho, por exemplo:
- Clique em Invalidar.
gcloud
gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \ --path "/images/file.jpg"
O nome do balanceador de carga de aplicativo externo e o nome do mapa de URL são os mesmos.
Substitua LOAD_BALANCER_NAME
pelo nome do balanceador de carga. Para listar os balanceadores de carga, use o
comando gcloud compute url-maps list
.
Opcional: para fazer a invalidação em apenas um host, adicione a sinalização --host
(--host example.com
).
gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \ --host HOSTNAME \ --path "/images/file.jpg"
Por padrão, a Google Cloud CLI aguarda a conclusão da
invalidação. Para realizar a invalidação em segundo plano, anexe --async
à linha de comando.
Invalidar o diretório inteiro
Console
- No console do Google Cloud, acesse a página do Cloud CDN.
- Em Balanceadores de carga associados, clique no nome do balanceador de carga.
- Clique na guia Invalidação de cache.
- Insira o caminho do diretório e o caractere curinga (
/path/to/file/*
).- Se você quiser invalidar o diretório inteiro para todos os nomes de host, digite apenas o caminho e o caractere curinga (por exemplo:
/images/*
). - Se quiser invalidar o diretório inteiro para apenas um nome de host, especifique o nome desse host como parte do caminho, por exemplo,
example.com/images/*
.
- Se você quiser invalidar o diretório inteiro para todos os nomes de host, digite apenas o caminho e o caractere curinga (por exemplo:
- Clique em Invalidar.
gcloud
gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \ --path "/images/*"
Substitua LOAD_BALANCER_NAME
pelo nome do balanceador de carga. Para listar os balanceadores de carga, use o
comando gcloud compute url-maps list
.
Opcional: para fazer a invalidação em apenas um host, adicione a sinalização --host
(--host example.com
).
gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \ --host HOSTNAME \ --path "/images/*"
Por padrão, a Google Cloud CLI aguarda a conclusão da
invalidação. Para realizar a invalidação em segundo plano, anexe --async
à linha de comando.
Invalidar tudo
Console
- No console do Google Cloud, acesse a página do Cloud CDN.
- Em Balanceadores de carga associados, clique no nome do balanceador de carga.
- Clique na guia Invalidação de cache.
- Insira apenas a raiz e o caractere curinga (
/*
).- Se quiser invalidar tudo para todos os nomes de host, insira somente
/*
no campo. - Se quiser invalidar tudo para um único nome de host, especifique o nome do host como parte do caminho, por exemplo,
example.com/*
.
- Se quiser invalidar tudo para todos os nomes de host, insira somente
- Clique em Invalidar.
gcloud
gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \ --path "/*"
Substitua:
LOAD_BALANCER_NAME
: o nome do balanceador de carga./*
: o caminho do URL que você quer invalidar; não inclua o nome do host; o caminho pode usar um nome de arquivo explícito ou um caractere curinga
Opcional: para fazer a invalidação em apenas um host, adicione a sinalização --host
(--host example.com
).
gcloud compute url-maps invalidate-cdn-cache LOAD_BALANCER_NAME \ --host HOSTNAME \ --path "/*"
Por padrão, a Google Cloud CLI aguarda a conclusão da
invalidação. Para realizar a invalidação em segundo plano, anexe --async
à linha de comando.
A seguir
- Para verificar se o Cloud CDN está exibindo respostas a partir do cache, consulte Como visualizar registros.
- Para saber qual conteúdo é armazenável em cache ou não, consulte Visão geral do armazenamento em cache.