As chaves de cache personalizadas permitem gerar chaves de cache a partir de diferentes partes de uma solicitação HTTP, como URI, parâmetros de consulta, cabeçalhos HTTP ou variáveis personalizadas. Ao mapear solicitações semelhantes para o mesmo arquivo em uma única chave de cache, você melhora a taxa de acerto do cache, reduz as buscas na origem e diminui os tempos de resposta e o consumo de largura de banda.
Observações de uso
Chave de cache personalizada e Ignorar Parâmetros
O recurso Parameter Operations da chave de cache personalizada e o recurso Ignorar Parâmetros controlam se os parâmetros de consulta da URL são incluídos na geração da chave de cache. Habilitar ambos os recursos simultaneamente pode causar conflitos nas regras de geração da chave de cache, resultando em uma taxa de acerto menor ou conteúdo em cache anormal.
Se você utilizar operações de parâmetros para chaves de cache personalizadas, desabilite o recurso Ignorar Parâmetros para evitar conflitos de regras. As operações de parâmetros incluem a funcionalidade do recurso Ignorar Parâmetros (por meio das operações Delete ou Reserve) e oferecem controle de parâmetros mais flexível.
Caso utilize o recurso Ignorar Parâmetros, consulte a tabela a seguir para decidir se deve migrar para as operações de parâmetros das chaves de cache personalizadas.
|
Cenário |
Ignore Parameters |
Chave de cache personalizada |
|
Ignorar todos os parâmetros de consulta na chave de cache |
Defina Ignore Parameters como Yes e deixe Keep specified parameters vazio. |
Adicione uma regra de processamento para query parameters:
|
|
Manter apenas o parâmetro de consulta |
Defina Ignore Parameters como Yes e configure Keep specified parameters com |
Adicione uma regra de processamento para query parameters:
|
|
Excluir apenas o parâmetro de consulta |
Defina Delete specified parameters como |
Adicione uma regra de processamento para query parameters:
|
Para modificar valores de parâmetros ou adicionar parâmetros extras além de simplesmente ignorá-los ou mantê-los, utilize as operações de parâmetros das chaves de cache personalizadas em vez do recurso Ignorar Parâmetros.
Ordem de execução do mecanismo de regras
Quando este recurso referencia uma condição de regra do mecanismo de regras, a ordem de execução segue a prioridade da condição de regra no mecanismo de regras, e não a prioridade das regras configuradas neste recurso.
Atualização de cache
Após configurar uma chave de cache personalizada, os PoPs do DCDN indexam os arquivos em cache pela chave de cache processada. Ao atualizar o cache por URL, envie a URL que corresponde à chave de cache nos PoPs do DCDN. Caso contrário, a operação de atualização não encontrará o conteúdo alvo.
Por exemplo, se você configurar uma regra de substituição de URI para trocar /a/b/image.jpg por /c/image.jpg, a chave de cache do arquivo nos PoPs do DCDN se tornará http://aliyundoc.com/c/image.jpg. Para atualizar o cache desse arquivo, envie http://aliyundoc.com/c/image.jpg (a chave de cache processada), e não a URL original da solicitação do cliente.
Se configurar operações de parâmetros, como exclusão ou modificação, use a URL processada como endereço de atualização. Registre o formato final da chave de cache após configurar as regras de chave de cache personalizada para simplificar futuras operações de atualização de cache.
Reescrita de URL de origem
O recurso de chave de cache personalizada afeta apenas a geração das chaves de cache nos PoPs do DCDN. Ele não modifica a URL real usada para buscas na origem. Quando um PoP do DCDN busca conteúdo na origem, utiliza a URL original da solicitação do cliente. Para reescrever os parâmetros ou o caminho da solicitação enviada à origem, utilize o recurso de reescrita de URL de origem.
Por exemplo, um cliente solicita http://example.com/image.jpg?key1=1&key2=2. Você configura uma chave de cache personalizada para excluir o parâmetro key1. A chave de cache torna-se http://example.com/image.jpg?key2=2. No entanto, quando o PoP do DCDN busca o conteúdo na origem, ainda solicita a URL original: http://example.com/image.jpg?key1=1&key2=2.
Casos de uso
O recurso de chave de cache personalizada não modifica a URL usada para buscas na origem. Ele altera apenas o identificador de cache da solicitação. A solicitação enviada à origem permanece idêntica à solicitação original do cliente.
A chave de cache é o identificador exclusivo de um arquivo armazenado em cache em um PoP do DCDN. Por padrão, a chave de cache corresponde à URL completa da solicitação, incluindo os parâmetros de consulta.
Cenário 1
Quando solicitações de clientes para o mesmo arquivo contêm parâmetros de URL diferentes, os PoPs do DCDN as tratam como solicitações para arquivos distintos. Isso resulta em múltiplas cópias do mesmo arquivo em cache e aumenta as buscas na origem.
Use regras de chave de cache personalizada para unificar as chaves de cache de solicitações semelhantes e reduzir a taxa de busca na origem.
Cenário 2
O DCDN trata solicitações com a mesma URL como requisições para o mesmo arquivo. Contudo, o cabeçalho HTTP da solicitação contém um campo client para diferenciar sistemas clientes, e o objetivo é recuperar arquivos diferentes.
Nesse caso, utilize uma Cachekey personalizada para anexar o valor do campo client à Cachekey. Assim, as duas solicitações serão identificadas como duas Cachekeys diferentes.
Procedimento
Faça login no DCDN console.
No painel de navegação à esquerda, clique em Domain Names.
Na página Domain Names, localize o nome de domínio desejado e clique em Configure.
Na árvore de navegação à esquerda do nome de domínio, clique em Caching.
-
Na aba Custom Cache Key, configure a chave de cache.
NotaA chave de cache final combina quatro componentes: URI, ações de parâmetro, cabeçalhos HTTP e variáveis personalizadas.
Parâmetro
Descrição
Rule Condition
Uma condição de regra determina se uma configuração se aplica a uma solicitação avaliando os parâmetros nela contidos.
ImportanteQuando um recurso referencia condições de regra configuradas no mecanismo de regras, a ordem de execução segue a prioridade das condições de regra associadas, e não a ordem das configurações do recurso.
-
Do not use conditions: desabilita as regras condicionais.
-
Adicione ou edite regras condicionais no Mecanismo de regras.
URIs
Se a URI de uma solicitação do cliente corresponder à Source URI configurada, o sistema substituirá a Source URI pela Final URI configurada ao gerar a parte da URI da chave de cache.
É possível configurar várias regras de substituição de URI. Se existirem múltiplas regras, elas serão correspondidas sequencialmente de cima para baixo. Assim que uma Source URI for correspondida, o sistema usará a Final URI correspondente para a substituição e interromperá a verificação das regras subsequentes.
-
Source URI: URI que começa com uma barra (/), não incluindo o prefixo http:// ou o nome de domínio. Suporta expressões regulares
PCRE. -
Final URI: URI que começa com uma barra (/) e não contém o prefixo http:// ou um nome de domínio.
Parameter Actions
Estas operações aplicam-se aos parâmetros de consulta na URL original da solicitação. É possível executar operações de Add, Delete, Modify ou Reserve nos parâmetros. Os parâmetros resultantes formam a parte da string de consulta da chave de cache. Configure várias operações, que serão executadas sequencialmente de cima para baixo.
-
Add: anexa um novo parâmetro de consulta à chave de cache. Por exemplo, se a URL original for
http://image.example.com/cat.jpge você adicionar o parâmetro de consultatype=jpg, a chave de cache se tornaráhttp://image.example.com/cat.jpg?type=jpg. -
Delete: remove um parâmetro de consulta especificado da URL original da solicitação durante a geração da chave de cache. Por exemplo, se a URL original for
http://image.example.com/cat.jpg?type=jpge você excluir o parâmetrotype, a chave de cache se tornaráhttp://image.example.com/cat.jpg. -
Modify: modifica um parâmetro de consulta especificado na URL original da solicitação durante a geração da chave de cache. Por exemplo, se a URL original for
http://image.example.com/cat.jpg?type=jpge você modificar o parâmetro paratype=png, a chave de cache se tornaráhttp://image.example.com/cat.jpg?type=png. -
Reserve: mantém apenas os parâmetros de consulta especificados da URL original da solicitação durante a geração da chave de cache. Por exemplo, se a URL original for
http://image.example.com/cat.jpg?type=jpg&path=imagee você mantiver o parâmetrotype, a chave de cache se tornaráhttp://image.example.com/cat.jpg?type=jpg.
HTTP Headers
Anexa o valor de um cabeçalho HTTP especificado da solicitação original do cliente à chave de cache. Configure vários nomes de cabeçalhos HTTP separados por espaços. O valor de cada cabeçalho HTTP especificado é anexado à chave de cache sequencialmente.
Por exemplo, se a URL original for
http://image.example.com/cat.jpg, a solicitação do cliente incluir um cabeçalho HTTPpath: imagee você definir a configuração de HTTP Headers para incluir o cabeçalhopath, a chave de cache se tornaráhttp://image.example.com/cat.jpgimage.Custom Variables
Use expressões regulares para corresponder ao valor de um parâmetro de consulta, cabeçalho HTTP, parâmetro de cookie ou URI especificado da solicitação original do cliente. Se houver correspondência, o valor será anexado à chave de cache. Para obter detalhes, consulte Exemplos de configuração.
-
Clique em OK para concluir a configuração.
Exemplos de configuração
URIs
As solicitações para http://aliyundoc.com/a/b/image.jpg e http://aliyundoc.com/a/b/c/image.jpg são tratadas como solicitações para o mesmo arquivo. A chave de cache para este arquivo é http://aliyundoc.com/c/image.jpg.
Parameter Actions
Para uma solicitação de cliente para http://aliyundoc.com/a/b/image.jpg?delete_par=1&modify_par=1 , as regras adicionam add_par=1, excluem delete_par e modificam o valor de modify_par para 2. A chave de cache final é http://aliyundoc.com/a/b/image.jpg?modify_par=2&add_par=1.
Nas operações de parâmetros, se múltiplas operações forem aplicadas à mesma variável, a prioridade das operações será a seguinte: Add > Delete > Keep > Modify.
HTTP Headers
Os valores dos cabeçalhos HTTP User-Agent e Accept-Language da solicitação do cliente são anexados à chave de cache. Para uma solicitação para http://aliyundoc.com/a/b/image.jpg com User-Agent: Mozilla/5.0 (Linux; X11) e Accept-Language: en, a chave de cache resultante é http://aliyundoc.com/a/b/image.jpgMozilla/5.0(Linux;X11)en.
Custom Variables
Exemplo 1
O nome da variável é language, a source é Request Header, o nome do campo de source é Accept-Language, o padrão de correspondência é ([%w]+),([%w]+) e a expressão da variável é $1aa.
Se um cliente enviar uma solicitação para http://aliyundoc.com/a/b/image.jpg com o cabeçalho de solicitação HTTP Accept-Language=en,ch , o padrão de correspondência identificará en e o atribuirá a $1 na expressão da variável. Em seguida, a expressão da variável anexará aa para criar o valor enaa. Esse valor recebe o alias language e é anexado à URL para formar a chave de cache: http://aliyundoc.com/a/b/image.jpgenaa.
Em uma expressão de variável, $n representa o conteúdo capturado pelo nº par de parênteses no padrão de correspondência. Por exemplo, no Exemplo 1, se a entrada for Accept-Language=en,ch e o padrão de correspondência for ([%w]+),([%w]+), então $1=en e $2=ch.
Exemplo 2
O nome da variável é expired, a source é Request Cookie, o nome do campo de source é a, o padrão de correspondência é [%w]+:(.*) e a expressão da variável é $1.
Se um cliente solicitar http://aliyundoc.com/a/b/image.jpg com o cookie Cookie a=expired_time:12635187, o padrão de correspondência identificará 12635187. Esse valor é atribuído a $1 na expressão da variável com o alias expired e é anexado à URL para formar a Cachekey final: http://aliyundoc.com/a/b/image.jpg12635187.
Exemplo 3
Configure tanto regras de URI quanto variáveis personalizadas.
-
URI:
Reescreva todas as URIs de solicitação correspondentes a
/abc/.*/abcpara/abc.
-
Variável personalizada:
O nome da variável é
testname, a source éPath, o padrão de correspondência é/abc/xyz/(.*)e a expressão da variável é$1.
Para uma solicitação de cliente com a URL
http://aliyundoc.com/abc/xyz/abc/image.jpg, a chave de cache é normalizada parahttp://aliyundoc.com/abc/image.jpgcom base na configuração de URI. Em seguida, com base na configuração de variável personalizada, essa URL corresponde a/abc/xyz/(.*), momento em que$1recebe o valorabce é anexado à chave de cache para formar a chave de cache final:http://aliyundoc.com/abc/image.jpgabc. Isso permite que as duas regras trabalhem juntas para implementar uma lógica de cache mais complexa.Se uma variável personalizada para a Cachekey não tiver correspondência, a expressão da variável
$1não será concatenada à Cachekey.