Uso das 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.

Como ativar o Cloud CDN para um serviço de back-end e personalizar as chaves de cache

Essas instruções ativam o CDN para a carga balanceada dos serviços de back-end e personalizam a chave de cache excluindo um ou mais componentes. Se você ainda não tem um balanceador de carga para usar como origem, consulte a documentação do Balanceamento de carga HTTP(S) externo para saber como criar um.

Console

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

    Acessar a página do 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.
  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 Save.
  8. Clique em Adicionar.

gcloud

Especifique uma ou mais sinalizações opcionais para excluir o parâmetro das chaves de cache para este 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 atual que tenha o CDN ativado.

Console

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

    Acessar a página do 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. 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 Save.
  8. Clique em Atualizar.

gcloud

Para adicionar novamente 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

Como atualizar as chaves de cache para usar uma lista de inclusão ou exclusão de strings de consulta

Estas instruções definem as chaves de cache do 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 a página do 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 (whitelist) 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 (blacklist).

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

  8. Clique em Save.

  9. Clique em Atualizar.

gcloud

Use este comando para definir a string user como a lista de inclusão.

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

Use este comando para adicionar a string user a uma lista de exclusão.

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

A seguir