Invalidar conteúdo armazenado em cache

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 execute gcloud init para autenticar.

• Use o Google Cloud Shell, que já vem com a gcloud instalada.

Permissões exigidas para a tarefa

Para executar esta tarefa, são necessárias as seguintes permissões ou papéis do IAM.

Permissões

• compute.urlMaps.get
• compute.urlMaps.invalidateCache

Papéis

• roles/compute.networkAdmin
• roles/compute.loadBalancerAdmin

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.

Observação: se você estiver usando um balanceador de carga de aplicativo externo global com VPC compartilhada referência de serviço entre projetos padrão, os administradores do projeto de serviço não terão as permissões necessárias para solicitar as invalidações de cache. Isso ocorre porque a invalidação de cache é configurada no projeto de front-end, ou seja, o projeto que tem a regra de encaminhamento, o proxy de destino e o mapa de URL do balanceador de carga. Os administradores de serviços que controlam o provisionamento dos serviços de back-end em um projeto separado podem trabalhar com o administrador do balanceador de carga do projeto de front-end para emitir a invalidação de cache para os serviços entre projetos. Para substituições de URL, verifique se a invalidação corresponde ao host e ao caminho de pré-regravação que o cliente envia.

Invalidar apenas um arquivo

Console

1. No console do Google Cloud, acesse a página do Cloud CDN.

   Acessar a página do Cloud CDN

2. Em Balanceadores de carga associados, clique no nome do balanceador de carga.
3. Clique na guia Invalidação de cache.
4. 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).
5. 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

1. No console do Google Cloud, acesse a página do Cloud CDN.

   Acessar a página do Cloud CDN

2. Em Balanceadores de carga associados, clique no nome do balanceador de carga.
3. Clique na guia Invalidação de cache.
4. 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/*.
5. 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

1. No console do Google Cloud, acesse a página do Cloud CDN.

   Acessar a página do Cloud CDN

2. Em Balanceadores de carga associados, clique no nome do balanceador de carga.
3. Clique na guia Invalidação de cache.
4. 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/*.
5. 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.