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 serviço de back-end com carga balanceada 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 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 específicos do Cloud Storage, que podem afetar a resposta e ser estendidos por uma lista personalizável de nomes de parâmetros.
Console
- No console do Google Cloud, acesse a página do Cloud CDN.
- Clique em Adicionar origem.
- No menu suspenso Origem, clique em Selecionar origem.
- Selecione a origem para a qual você quer ativar a CDN.
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.
Desmarque as caixas de seleção dos campos que você quer omitir da chave de cache desse serviço de back-end.
Clique em Salvar.
Clique em Adicionar.
gcloud
Especifique uma ou mais flags opcionais para excluir o componente 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
Atualizar 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
- No console do Google Cloud, acesse a página do Cloud CDN.
- Na linha do seu balanceador de carga, clique em Menu e em Editar.
- Na linha do bucket ou serviço de back-end que você quer modificar, clique em Configurar.
- Em Chave de cache, selecione Personalizado.
- Selecione as caixas de seleção Protocolo, Host e String de consulta.
- Deixe o campo Parâmetros de string de consulta em branco.
- Clique em Salvar.
- 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 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
- No console do Google Cloud, acesse a página do Cloud CDN.
- Na linha do seu balanceador de carga, clique em Menu e em Editar.
- Na linha do serviço de back-end que você quer modificar, clique em Configurar.
- Em Chave de cache, selecione Personalizado.
- Confirme se a caixa de seleção String de consulta está selecionada.
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.
Insira sua lista de strings separada por vírgulas no campo Parâmetros de string de consulta.
Clique em Salvar.
Clique em Atualizar.
gcloud
Use este comando para definir o parâmetro de string de consulta user na lista de inclusão 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 a lista de inclusão de um bucket de back-end.
gcloud compute backend-buckets update BACKEND_BUCKET \
--cache-key-query-string-whitelist user
Atualizar 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
- Para verificar se o Cloud CDN está exibindo respostas a partir do cache, consulte Registros e métricas para armazenamento em cache.