Dispatcher i molnet

Introduktion

På den här sidan beskrivs dispatcherverktygen och hur du hämtar och extraherar dem, vilka cachemoduler som stöds och en översikt på hög nivå över de äldre och flexibla lägena. Dessutom finns det ytterligare referenser för validering och felsökning och migrering av Dispatcher-konfigurationen från AMS till AEM as a Cloud Service. Se även den här videon om du vill ha mer information om hur du distribuerar dispatcherfiler i en molntjänstmiljö.

Dispatcher Tools

Dispatcher-verktygen är en del av den övergripande AEM as a Cloud Service SDK:n och tillhandahåller:

  • En vaniljfilstruktur som innehåller de konfigurationsfiler som ska inkluderas i ett maven-projekt för Dispatcher.
  • Verktyg för kunder för att verifiera att Dispatcher-konfigurationen bara innehåller AEM as a Cloud Service direktiv som stöds. Dessutom validerar verktyget att syntaxen är korrekt så att apache kan startas korrekt.
  • En Docker-bild som öppnar Dispatcher lokalt.

Hämta och extrahera verktygen

Dispatcher Tools, en del av AEM as a Cloud Service SDK, kan laddas ned från en zip-fil i Programvarudistribution portal. Alla nya konfigurationer som är tillgängliga i den nya versionen av Dispatcher Tools 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 både macOS, Linux och Windows.

För macOS/Linux, gör att artefakten för verktyget Dispatcher kan köras. Dispatcher Tools-filerna extraheras automatiskt under den katalog som du lagrade dem i (var 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%

För Windows, extrahera zip-arkivet för Dispatcher Tooling.

Validera och felsöka med Dispatcher Tools

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

  • Flexibelt läge - det rekommenderade läget och standardvärdet för AEM 28 och senare, som också används av Cloud Manager för nya miljöer som skapats 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. Om du använder det här mer flexibla läget finns det inga begränsningar i filstrukturen i mappen för omskrivning som i det äldre läget krävde en enda 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 Tools.

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

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

Disposition av innehåll

För publiceringsskiktet är standardinställningen för att visa blober som en bifogad fil. Detta kan åsidosättas med hjälp av standarden dispositionshuvud för innehåll i dispatchern.

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

Tabellen nedan visar vilka cachemoduler 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. Kunder kan hitta listan över direktiv som är tillgängliga för en viss Dispatcher-version genom att köra validerarens tillåtslista-kommando i SDK:n.

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

Projektets mappstruktur för cache och dispatcher skiljer sig något åt beroende på vilket läge projektet använder, vilket beskrivs i Validera och felsöka med Dispatcher Tools ovan.

Migrera Dispatcher-konfigurationen från AMS

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

På denna sida