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 e personalizar as chaves de cache
Essas instruções ativam o Cloud CDN para um bucket ou 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.
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 Save.
Clique em Adicionar.
gcloud
Especifique uma ou mais sinalizações opcionais para excluir esse parâmetro das chaves de cache do bucket ou serviço de back-end.
gcloud compute backend-services update BACKEND_SERVICE \
--enable-cdn
gcloud compute backend-buckets update BACKEND_BUCKET \
--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
- 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 Save.
- 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
gcloud compute backend-buckets update BACKEND_BUCKET \
--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
- 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 Save.
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
Como 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
No momento, o console do Google Cloud não é compatível com este 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,...]
Como atualizar chaves de cache para usar cookies nomeados
Estas instruções definem as chaves de cache do Cloud CDN para usar cookies HTTP.
Console
No momento, o console do Google Cloud não é compatível com este 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 Como visualizar registros.