本页介绍了Dispatcher工具以及如何下载和提取它们、支持的Apache模块,并简要概述了旧版和灵活模式。 此外,还进一步参考了验证和调试以及将Dispatcher配置从AMS迁移到AEMas a Cloud Service。 另请参阅 此视频 有关在云服务环境中部署dispatcher文件的其他详细信息。
Dispatcher工具是整个AEMas a Cloud ServiceSDK的一部分,它提供:
调度程序工具, AEMas a Cloud ServiceSDK,可从位于 Software Distribution 门户。 该新Dispatcher工具版本中可用的任何新配置都可用于部署到在云或更高版本中运行该AEM版本的云环境。
解压缩SDK,该SDK捆绑了适用于macOS、Linux和Windows的Dispatcher工具。
对于macOS/Linux,使调度程序工具对象可执行并运行它。 它将自解压缩存储到的目录下的调度程序工具文件(其中 version
是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%
对于Windows,提取Dispatcher工具zip存档。
调度程序工具用于验证和调试项目的调度程序配置。 根据项目的调度程序配置是以灵活模式还是旧版模式构建,进一步了解如何在以下引用的页面中使用这些工具:
灵活模式 — 推荐的模式,默认为 AEM原型28 和更高版本,Cloud Manager也会将它用于在Cloud Manager 2021.7.0版本之后创建的新环境。 客户可以通过添加文件夹和文件来激活此模式 opt-in/USE_SOURCES_DIRECTLY
. 通过使用这种更灵活的模式,在旧版模式下,重写文件夹下的文件结构没有任何限制,只需单个 rewrite.rules
文件。 此外,您可以添加的规则数量没有限制。 有关文件夹结构和本地验证的详细信息,请参阅 使用Dispatcher工具验证和调试.
旧版模式 — 有关调度程序配置旧版模式的文件夹结构和本地验证的详细信息,请参阅 使用Dispatcher工具验证和调试(旧版)
有关如何从AEM原型28提供的从旧版配置模型迁移到更灵活的配置模型的更多信息,请参阅 本文档.
对于发布层,提供Blob的默认值是作为附件。 可以使用标准 内容处置标题 在调度程序中。
以下是配置外观的示例:
<LocationMatch "^\/content\/dam.*\.(pdf).*">
Header unset Content-Disposition
Header set Content-Disposition inline
</LocationMatch>
下表显示了支持的Apache模块:
客户无法添加任意模块,但将来可能会考虑添加其他模块以包含在内。 客户可以通过在SDK中执行验证器的命令,找到适用于给定Dispatcher版允许列表本的指令列表。
通过运行验证器的命令,可以列出Apache配置文件中允许的允许列表指令:
$ validator allowlist
Cloud manager validator 2.0.4
Allowlisted directives:
<Directory>
...
项目的apache和dispatcher文件夹结构将因项目使用的模式而略有不同,如 使用Dispatcher工具进行验证和调试 部分。
有关如何将Dispatcher配置从AMS迁移到AEM as a Cloud Service的详细信息,请参阅 将Dispatcher配置从AMS迁移到AEM as a Cloud Service页面。