Perguntas frequentes sobre os principais problemas do AEM Dispatcher

Last update: Sat May 20 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Dispatcher

Criado para:

Admin

Configuração do Dispatcher

Introdução

O que é o Dispatcher?

O Dispatcher é uma ferramenta de armazenamento em cache e/ou balanceamento de carga do Adobe Experience Manager que ajuda a possibilitar um ambiente de criação da web rápido e dinâmico. Para armazenamento em cache, o Dispatcher funciona como parte de um servidor HTTP, como o Apache. Ele tem o objetivo de armazenar (em cache) o máximo possível do conteúdo estático do site e diminuir ao máximo a frequência de uso do mecanismo de layout do site. Como um balanceador de carga, o Dispatcher distribui as solicitações de usuário (carga) entre as diferentes instâncias do AEM (renderizações).

Para armazenamento em cache, o módulo Dispatcher usa a capacidade do servidor Web de fornecer conteúdo estático. O Dispatcher coloca os documentos em cache na raiz do documento do servidor web.

Como o Dispatcher executa o armazenamento em cache?

O Dispatcher usa a capacidade do servidor Web de fornecer conteúdo estático. O Dispatcher armazena os documentos em cache na raiz de documentos do servidor web. O Dispatcher tem dois métodos primários para atualizar o conteúdo em cache quando mudanças são feitas no site.

As atualizações de conteúdo removem as páginas que foram alteradas e os arquivos que estão diretamente associados a elas.
A invalidação automática invalida automaticamente as partes do cache que podem estar desatualizadas após uma atualização. Por exemplo, ela marca de forma eficaz as páginas relevantes como desatualizadas, sem excluir nada.

Quais são os benefícios do balanceamento de carga?

O balanceamento de carga distribui as solicitações de usuário (carga) entre várias instâncias do AEM. A lista a seguir descreve as vantagens do balanceamento de carga:

Maior poder de processamento: na prática, isso significa que o Dispatcher compartilha as solicitações de documento entre várias instâncias do AEM. Como cada instância tem menos documentos para processar, você tem tempos de resposta mais rápidos. O Dispatcher mantém estatísticas internas para cada categoria de documento, de modo que ele possa estimar o carregamento e distribuir as consultas com eficiência.
Maior cobertura à prova de falhas: se o Dispatcher não receber respostas de uma instância, ele transmitirá automaticamente as solicitações para uma das outras instâncias. Assim, se uma instância se tornar indisponível, o único efeito é uma desaceleração do site, proporcional à potência computacional perdida.

NOTE

Para obter mais detalhes, consulte a página de Visão geral do Dispatcher

Instalação e configuração

De onde baixar o módulo Dispatcher?

Você pode baixar o módulo Dispatcher mais recente na página Notas de versão do Dispatcher.

Como configurar o Dispatcher com vários domínios?

Você pode configurar o Dispatcher CQ com vários domínios, desde que os domínios satisfaçam às seguintes condições:

O conteúdo da Web de ambos os domínios deve ser armazenado em um único repositório do AEM
Os arquivos no cache do Dispatcher podem ser invalidados separadamente para cada domínio

Leia Uso do Dispatcher com vários domínios para obter mais detalhes.

Como configurar o Dispatcher, de modo que todas as solicitações de um usuário sejam roteadas para a mesma instância de publicação?

Você pode usar o recurso conexões aderentes, que garante que todos os documentos de um usuário sejam processados na mesma instância do AEM. Esse recurso é importante se você usar páginas personalizadas e dados de sessão. Os dados são armazenados na instância. Portanto, as solicitações subsequentes do mesmo usuário devem retornar a essa instância ou os dados serão perdidos.

Como as conexões aderentes restringem a capacidade do Dispatcher de otimizar as solicitações, você deve usar essa abordagem somente quando necessário. Você pode especificar a pasta que contém os documentos "fixos", garantindo que todos os documentos dessa pasta sejam processados na mesma instância para um usuário.

Posso usar conexões aderentes e armazenamento em cache em conjunto?

Para a maioria das páginas que usam conexões aderentes, você deve desativar o armazenamento em cache. Caso contrário, a mesma instância da página será exibida para todos os usuários, independentemente do conteúdo da sessão.

Para alguns aplicativos, pode ser possível usar conexões aderentes e armazenamento em cache. Por exemplo, se você exibir um formulário que grava dados em uma sessão, será possível usar conexões aderentes e armazenamento em cache em conjunto.

Um Dispatcher e uma instância de publicação do AEM podem residir no mesmo computador?

Sim, se o computador for suficientemente eficiente. No entanto, é recomendável configurar o Dispatcher e a instância de publicação do AEM em computadores diferentes.

Normalmente, a instância de publicação reside dentro do firewall, e o Dispatcher reside no DMZ. Se decidir manter a instância de publicação e o Dispatcher no mesmo computador, verifique se as configurações de firewall proíbem o acesso direto à instância de publicação por meio de redes externas.

Posso armazenar em cache somente arquivos com extensões específicas?

Sim. Por exemplo, se você quiser armazenar em cache somente arquivos GIF, especifique *.gif, na seção de cache do arquivo de configuração dispatcher.any.

