Invalidar conteúdo armazenado em cache

A invalidação de cache, às vezes chamada de purga de cache, é o processo de declarar o conteúdo armazenado em cache como inválido. Isso faz com que a entrada seja removida do cache e reabastecida do servidor de origem na próxima vez que o conteúdo for solicitado.

O Media CDN oferece suporte a várias maneiras de selecionar conteúdo para ser invalidado, conforme descrito abaixo:

• Host e caminho do URL
• Prefixo de URL (caractere curinga)
• Tags de cache, incluindo tags integradas para status, origin e content-type

É possível combinar esses parâmetros de invalidação para segmentar respostas específicas em cache e minimizar a carga de origem no preenchimento de cache subsequente.

Sintaxe de invalidação aceita

A sintaxe de invalidação compatível é a seguinte:

Tipo	Sintaxe	Exemplo
Invalidação do host	Invalidar as respostas armazenadas em cache para o host especificado.	gcloud edge-cache services invalidate-cache SERVICE_NAME \     --host="media.example.com"
Invalidação de caminho	Invalide as respostas armazenadas em cache para o caminho ou prefixo de caminho especificado.	gcloud edge-cache services invalidate-cache SERVICE_NAME \     --path="/content/1234/hls/*" gcloud edge-cache services invalidate-cache SERVICE_NAME \     --path="/videos/funny.mp4"
Invalidação da tag de cache no código de status HTTP, nome da origem ou tipo MIME	Inválidar respostas armazenadas em cache com uma tag correspondente. Várias tags são tratadas como um OR booleano.	gcloud edge-cache services invalidate-cache SERVICE_NAME \     --tags="status=404,origin=staging-origin" gcloud edge-cache services invalidate-cache SERVICE_NAME \     --tags="content-type=application/x-mpegurl"

Observações:

• É possível especificar até 10 tags de cache em uma única solicitação de invalidação.
• É possível combinar host, path e tags em uma única solicitação de invalidação. Eles são tratados como um AND booleano.
• Quando várias tags de cache são especificadas, elas são tratadas como um OR booleano. Por exemplo, se você especificar --tags="status=404,origin=staging-origin", todas as respostas com uma tag de cache de status=404 serão invalidadas, assim como todas as respostas com uma tag de cache de origin=staging-origin.

Tags de cache

As tags de cache (ou chaves substitutas) permitem invalidar o conteúdo com base em metadados arbitrários.

Observação: as tags de cache são diferentes das chaves de cache.

Essas tags são definidas da seguinte maneira:

• Definir o cabeçalho HTTP Cache-Tag em uma resposta de origem, com tags especificadas como uma lista de valores separados por vírgulas.
• Tags integradas com base no código de status HTTP da resposta, no tipo MIME do cabeçalho de resposta HTTP Content-Type ou no nome da origem de onde a resposta foi extraída.

Quando várias tags são especificadas em uma única solicitação de invalidação, elas são tratadas como um OR booleano.

Veja o exemplo a seguir.

• Você tem os seguintes objetos armazenados em cache:

  • Objeto 1 em cache com tags status=200, content-type=video/mp4
  • Objeto em cache 2 com tags status=404 e content-type=text/plain
  • Objeto 3 em cache com as tags status=200 e content-type=application/x-mpegurl

• Você emite uma solicitação para invalidar objetos com tags="status=200,content-type=text/plain".

• Resultado: todos os três objetos armazenados em cache são invalidados ao mesmo tempo. Isso evita que você precise especificar todas as combinações de tags possíveis, algumas das quais podem ser desconhecidas.

Observações:

• As tags de cache padrão não são incluídas na resposta do cliente porque refletem cabeçalhos existentes (como a linha de status ou Content-Type) ou detalhes de configuração interna.
• As tags de cache enviadas pela origem no cabeçalho de resposta HTTP Cache-Tag são enviadas para o cliente. Se você quiser impedir que eles sejam enviados ao cliente, use o recurso responseHeadersToRemove em um routeRule para remover o cabeçalho Cache-Tag. Para conferir exemplos, consulte a documentação cabeçalhos personalizados.

Tags integradas

As respostas têm as seguintes tags de cache aplicadas automaticamente para oferecer suporte à invalidação de conteúdo com base no código de status, no tipo MIME ou na origem de onde o conteúdo foi buscado. Não é necessário especificar essas tags nas respostas de origem.

Tag	Detalhes
status=HTTP_STATUS_CODE	A tag de cache status é definida com base no código de status HTTP retornado da resposta em cache. Por exemplo, é possível invalidar todas as respostas HTTP 404 armazenadas em cache especificando status=404 em uma solicitação de invalidação.
content-type=MIME_TYPE	A tag de cache content-type é definida com base no tipo MIME definido no cabeçalho de resposta HTTP Content-Type. Por exemplo, o tipo MIME de uma playlist HLS é application/x-mpegURL ou vnd.apple.mpegURL. Isso permite que você invalide tipos específicos de conteúdo.
origin=ORIGIN_NAME	A tag de cache origin é definida com base no nome da origem de onde o conteúdo foi buscado. O valor origin faz referência ao valor de .routing.routeRules[].origin e permite invalidar o conteúdo de um servidor de origem configurado incorretamente ou com comportamento inadequado.

