本页介绍 Dispatcher 工具以及如何下载和提取这些工具、受支持的 Apache 模块,并提供对传统架构和灵活架构的高级概述。此外,还提供了关于验证以及调试 Dispatcher 配置并将其从 AMS 迁移到 AEM as a Cloud Service 的深度引用。
Dispatcher 工具是整个 AEM as a Cloud Service SDK 的一部分,并提供了:
可以从软件分发门户上的 zip 文件中下载 Dispatcher 工具(它是 AEM as a Cloud Service SDK 的一部分)。新版本的 Dispatcher 工具中提供的任何新配置都可用于部署到运行该版本的 AEM 或更高版本的云环境。
解压 SDK,它捆绑了适用于 macOS、Linux® 和 Windows 的 Dispatcher 工具。
对于 macOS/Linux,使 Dispatcher 工具构件可执行并运行它。它将在您将 Dispatcher 工具存储到的目录下自行提取 Dispatcher 工具文件(其中,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 存档。
Dispatcher 工具用于验证和调试项目的 Dispatcher 配置。了解如何根据您项目的 Dispatcher 配置是在灵活架构还是旧版架构下构建的,在下面引用的页面中使用这些工具的更多信息:
灵活架构 - 推荐架构,也是 AEM 原型 28 及更高版本的默认架构,Cloud Manager 也将此架构用于创建的新环境(在 Cloud Manager 2021.7.0 版本之后)。客户可以通过添加文件夹和文件 opt-in/USE_SOURCES_DIRECTLY
来激活此架构。通过使用这个更灵活的架构,rewrites 文件夹下的文件结构不受任何限制,在旧版架构下需要单个 rewrite.rules
文件。此外,可添加的规则数量不受任何限制。有关文件夹结构和本地验证的详细信息,请参阅使用 Dispatcher 工具进行验证和调试。
传统架构 – 有关 Dispatcher 配置旧版架构的文件夹结构和本地验证的详细信息,请参阅使用 Dispatcher 工具进行验证和调试(旧版)
有关如何从旧版配置模型迁移到更灵活的模型(从 AEM 原型 28 开始附带)的更多信息,请参阅此文档。
对于发布层,提供 blob 的默认设置是作为附件。使用 Dispatcher 中的标准内容处置标头对其进行覆盖。
下面是配置的显示方式的示例:
<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 页面。