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

É possível usar a Google Cloud CLI ou o console do Google Cloud para realizar invalidações.

É possível acessar a CLI do Google Cloud de duas maneiras:

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

  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 um 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