Cette page décrit les outils Dispatcher, ainsi que la manière de les télécharger et de les extraire. Elle décrit en outre les modules Apache pris en charge et fournit un aperçu général des modes hérités et flexibles. Elle contient également d’autres références sur la validation, le débogage et la migration de la configuration de Dispatcher d’AMS vers AEM as a Cloud Service.
Les outils Dispatcher font partie du SDK global d’AEM as a Cloud Service et fournissent les éléments suivants :
Les outils Dispatcher, qui font partie du SDK AEM as a Cloud Service, peuvent être téléchargés sous la forme d’un fichier zip sur le portail de distribution de logiciels. Toute nouvelle configuration disponible dans cette nouvelle version des outils Dispatcher peut être utilisée pour le déploiement dans les environnements cloud exécutant cette version d’AEM en mode cloud ou une version ultérieure.
Décompressez le SDK, qui regroupe les outils Dispatcher pour macOS, Linux® et Windows.
Pour macOS/Linux, rendez l’artefact de l’outil Dispatcher exécutable et exécutez-le. Il extrait automatiquement les fichiers des outils Dispatcher au sein du répertoire dans lequel vous l’avez stocké (où version
est la version des outils 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%
Pour Windows, extrayez le fichier d’archive compressé Dispatcher Tooling.
Les outils Dispatcher sont utilisés pour valider et déboguer la configuration Dispatcher de votre projet. Découvrez comment utiliser ces outils dans les pages référencées ci-dessous, en fonction de la configuration du Dispatcher de votre projet, structurée en mode flexible ou en mode hérité :
Mode flexible : le mode recommandé et la valeur par défaut de l’archétype 28 d’AEM et versions ultérieures, également utilisés par Cloud Manager pour les nouveaux environnements créés après la version 2021.7.0 de Cloud Manager. Les clients peuvent activer ce mode en ajoutant le dossier et le fichier opt-in/USE_SOURCES_DIRECTLY
. En utilisant ce mode plus flexible, il n’existe aucune limite dans la structure de fichiers sous le dossier de réécritures qui, en mode hérité, nécessitait un seul fichier rewrite.rules
. En outre, il n’y a aucune limitation sur le nombre de règles que vous pouvez ajouter. Pour plus d’informations sur la structure de dossiers et la validation locale, voir Validation et débogage à l’aide des outils Dispatcher.
Mode hérité : pour plus d’informations sur la structure de dossiers et la validation locale pour le mode hérité de la configuration de Dispatcher, voir Validation et débogage à l’aide des outils Dispatcher (hérités).
Pour plus d’informations sur la migration du modèle de configuration hérité vers le modèle plus flexible, fourni avec l’archétype 28 d’AEM et versions ultérieures, voir cette documentation.
Pour le niveau de publication, les objets Blob sont diffusés par défaut en tant que pièce jointe. Vous pouvez modifier ce paramètre en utilisant l’en-tête standard de disposition du contenu dans le Dispatcher.
La configuration doit se présenter ainsi :
<LocationMatch "^\/content\/dam.*\.(pdf).*">
Header unset Content-Disposition
Header set Content-Disposition inline
</LocationMatch>
Le tableau ci-dessous présente les modules Apache pris en charge :
Les clients ne peuvent pas ajouter de modules arbitraires, mais des modules supplémentaires peuvent être envisagés pour inclusion à l’avenir. Pour obtenir la liste des directives disponibles pour une version de Dispatcher donnée, les client(e)s peuvent exécuter la commande de liste autorisée du programme de validation dans le SDK.
Les directives autorisées dans les fichiers de configuration Apache peuvent être répertoriées en exécutant la commande de liste autorisée du programme de validation :
$ validator allowlist
Cloud manager validator 2.0.4
Allowlisted directives:
<Directory>
...
La structure de dossiers Apache et Dispatcher du projet diffère légèrement selon le mode utilisé par le projet, comme décrit dans la section Validation et débogage à l’aide des outils Dispatcher ci-dessus.
Pour plus d’informations sur la migration de la configuration de Dispatcher d’AMS vers AEM en as a Cloud Service, voir la page Migration de la configuration de Dispatcher d’AMS vers AEM as a Cloud Service.