Esta página descreve as ferramentas do Dispatcher e como baixá-las e extraí-las, os módulos compatíveis do Apache e fornece uma visão geral de alto nível dos modos herdados e flexíveis. Além disso, há mais referências sobre validação e depuração e migração da configuração do Dispatcher do AMS para o AEM as a Cloud Service.
As Ferramentas do Dispatcher fazem parte do SDK geral do AEM as a Cloud Service e fornecem:
As Ferramentas do Dispatcher, parte do SDK do AEM as a Cloud Service, podem ser baixadas de um arquivo zip no portal de Distribuição de softwares. Qualquer nova configuração disponível nessa nova versão das Ferramentas do Dispatcher pode ser usada para implantar em ambientes de nuvem que executam essa versão do AEM na nuvem ou posterior.
Descompacte o SDK, que contém as Ferramentas do Dispatcher para macOS, Linux® e Windows.
Para macOS/Linux, torne o artefato da ferramenta Dispatcher executável e execute-o. Ele extrai automaticamente os arquivos de Ferramentas do Dispatcher sob o diretório em que você o armazenou (onde version
é a versão das Ferramentas do Dispatcher).
$ chmod +x aem-sdk-dispatcher-tools-<version>-unix.sh
$ ./aem-sdk-dispatcher-tools-<version>-unix.sh
Verifying archive integrity... 100% All good.
Uncompressing aem-sdk-dispatcher-tools-<version>-unix.sh 100%
Para Windows, extraia o arquivo zip Ferramentas do Dispatcher.
As ferramentas do Dispatcher são usadas para validar e depurar a configuração do Dispatcher do projeto. Saiba mais sobre como usar essas ferramentas nas páginas referenciadas abaixo, com base no fato de a configuração do Dispatcher do seu projeto estar estruturada no modo flexível ou no modo herdado:
Modo flexível - o modo recomendado e o padrão para arquétipo 28 do AEM e superior, que também é usada pelo Cloud Manager para novos ambientes criados após a versão 2021.7.0 do Cloud Manager. Os clientes podem ativar esse modo adicionando a pasta e o arquivo opt-in/USE_SOURCES_DIRECTLY
. Ao usar esse modo mais flexível, não há limitações na estrutura de arquivos na pasta de regravações que, no modo herdado, exigia um único arquivo de rewrite.rules
. Além disso, não há limitação no número de regras que podem ser adicionadas. Para obter detalhes sobre a estrutura de pastas e a validação local, consulte Validação e depuração usando ferramentas do Dispatcher.
Modo herdado - para obter detalhes sobre a estrutura de pastas e a validação local do modo herdado de configuração do Dispatcher, consulte Validação e depuração usando ferramentas do Dispatcher (herdado)
Para obter mais informações sobre como migrar do modelo de configuração herdado para o mais flexível, fornecido com arquétipo 28 do AEM em diante, consulte esta documentação.
Para o nível de publicação, o padrão para o serviço de blobs é como um anexo. Substituir esta configuração usando o padrão cabeçalho de disposição de conteúdo no Dispatcher.
Veja abaixo um exemplo de como a configuração deve ser:
<LocationMatch "^\/content\/dam.*\.(pdf).*">
Header unset Content-Disposition
Header set Content-Disposition inline
</LocationMatch>
A tabela abaixo mostra os módulos compatíveis do Apache:
Os clientes não podem adicionar módulos arbitrários, no entanto, módulos adicionais podem ser considerados para inclusão futura. Os clientes podem encontrar a lista de diretivas disponíveis para uma determinada versão do Dispatcher executando o comando de lista de permissões do validador no SDK.
As diretivas permitidas nos arquivos de configuração do Apache podem ser listadas executando o comando de lista de permissões do validador:
$ validator allowlist
Cloud manager validator 2.0.4
Allowlisted directives:
<Directory>
...
A estrutura de pastas do Apache e Dispatcher do projeto é ligeiramente diferente com base no modo que o projeto está usando, conforme descrito na seção Validação e depuração usando as ferramentas do Dispatcher acima.
Para obter detalhes sobre como migrar a configuração do Dispatcher do AMS para o AEM as a Cloud Service, consulte a página Migrando a configuração do Dispatcher do AMS para o AEM as a Cloud Service.