Limitações das tags de cache

As tags de cache têm as seguintes restrições:

• Não pode exceder 120 bytes por tag
• Não pode exceder 4 KiB (4096 bytes) de nomes de tags no total por objeto armazenado em cache
• Não pode exceder 50 tags por objeto, sem incluir as tags padrão adicionadas pelo Media CDN
• Precisa ser um nome de token HTTP válido, conforme definido na seção 3.2.6 do HTTP RFC 7230.
• Não inclua os prefixos status=, origin= ou content-type= integrados (que são ignorados).

As tags que não se enquadram nesses limites ou não atendem a esses requisitos são ignoradas. Em alguns casos, como quando os cabeçalhos de resposta são muito grandes, a resposta falha e não é armazenada em cache.

Permissões

A permissão networkservices.EdgeCacheServices.invalidateCache controla o acesso à API invalidateCache. Essa permissão está incluída nos papéis do Identity and Access Management networkservices.edgeCacheAdmin e networkservices.edgeCacheUser.

Exemplos

Os exemplos a seguir mostram como invalidar as respostas em cache de um serviço de CDN de mídia.

É possível combinar os campos host, path e tags em uma única solicitação de invalidação para invalidar um conjunto específico de conteúdo.

Invalidar por host

Console

1. Acesse a página do Media CDN no console do Google Cloud.
   Acessar o Media CDN
2. Clique na guia Services.
3. Clique no seu serviço.
4. Clique na guia Invalidação de cache.
5. Para invalidar o padrão de caminho, insira um nome de host seguido de um caminho. Por exemplo, media.example.com/cats ou media.example.com/cat*. O nome do host não pode incluir *.

gcloud

gcloud edge-cache services invalidate-cache SERVICE_NAME \
    --host=HOST

Substitua:

• SERVICE_NAME pelo nome do serviço de cache do Edge.
• HOST com o nome de host completo da entrada de cache a ser invalidada.

Exemplo:

gcloud edge-cache services invalidate-cache SERVICE_NAME \
    --host="media.example.com"

Invalidar por caminho

Console

1. Acesse a página do Media CDN no console do Google Cloud.
   Acessar o Media CDN
2. Clique na guia Services.
3. Clique no seu serviço.
4. Clique na guia Invalidação de cache.
5. Para invalidar o padrão de caminho, insira um caminho. Por exemplo, /videos/funny.mp4 ou /segments/e94a6b1f731/*.

gcloud

gcloud edge-cache services invalidate-cache SERVICE_NAME \
    --path=PREFIX

Substitua:

• SERVICE_NAME pelo nome do serviço de cache do Edge.
• HOST com o nome do host das entradas de cache a serem invalidadas. Para fazer correspondência com qualquer nome de host, omita a flag de host.
• PREFIX com um prefixo de caminho que termina em "*" e corresponde às entradas de cache a serem invalidadas.

Exemplo:

gcloud edge-cache services invalidate-cache SERVICE_NAME \
    --path="/segments/e94a6b1f731/*"

Também é possível invalidar um caminho exato omitindo o caractere * final. A transmissão de --path="/videos/funny.mp4" invalida a resposta armazenada em cache (se houver) correspondente a esse caminho.

Invalidar por tag de cache

Observação: use host, caminho e tags juntos para reduzir o volume de conteúdo armazenado em cache invalidado ao mesmo tempo. As respostas invalidadas são buscadas novamente da origem por completo, e a invalidação de muito conteúdo ao mesmo tempo pode resultar em um aumento da carga no servidor de origem.

Console

A invalidação por tag de cache não é compatível com o console do Google Cloud.

gcloud

gcloud edge-cache services invalidate-cache SERVICE_NAME \
    --tags=TAGS

Substitua:

• SERVICE_NAME pelo nome do serviço de cache do Edge.
• TAGS por uma lista separada por vírgulas de tags.

Exemplo:

gcloud edge-cache services invalidate-cache SERVICE_NAME \
    --tags="status=404,content-type=text/plain"

Latência de invalidação

A invalidação de cache em milhares de locais do Media CDN geralmente é concluída em um minuto em todo o mundo.

Em alguns casos, a invalidação pode levar mais tempo, dependendo da carga do sistema, da conectividade e do volume de conteúdo invalidado.

Geração de registros

Se os registros de auditoria estiverem ativados, as chamadas de invalidação serão registradas no Cloud Logging.

Limitações

As invalidações são limitadas por taxa. Se você exceder o limite de taxa de invalidações, uma mensagem de erro HTTP 429 com o status RESOURCE_EXHAUSTED será exibida.

Uma invalidação pode ser de qualquer tamanho. Por exemplo, invalidar /images/my-image.png conta como uma invalidação. Invalidar /images/* também conta como uma invalidação.

Esse comportamento é diferente do comportamento no Cloud CDN. O Cloud CDN aceita uma invalidação por minuto.