Como excluir arquivos do cache?

Você pode excluir arquivos do cache usando uma solicitação HTTP. Quando a solicitação HTTP é recebida, o Dispatcher exclui os arquivos do cache. O Dispatcher armazena os arquivos em cache novamente somente quando recebe uma solicitação do cliente para a página. A exclusão de arquivos em cache dessa maneira é adequada para sites que provavelmente não receberão solicitações simultâneas para a mesma página.

A solicitação HTTP tem a seguinte sintaxe:

POST /dispatcher/invalidate.cache HTTP/1.1
CQ-Action: Activate
CQ-Handle: path-pattern
Content-Length: 0

O Dispatcher exclui os arquivos e pastas em cache que têm nomes que correspondem ao valor do cabeçalho CQ-Handle. Por exemplo, um CQ-Handle de /content/geomtrixx-outdoors/en corresponde aos seguintes itens:

Todos os arquivos (de qualquer extensão de arquivo) com o nome de “en” no diretório geometrixx-outdoors.
Qualquer diretório com o nome de _jcr_content que esteja abaixo do diretório “en” (que, se existir, contém renderizações em cache de subnós da página).
O diretório en só será excluído se a CQ-Action for Delete ou Deactivate.

Para obter mais detalhes sobre este tópico, consulte Invalidação manual do cache do Dispatcher.

Como implementar o armazenamento em cache sensível a permissões?

Consulte a página Armazenamento em cache de conteúdo seguro.

Como proteger as comunicações entre as instâncias do Dispatcher e do CQ?

Consulte as páginas Lista de verificação de segurança do Dispatcher e Lista de verificação de segurança do AEM.

Problema do Dispatcher `jcr:content` alterado para `jcr%3acontent`

Pergunta: recentemente, a empresa enfrentou um problema no nível do Dispatcher. Uma das chamadas AJAX que estava recebendo alguns dados do repositório CQ continha jcr:content. Isso foi codificado em jcr%3acontent, resultando no conjunto de resultados incorreto.

Resposta: use o método ResourceResolver.map() para obter um URL “amigável” a ser usado/emitido para receber solicitações e também para solucionar problemas de armazenamento em cache do Dispatcher. O método map() codifica os dois pontos : como sublinhados e o método resolve() os decodifica novamente no formato legível do SLING JCR. Use o método map() para gerar o URL usado na chamada AJAX.

Limpar o Dispatcher

Como configurar agentes de limpeza do Dispatcher em uma instância de publicação?

Consulte a página Replicação.

Como solucionar problemas de limpeza do Dispatcher?

Consulte estes artigos de solução de problemas.

Se as operações de exclusão estiverem fazendo com que o Dispatcher libere, use a solução alternativa nesta publicação de blog da comunidade, por Sensei Martin.

Como liberar ativos DAM do cache do Dispatcher?

Você pode usar o recurso de “replicação em cadeia”. Com esse recurso ativado, o agente de limpeza do Dispatcher envia uma solicitação de limpeza quando uma replicação é recebida do autor.

Para habilitá-lo:

Siga as etapas aqui para criar agentes de liberação ao publicar
Acesse a configuração de cada um dos agentes e, na guia Acionadores, marque a caixa Ao receber.

Diversos

Como o Dispatcher determina se um documento está atualizado?
Para determinar se um documento está atualizado, o Dispatcher executa estas ações:

Verifica se o documento está sujeito a invalidação automática. Caso contrário, o documento será considerado atualizado.
Se o documento estiver configurado para invalidação automática, o Dispatcher verificará se ele é mais antigo ou mais recente do que a última alteração disponível. Se for mais antigo, o Dispatcher solicitará a versão atual da instância do AEM e substituirá a versão no cache.

Como o Dispatcher retorna documentos?

Você pode definir se o Dispatcher armazena em cache um documento usando o arquivo Configuração do Dispatcher, dispatcher.any. O Dispatcher verifica a solicitação em relação à lista de documentos que podem ser armazenados em cache. Se o documento não estiver nessa lista, o Dispatcher solicitará o documento da instância do AEM.

A propriedade /rules controla quais documentos são armazenados em cache de acordo com o caminho do documento. Independentemente da propriedade /rules, o Dispatcher nunca armazena em cache um documento nas seguintes circunstâncias:

O URI da solicitação contém um ponto de interrogação (?).
Isso indica uma página dinâmica, como um resultado de pesquisa, que não precisa ser armazenada em cache.
A extensão do arquivo está ausente.
O servidor web precisa da extensão para determinar o tipo de documento (o tipo MIME).
O cabeçalho de autenticação está definido (configurável).
Se a instância do AEM responder com os seguintes cabeçalhos:
- no-cache
- no-store
- must-revalidate

O Dispatcher armazena os arquivos em cache no servidor Web como se fossem parte de um site estático. Se um usuário solicitar um documento armazenado em cache, o Dispatcher verificará se esse documento existe no sistema de arquivos do servidor Web. Nesse caso, o Dispatcher retornará os documentos. Se não estiver em cache, o Dispatcher solicitará o documento da instância do AEM.