Personalizar chaves de cache

Nesta página, você verá como personalizar as chaves de cache do Cloud CDN.

Alterar a configuração da chave de cache pode resultar em uma queda súbita na proporção de ocorrência em cache se as novas solicitações começarem a usar chaves de cache diferentes das entradas antigas. Da mesma forma, alterar o criador da chave de cache não invalida as entradas armazenadas em cache se as novas solicitações usarem chaves iguais às antigas. Para invalidar entradas de cache atuais, consulte Como invalidar conteúdo em cache.

Antes de começar

Para compreender o conteúdo desta página, é preciso já ter conhecimento sobre o Cloud CDN, as chaves de cache dessa solução e os serviços de back-end com carga balanceada. Recomendamos que você consulte essas páginas antes de continuar.

Ativar o Cloud CDN e personalizar as chaves de cache

Essas instruções ativam o Cloud CDN para um back-end com carga balanceada e personalize a chave de cache excluindo um ou mais componentes de solução. Se você ainda não tem um balanceador de carga para usar como origem, consulte a documentação do balanceador de carga de aplicativo externo para saber como criar um.

Os buckets de back-end não incluem o protocolo ou o host na chave de cache porque eles não influenciam como os objetos são referenciados em um bucket do Cloud Storage. No entanto, eles incluem um conjunto de parâmetros de string de consulta que são específico para o Cloud Storage, o que pode afetar a resposta ser estendida por uma lista personalizável de nomes de parâmetros.

Console

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

    Acessar o Cloud CDN

  2. Clique em Adicionar origem.
  3. No menu suspenso Origem, clique em Selecionar origem.
  4. Selecione a origem para a qual você quer ativar a CDN.
  5. Na linha da origem, clique em Configurar.

    Se o Cloud CDN já estiver ativado nessa origem, primeiro clique no menu , selecione Editar e, em seguida, clique em Configurar.

  6. Desmarque as caixas de seleção dos campos que você quer omitir da chave de cache desse serviço de back-end.

  7. Clique em Salvar.

  8. Clique em Adicionar.

gcloud

Especifique uma ou mais sinalizações opcionais para excluir o componente das chaves de cache deste serviço de back-end.

gcloud compute backend-services update BACKEND_SERVICE \
    --enable-cdn

Sinalizações opcionais:

  • --no-cache-key-include-protocol
  • --no-cache-key-include-host
  • --no-cache-key-include-query-string

Atualize as chaves de cache para adicionar novamente o protocolo, o host e a string de consulta

Por padrão, os serviços de back-end configurados para usar o Cloud CDN incluem todos os componentes do URI de solicitação em chaves de cache. Se você indicou antes que um ou mais componentes precisam ser excluídos, siga as etapas abaixo para incluí-los novamente.

Essas instruções adicionam novamente o protocolo, o host e a string de consulta à chave de cache para um serviço de back-end que já tenha o Cloud CDN ativado.

Console

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

    Acessar o Cloud CDN

  2. Na linha do seu balanceador de carga, clique em Menu e em Editar.
  3. Na linha do bucket ou serviço de back-end que você quer modificar, clique em Configurar.
  4. Em Chave de cache, selecione Personalizado.
  5. Selecione as caixas de seleção Protocolo, Host e String de consulta.
  6. Deixe o campo Parâmetros de string de consulta em branco.
  7. Clique em Salvar.
  8. Clique em Atualizar.

gcloud

Para adicionar novamente apenas um componente, especifique apenas a sinalização correspondente. As sinalizações não especificadas permanecem inalteradas.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-protocol \
    --cache-key-include-host \
    --cache-key-include-query-string

Atualizar as chaves de cache para usar uma lista de inclusão ou exclusão de parâmetros de string de consulta

Estas instruções definem as chaves de cache do Cloud CDN para usar uma lista de inclusão ou exclusão com parâmetros de strings de consulta.

Console

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

    Acessar o Cloud CDN

  2. Na linha do seu balanceador de carga, clique em Menu e em Editar.
  3. Na linha do serviço de back-end que você quer modificar, clique em Configurar.
  4. Em Chave de cache, selecione Personalizado.
  5. Confirme se a caixa de seleção String de consulta está selecionada.
  6. Se você quiser especificar parâmetros de string de consulta que façam parte da chave de cache, selecione Incluir apenas selecionados.

    Se você quiser especificar todos os parâmetros de string de consulta, exceto aqueles que estiverem listados na chave de cache, selecione Incluir todos, exceto os selecionados.

  7. Insira sua lista de strings separada por vírgulas no campo Parâmetros de string de consulta.

  8. Clique em Salvar.

  9. Clique em Atualizar.

gcloud

Use este comando para definir o parâmetro de string de consulta user para incluir lista de um serviço de back-end.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-query-string \
    --cache-key-query-string-whitelist user

Use este comando para definir o parâmetro de string de consulta user na lista de exclusão de um serviço de back-end.

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-query-string \
    --cache-key-query-string-blacklist user

Use este comando para definir o parâmetro de string de consulta user para incluir lista de um bucket de back-end.

gcloud compute backend-buckets update BACKEND_BUCKET \
    --cache-key-query-string-whitelist user

Atualizar as chaves de cache para usar cabeçalhos HTTP

Estas instruções definem as chaves de cache do Cloud CDN para usar cabeçalhos HTTP.

Console

O console do Google Cloud não é compatível com esse recurso.

gcloud

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-http-header=[HEADER_FIELD_NAME,...]
gcloud compute backend-buckets update BACKEND_BUCKET \
    --cache-key-include-http-header=[HEADER_FIELD_NAME,...]

Atualizar chaves de cache para usar cookies nomeados

Estas instruções definem as chaves de cache do Cloud CDN para usar cookies HTTP.

Console

O console do Google Cloud não é compatível com esse recurso.

gcloud

gcloud compute backend-services update BACKEND_SERVICE \
    --cache-key-include-named-cookie=[NAMED_COOKIE,...]

A seguir