Dispatcher i molnet Dispatcher-in-the-cloud

Introduktion apache-and-dispatcher-configuration-and-testing

På den här sidan beskrivs Dispatcher-verktygen och hur du hämtar och extraherar dem, de Apache-moduler som stöds och en översikt över de äldre och flexibla lägena. Det finns även ytterligare referenser för validering och felsökning och migrering av Dispatcher-konfigurationen från AMS till AEM as a Cloud Service.

Dispatcher Tools dispatcher-sdk

Dispatcher Tools ingår i AEM as a Cloud Service SDK och ger

  • En vanilj-filstruktur som innehåller de konfigurationsfiler som ska inkluderas i ett Maven-projekt för Dispatcher.
  • Verktyg för kunder som validerar att Dispatcher-konfigurationen endast innehåller direktiv som stöds av AEM as a Cloud Service. Verktyget validerar också att syntaxen är korrekt så att Apache kan startas utan problem.
  • En Docker-bild som öppnar Dispatcher lokalt.

Hämta och extrahera verktygen extracting-the-sdk

Dispatcher-verktygen, som ingår i AEM as a Cloud Service SDK, kan hämtas från en zip-fil på Software Distribution -portalen. Alla nya konfigurationer som är tillgängliga i den nya Dispatcher Tools-versionen kan användas för att distribuera till molnmiljöer som kör den versionen av AEM i molnet eller senare.

Zippa upp SDK, som innehåller Dispatcher Tools för macOS, Linux® och Windows.

För macOS/Linux gör du Dispatcher-verktygets artefakt körbar och kör den. Det extraherar Dispatcher Tools-filerna under den katalog som du sparade dem i (där version är versionen av Dispatcher Tools).

$ 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%

Extrahera zip-arkivet för Dispatcher Tooling för Windows.

Validera och felsöka med Dispatcher Tools validation-debug

Dispatcher-verktygen används för att validera och felsöka ditt projekts Dispatcher-konfiguration. Läs mer om hur du använder dessa verktyg på de sidor som det hänvisas till nedan, baserat på om ditt projekts Dispatcher-konfiguration är strukturerad i flexibelt läge eller äldre läge:

  • Flexibelt läge - det rekommenderade läget och standardvärdet för AEM architype 28 och senare, som också används av Cloud Manager för nya miljöer som skapas efter Cloud Manager 2021.7.0. Kunder kan aktivera det här läget genom att lägga till mappen och filen opt-in/USE_SOURCES_DIRECTLY. Genom att använda det här mer flexibla läget finns det inga begränsningar i filstrukturen i mappen för omskrivningar som i det äldre läget krävde en enskild rewrite.rules-fil. Det finns heller ingen begränsning för hur många regler du kan lägga till. Mer information om mappstruktur och lokal validering finns i Validera och felsöka med Dispatcher-verktyg.

  • Äldre läge - mer information om mappstrukturen och lokal validering för äldre Dispatcher-konfigurationsläge finns i Validera och felsöka med Dispatcher-verktyg (äldre)

Mer information om hur du migrerar från den äldre konfigurationsmodellen till den mer flexibla, som finns i AEM 28 och framåt, finns i den här dokumentationen.

Disposition av innehåll content-disposition

För publiceringsskiktet är standardinställningen för att visa blober som en bifogad fil. Åsidosätt den här inställningen med standarddispositionsrubriken för innehåll i Dispatcher.

Nedan visas ett exempel på hur konfigurationen ska se ut:

<LocationMatch "^\/content\/dam.*\.(pdf).*">
 Header unset Content-Disposition
 Header set Content-Disposition inline
</LocationMatch>

Apache-moduler som stöds supported-directives

Tabellen nedan visar vilka Apache-moduler som stöds:

Modulnamn
Referenssida
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
mod_macro
https://httpd.apache.org/docs/2.4/mod/mod_macro.html
mod_include (no directives supported)
https://httpd.apache.org/docs/2.4/mod/mod_include.html

Kunder kan inte lägga till godtyckliga moduler, men ytterligare moduler kan övervägas för framtida införande. Kunderna hittar listan över direktiv som är tillgängliga för en viss Dispatcher-version genom att köra validerarens tillåtelselista-kommando i SDK.

De direktiv som är tillåtna i Apache-konfigurationsfiler kan listas genom att köra validerarens tillåtelselista-kommando:

$ validator allowlist
Cloud manager validator 2.0.4

Allowlisted directives:
  <Directory>
  ...

Mappstruktur folder-structure

Projektets mappstruktur Apache och Dispatcher skiljer sig något åt beroende på vilket läge projektet använder, vilket beskrivs i avsnittet Validering och felsökning i Dispatcher-verktygen ovan.

Migrera Dispatcher-konfigurationen från AMS ams-aem

Mer information om hur du migrerar Dispatcher-konfigurationen från AMS till AEM as a Cloud Service finns i as a Cloud Service Migrera Dispatcher-konfigurationen från AMS till AEM.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab