Dispatcher na nuvem

Introdução

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.

Ferramentas do Dispatcher

As Ferramentas do Dispatcher fazem parte do SDK AEM as a Cloud Service geral e fornecem:

  • Uma estrutura de arquivo baunilha contendo os arquivos de configuração a serem incluídos em um projeto maven para o Dispatcher.
  • Ferramentas para clientes validarem se a configuração do Dispatcher inclui apenas AEM diretivas suportadas as a Cloud Service. Além disso, a ferramenta também valida que a sintaxe está correta para que o apache possa ser iniciado com êxito.
  • Uma imagem Docker que exibe o Dispatcher localmente.

Download e extração de ferramentas

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.

Validação e depuração usando as 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 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.

Módulos Apache Suportados

A tabela abaixo mostra os módulos apache suportados:

Nome do módulo Página de referência
core https://httpd.apache.org/docs/2.4/mod/core.html
mod_access_compat https://httpd.apache.org/docs/2.4/mod/mod_access_compat.html
mod_alias https://httpd.apache.org/docs/2.4/mod/mod_alias.html
mod_allowmethods https://httpd.apache.org/docs/2.4/mod/mod_allowmethods.html
mod_authn_core https://httpd.apache.org/docs/2.4/mod/mod_authn_core.html
mod_authn_file https://httpd.apache.org/docs/2.4/mod/core.html
mod_authz_core https://httpd.apache.org/docs/2.4/mod/core.html
mod_authz_groupfile https://httpd.apache.org/docs/2.4/mod/mod_authz_groupfile.html
mod_deflate https://httpd.apache.org/docs/2.4/mod/mod_deflate.html
mod_dir https://httpd.apache.org/docs/2.4/mod/mod_dir.html
mod_env https://httpd.apache.org/docs/2.4/mod/mod_env.html
mod_filter https://httpd.apache.org/docs/2.4/mod/mod_filter.html
mod_headers https://httpd.apache.org/docs/2.4/mod/mod_headers.html
mod_mime https://httpd.apache.org/docs/2.4/mod/mod_mime.html
mod_proxy https://httpd.apache.org/docs/2.4/mod/mod_proxy.html
mod_proxy_http https://httpd.apache.org/docs/2.4/mod/mod_proxy_http.html
mod_remoteip https://httpd.apache.org/docs/2.4/mod/mod_remoteip.html
mod_reqtimeout https://httpd.apache.org/docs/2.4/mod/mod_reqtimeout.html
mod_rewrite https://httpd.apache.org/docs/2.4/mod/mod_rewrite.html
mod_security https://modsecurity.org/
mod_setenvif https://httpd.apache.org/docs/2.4/mod/mod_setenvif.html
mod_ssl (only the SSLProxyEngine directive) https://httpd.apache.org/docs/2.4/mod/mod_ssl.html#sslproxyengine
mod_substitute https://httpd.apache.org/docs/2.4/mod/mod_substitute.html
mod_userdir https://httpd.apache.org/docs/2.4/mod/mod_userdir.html

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>
  ...

Estrutura da pasta

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.

Migração da configuração do Dispatcher do AMS

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.

Nesta página