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 migração da configuração do Dispatcher do AMS para o AEM as a Cloud Service. Além disso, consulte este vídeo para obter detalhes adicionais sobre a implantação de arquivos do dispatcher em um ambiente do cloud service.
As Ferramentas do Dispatcher fazem parte do SDK AEM as a Cloud Service geral e fornecem:
As Ferramentas do Dispatcher, parte do AEM SDK as a Cloud Service, pode ser baixado de um arquivo zip no Distribuição de software portal. Qualquer nova configuração disponível nessa nova versão das Ferramentas do Dispatcher pode ser usada para implantar em ambientes do Cloud que executam essa versão de AEM na Cloud 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 extrairá 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 Dispatcher Tool.
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 AEM arquétipo 28 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, exigiam uma única rewrite.rules
arquivo. 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 AEM arquétipo 28 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. Isso pode ser substituído 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 suportados:
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 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 o Migração da configuração do Dispatcher do AMS para o AEM as a Cloud Service página.