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 Ignore Parameters
O recurso Parameter Actions da chave de cache personalizada e o recurso Ignore Parameters controlam o tratamento dos parâmetros de consulta da URL durante a geração das chaves de cache. Se ambos os recursos forem configurados simultaneamente, o Ignore Parameters perderá o efeito, pois as configurações de chave de cache personalizada no nível de regra substituem a configuração global do Ignore Parameters.
Ao usar operações de parâmetros para chaves de cache personalizadas, desative o recurso Ignore Parameters para evitar conflitos de regras. As operações de parâmetros incluem a funcionalidade do recurso Ignore Parameters (por meio das operações Delete ou Reserve) e oferecem controle mais flexível dos parâmetros.
Caso utilize o recurso Ignore Parameters, consulte a tabela a seguir para decidir se deve migrar para operações de parâmetros em 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, use as operações de parâmetros para chaves de cache personalizadas em vez do recurso Ignore Parameters.
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 correspondente à chave de cache nos PoPs do DCDN. Caso contrário, a operação de atualização não encontrará o conteúdo desejado.
Por exemplo, ao 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 torna-se 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.
Reescrita de URL de origem
O recurso de chave de cache personalizada afeta apenas a geração de chaves de cache nos PoPs do DCDN. Ele não modifica a URL real usada para buscar conteúdo na origem. Quando um PoP do DCDN busca dados na origem, usa a URL original da solicitação do cliente. Para reescrever os parâmetros ou o caminho da solicitação enviada à origem, use 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, ao buscar o conteúdo na origem, o PoP do DCDN 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 buscar conteúdo 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 um PoP do DCDN. Por padrão, 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, use uma Cachekey personalizada para anexar o valor do campo client à Cachekey. As duas solicitações serão então identificadas como duas Cachekeys diferentes.
Procedimento
Faça login no console do DCDN.
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, Parameter Actions, HTTP Headers e Custom Variables.
Parâmetro
Descrição
Rule Condition
Uma condição de regra determina se uma configuração se aplica a uma solicitação avaliando seus parâmetros.
ImportanteQuando um recurso referencia condições de regra configuradas no mecanismo de regras, a ordem de execução segue a prioridade das condições associadas, e não a ordem das configurações do recurso.
Do not use conditions: Desativa as regras condicionais.
Adicione ou edite regras condicionais no Rules engine.
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 houver múltiplas regras, a correspondência ocorrerá 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: Uma URI iniciada com barra (/), sem incluir o prefixo http:// ou o nome de domínio. Suporta expressões regulares
PCRE.Final URI: Uma URI iniciada com barra (/) e que não contenha o prefixo http:// ou nome de domínio.
Parameter Actions
Estas operações aplicam-se aos parâmetros de consulta na URL original da solicitação. Execute operações de Add, Delete, Modify ou Reserve nos parâmetros. Os parâmetros resultantes formam a string de consulta da chave de cache. Configure múltiplas operações para execução sequencial 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 passará a serhttp://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 passará a serhttp://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 passará a serhttp://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 passará a serhttp://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 sequencialmente à chave de cache.
Por exemplo, se a URL original for
http://image.example.com/cat.jpg, a solicitação do cliente incluir o cabeçalho HTTPpath: imagee você definir a configuração de HTTP Headers para incluir o cabeçalhopath, a chave de cache passará a serhttp://image.example.com/cat.jpgimage.Custom Variables
Adiciona informações de variáveis personalizadas à chave de cache gerada para aumentar a flexibilidade das configurações de cache. Uma variável personalizada inclui os seguintes parâmetros:
Variable Name: Nome personalizado para a variável.
Variable Source: Campo específico na solicitação do cliente usado como origem da variável.
Query String Parameter: String de consulta na URL da solicitação.
Request Header: Cabeçalho da solicitação do cliente.
Path: Caminho do recurso na URL da solicitação.
Scheme: Protocolo usado na URL da solicitação. Suporta HTTP e HTTPS.
Source Field Name: Aplicável aos três cenários a seguir:
Nome de um parâmetro de string de consulta especificado.
Nome de um cabeçalho de solicitação especificado.
Matching Rule: Expressão regular usada para corresponder a caracteres específicos no valor do campo.
Variable Expression: Usada para gerar o valor final da variável. Suporta strings fixas e expressões como
$1para referenciar o conteúdo do primeiro grupo de captura.
Clique em OK para concluir a configuração.
Exemplos de configuração
URIs
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.
Para operações de parâmetros, se múltiplas operações forem aplicadas à mesma variável, a prioridade será: 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 origem é Request Header, o nome do campo de origem é 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. A expressão da variável então anexará aa para criar o valor enaa. Este 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 origem é Request Cookie, o nome do campo de origem é 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. Este 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 origem é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, esta URL corresponde a/abc/xyz/(.*), momento em que$1recebe o valorabce é anexado à chave de cache para formar a chave 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.