Esta página descreve as ferramentas do Dispatcher e como baixá-las e extraí-las, os módulos de apache compatíveis e fornece uma visão geral de alto nível dos modos herdados e flexíveis. Além disso, há outras referências na validação e depuração, e na 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 agrupa 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 das Ferramentas do Dispatcher sob o diretório em que você os 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 seu projeto. Saiba mais sobre como usar essas ferramentas nas páginas referenciadas abaixo, com base em se a configuração do Dispatcher do seu projeto está estruturada em 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 para o modo herdado de configuração do Dispatcher, consulte Validação e depuração usando Ferramentas do Dispatcher (Herdadas)
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. Substitua essa 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 Apache compatíveis:
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 do Dispatcher do projeto será ligeiramente diferente com base em qual modo 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.