Diese Seite beschreibt die Dispatcher-Tools und erklärt, wie man sie herunterlädt und entpackt. Außerdem werden die unterstützten Apache-Module vorgestellt und ein Überblick über den alten und den flexiblen Modus gegeben. Außerdem gibt es weitere Hinweise zur Validierung und Fehlerbehebung sowie zur Migration der Dispatcher-Konfiguration von AMS zu AEM as a Cloud Service.
Die Dispatcher Tools sind Teil des gesamten AEM as a Cloud Service-SDK und bieten:
Die Dispatcher Tools, die zum AEM as a Cloud Service-SDK gehören, können aus einer ZIP-Datei im Software-Verteilungs-Portal heruntergeladen werden. Jede neue Konfiguration, die in dieser neuen Version der Dispatcher-Tools verfügbar ist, kann für die Bereitstellung in Cloud-Umgebungen verwendet werden, in denen diese Version von AEM as a Cloud Service oder höher ausgeführt wird.
Entpacken Sie das SDK, das die Dispatcher-Tools für macOS, Linux® und Windows enthält.
Machen Sie unter macOS/Linux das Dispatcher Tool-Artefakt ausführbar und führen Sie es aus. Es entpackt die Dateien der Dispatcher Tools selbständig in das Verzeichnis, in dem Sie es gespeichert haben (wobei version
die Version der Dispatcher Tools ist).
$ 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%
Extrahieren Sie unter Windows das ZIP-Archiv für die Dispatcher-Tools.
Mit den Dispatcher-Tools können Sie die Dispatcher-Konfiguration Ihres Projekts validieren und debuggen. Auf den unten referenzierten Seiten erfahren Sie mehr darüber, wie Sie diese Tools verwenden können, je nachdem, ob die Dispatcher-Konfiguration Ihres Projekts im flexiblen Modus oder im alten Modus strukturiert ist:
Flexibler Modus: Der empfohlene Modus und der Standard für AEM-Archetyp 28 und höher, der auch von Cloud Manager für neue Umgebungen verwendet wird, die nach der Cloud Manager-Version 2021.7.0 erstellt wurden. Kunden können diesen Modus aktivieren, indem sie den Ordner und die Datei opt-in/USE_SOURCES_DIRECTLY
hinzufügen. Durch die Verwendung dieses flexibleren Modus gibt es keine Einschränkungen in der Dateistruktur unter dem Ordner „rewrites“, der im alten Modus eine einzelne rewrite.rules
-Datei erforderte. Außerdem gibt es keine Beschränkung für die Anzahl der Regeln, die Sie hinzufügen können. Einzelheiten zur Ordnerstruktur und zur lokalen Validierung finden Sie unter Validieren und Debuggen mithilfe von Dispatcher-Tools.
Alter Modus: Einzelheiten zur Ordnerstruktur und lokalen Validierung für den alten Modus der Dispatcher-Konfiguration finden Sie unter Validieren und Debuggen mithilfe von Dispatcher-Tools (alt).
Weitere Informationen zum Migrieren vom alten Konfigurationsmodell zum flexibleren Konfigurationsmodell, das ab AEM-Archetyp 28 bereitgestellt wird, finden Sie in dieser Dokumentation.
Auf der Veröffentlichungsebene werden Blobs standardmäßig als Anhang bereitgestellt. Überschreiben Sie diese Einstellung mit dem Standard Content-Disposition-Header im Dispatcher.
Im Folgenden finden Sie ein Beispiel dafür, wie die Konfiguration aussehen sollte:
<LocationMatch "^\/content\/dam.*\.(pdf).*">
Header unset Content-Disposition
Header set Content-Disposition inline
</LocationMatch>
In der folgenden Tabelle werden die unterstützten Apache-Module angezeigt:
Kunden können keine beliebigen Module hinzufügen. Es werden jedoch ggf. zusätzliche Module in Betracht gezogen, die in Zukunft in das Produkt aufgenommen werden. Kunden erhalten die Liste der für eine bestimmte Dispatcher-Version verfügbaren Anweisungen, indem sie den Zulassungslistenbefehl des Validators im SDK ausführen.
Die in den Apache-Konfigurationsdateien zulässigen Anweisungen können aufgelistet werden, indem Sie den Zulassungslistenbefehl des Validators ausführen:
$ validator allowlist
Cloud manager validator 2.0.4
Allowlisted directives:
<Directory>
...
Die Struktur des Apache- und Dispatcher-Ordners des Projekts unterscheidet sich geringfügig je nachdem, welcher Modus vom Projekt verwendet wird, wie im Abschnitt Validieren und Debuggen mithilfe von Dispatcher-Tools oben beschrieben.
Weitere Informationen zum Migrieren der Dispatcher-Konfiguration von AMS zu AEM as a Cloud Service finden Sie auf der Seite Migrieren der Dispatcher-Konfiguration von AMS zu AEM as a Cloud Service.