使用 Dispatcher 工具进行验证和调试 Dispatcher-in-the-cloud
简介 apache-and-dispatcher-configuration-and-testing
以下各节介绍了灵活模式的文件结构、本地验证、调试以及从旧版模式迁移到灵活模式。
本文假定您项目的Dispatcher配置包含文件 opt-in/USE_SOURCES_DIRECTLY
. 与传统模式相比,此文件可让SDK和运行时以改进的方式验证和部署配置,从而消除有关文件数量和大小的限制。
如果您的Dispatcher配置不包含前述文件,Adobe建议您按照以下说明从旧版模式迁移到灵活模式 从旧模式迁移到灵活模式 部分。
文件结构 flexible-mode-file-structure
项目的Dispatcher子文件夹的结构如下所示:
./
├── conf.d
│ ├── available_vhosts
│ │ ├── my_site.vhost # Created by customer
│ │ └── default.vhost
│ ├── dispatcher_vhost.conf
│ ├── enabled_vhosts
│ │ ├── README
│ │ └── my_site.vhost -> ../available_vhosts/my_site.vhost # Created by customer
│ └── rewrites
│ │ ├── default_rewrite.rules
│ │ └── rewrite.rules
│ └── variables
| ├── custom.vars
│ └── global.vars
│── opt-in
│ └── USE_SOURCES_DIRECTLY
└── conf.dispatcher.d
├── available_farms
│ ├── my_farm.farm # Created by customer
│ └── default.farm
├── cache
│ ├── default_invalidate.any
│ ├── default_rules.any
│ ├── marketing_query_parameters.any
│ └── rules.any
├── clientheaders
│ ├── clientheaders.any
│ └── default_clientheaders.any
├── dispatcher.any
├── enabled_farms
│ ├── README
│ └── my_farm.farm -> ../available_farms/my_farm.farm # Created by customer
├── filters
│ ├── default_filters.any
│ └── filters.any
├── renders
│ └── default_renders.any
└── virtualhosts
│ ├── default_virtualhosts.any
│ └── virtualhosts.any
以下是可修改的显着文件的说明:
可自定义的文件
以下文件可自定义,并在部署时传输到您的云实例:
conf.d/available_vhosts/<CUSTOMER_CHOICE>.vhost
您可以拥有一个或多个这些文件。 它们包含 <VirtualHost>
条目匹配主机名,并允许Apache使用不同的规则处理每个域流量。 文件创建于 available_vhosts
目录,并通过中的符号链接启用 enabled_vhosts
目录。 从 .vhost
包括文件和其他文件,如重写和变量。
确保至少始终有一个与ServerAlias匹配的虚拟主机可用 \*.local
, localhost
、和 127.0.0.1
Dispatcher失效所需的参数。 服务器别名 *.adobeaemcloud.net
和 *.adobeaemcloud.com
在至少一个vhost配置中也需要使用,内部Adobe过程也需要使用。
如果由于您有多个vhost文件而希望与确切的主机匹配,则可以遵循以下示例:
<VirtualHost *:80>
ServerName "example.com"
# Put names of which domains are used for your published site/content here
ServerAlias "*example.com" "\*.local" "localhost" "127.0.0.1" "*.adobeaemcloud.net" "*.adobeaemcloud.com"
# Use a document root that matches the one in conf.dispatcher.d/default.farm
DocumentRoot "${DOCROOT}"
# URI dereferencing algorithm is applied at Sling's level, do not decode parameters here
AllowEncodedSlashes NoDecode
# Add header breadcrumbs for help in troubleshooting which vhost file is chosen
<IfModule mod_headers.c>
Header add X-Vhost "publish-example-com"
</IfModule>
...
</VirtualHost>
conf.d/enabled_vhosts/<CUSTOMER_CHOICE>.vhost
此文件夹包含指向conf.dispatcher.d/available_vhosts下的文件的相对符号链接。
创建这些符号链接所需的命令示例:
Apple macOS、Linux和WSL
ln -s ../available_vhosts/wknd.vhost wknd.vhost
Microsoft Windows
mklink wknd.vhost ..\available_vhosts\wknd.vhost
conf.d/rewrites/rewrite.rules
文件包含在 .vhost
文件。 它有一组重写规则 mod_rewrite
.
conf.d/variables/custom.vars
文件包含在 .vhost
文件。 您可以在此位置添加对Apache变量的定义。
conf.d/variables/global.vars
文件包含在 dispatcher_vhost.conf
文件。 您可以在此文件中更改Dispatcher并重写日志级别。
conf.dispatcher.d/available_farms/<CUSTOMER_CHOICE>.farm
您可以有一个或多个这些文件,它们包含与主机名匹配的场,并允许Dispatcher模块使用不同的规则处理每个场。 文件创建于 available_farms
目录,并通过中的符号链接启用 enabled_farms
目录。 从 .farm
文件、过滤器、缓存规则等其他文件也包括在内。
conf.dispatcher.d/enabled_farms/<CUSTOMER_CHOICE>.farm
此文件夹包含指向conf.dispatcher.d/available_farms下文件的相对符号链接。
创建这些符号链接所需的命令示例:
Apple macOS、Linux和WSL
ln -s ../available_farms/wknd.farm wknd.farm
Microsoft Windows
mklink wknd.farm ..\available_farms\wknd.farm
conf.dispatcher.d/cache/rules.any
文件包含在 .farm
文件。 它指定高速缓存首选项。
conf.dispatcher.d/clientheaders/clientheaders.any
文件包含在 .farm
文件。 它指定应将哪些请求标头转发到后端。
conf.dispatcher.d/filters/filters.any
文件包含在 .farm
文件。 它有一组规则,这些规则更改了应过滤掉的流量而不应将其发送到后端。
conf.dispatcher.d/virtualhosts/virtualhosts.any
文件包含在 .farm
文件。 它包含要通过glob匹配匹配的主机名或URI路径的列表。 此匹配可确定用于为请求提供服务的后端。
opt-in/USE_SOURCES_DIRECTLY
此文件实现了更灵活的Dispatcher配置,并删除了以前对文件数量和大小的限制。 它还促使SDK和运行时以改进的方式验证和部署配置。
上述文件引用了下面列出的不可变配置文件。 云环境中的Dispatcher不会处理对不可变文件的更改。
不可变配置文件
这些文件是基本框架的一部分,用于执行标准和最佳实践。 这些文件被视为不可变,因为在本地修改或删除它们不会对您的部署产生影响,因为它们不会传输到您的云实例。
建议上述文件引用下面列出的不可变文件,然后引用任何其他语句或覆盖。 将Dispatcher配置部署到云环境时,无论在本地开发中使用了什么版本,都会使用最新版本的不可变文件。
conf.d/available_vhosts/default.vhost
包含示例虚拟主机。 对于您自己的虚拟主机,请创建此文件的副本,对其进行自定义,然后转到 conf.d/enabled_vhosts
并创建指向自定义副本的符号链接。
请勿将default.vhost文件直接复制到 conf.d/enabled_vhosts
.
确保虚拟主机始终可用,与ServerAlias匹配 \*.local
, localhost
、和 127.0.0.1
Dispatcher失效所需的参数。 服务器别名 *.adobeaemcloud.net
和 *.adobeaemcloud.com
内部Adobe流程所需。
conf.d/dispatcher_vhost.conf
基本框架的一部分,用于说明如何包含虚拟主机和全局变量。
conf.d/rewrites/default_rewrite.rules
重写默认规则适用于标准项目。 如果需要自定义,请修改 rewrite.rules
. 在自定义设置中,如果默认规则符合您的需求,您仍然可以首先包含这些规则。
conf.dispatcher.d/available_farms/default.farm
包含一个示例Dispatcher场。 对于您自己的场,创建此文件的副本,对其进行自定义,然后转到 conf.d/enabled_farms
并创建指向自定义副本的符号链接。
conf.dispatcher.d/cache/default_invalidate.any
基础框架的一部分,在启动时生成。 您是 必填 要将此文件包含在您定义的每个场中,请在每个场的 cache/allowedClients
部分。
conf.dispatcher.d/cache/default_rules.any
适用于标准项目的默认缓存规则。 如果需要自定义,请修改 conf.dispatcher.d/cache/rules.any
. 在自定义设置中,如果默认规则符合您的需求,您仍然可以首先包含这些规则。
conf.dispatcher.d/clientheaders/default_clientheaders.any
转发到后端的默认请求标头,适用于标准项目。 如果需要自定义,请修改 clientheaders.any
. 在自定义设置中,您仍然可以首先包含默认请求标头(如果它们符合您的需要)。
conf.dispatcher.d/dispatcher.any
基本框架的一部分,用于说明如何包含您的Dispatcher场。
conf.dispatcher.d/filters/default_filters.any
适用于标准项目的默认筛选器。 如果需要自定义,请修改 filters.any
. 在自定义设置中,如果默认筛选器符合您的需求,您仍可以首先包含这些筛选器。
conf.dispatcher.d/renders/default_renders.any
作为基本框架的一部分,此文件将在启动时生成。 您是 必填 要将此文件包含在您定义的每个场中,请在每个场的 renders
部分。
conf.dispatcher.d/virtualhosts/default_virtualhosts.any
适用于标准项目的默认主机通配。 如果需要自定义,请修改 virtualhosts.any
. 在自定义设置中,不应包含默认主机通配符,因为它与默认主机通配符匹配 每 传入请求。
支持的 Apache 模块 apache-modules
请参阅 支持的Apache模块.
本地验证 local-validation-flexible-mode
使用 validate.sh
脚本,如下所示:
$ validate.sh src/dispatcher
opt-in USE_SOURCES_DIRECTLY marker file detected
Phase 1: Dispatcher validator
Cloud manager validator 2.0.32
Phase 1 finished
Phase 2: httpd -t validation in docker image
values.csv not found in deployment folder: /Users/foo/src - using files in 'conf.d' and 'conf.dispatcher.d' subfolders directly
processing configuration subfolder: conf.d
processing configuration subfolder: conf.dispatcher.d
Running script /docker_entrypoint.d/10-check-environment.sh
Running script /docker_entrypoint.d/20-create-docroots.sh
Running script /docker_entrypoint.d/30-wait-for-backend.sh
Waiting until localhost is available
localhost resolves to ::1
Running script /docker_entrypoint.d/40-generate-allowed-clients.sh
Running script /docker_entrypoint.d/50-check-expiration.sh
Running script /docker_entrypoint.d/60-check-loglevel.sh
Running script /docker_entrypoint.d/70-check-forwarded-host-secret.sh
# Dispatcher configuration: (/etc/httpd/conf.dispatcher.d/dispatcher.any)
/farms {
...
}
Syntax OK
Phase 2 finished
Phase 3: Immutability check
reading immutable file list from /etc/httpd/immutable.files.txt
...
no immutable file has been changed - check is SUCCESSFUL
Phase 3 finished
该脚本包含以下三个阶段:
- 它运行验证器。 如果配置无效,脚本将失败。
- 它会执行
httpd -t
用于测试语法是否正确以便Apache httpd可以启动的命令。 如果成功,配置应准备好进行部署。 - 检查Dispatcher SDK配置文件的子集,该文件旨在不可更改,如 文件结构部分,尚未修改,并与当前的SDK版本匹配。
在Cloud Manager部署期间, httpd -t
语法检查也会运行,所有错误都包含在Cloud Manager中 Build Images step failure
日志。
validate.sh
在每次配置修改之后。阶段1 first-phase
如果未列入允许列表指令,则该工具会记录错误并返回非零退出代码。 此外,它还会进一步扫描所有具有模式的文件 conf.dispatcher.d/enabled_farms/*.farm
并检查:
- 不存在使用允许通过以下方式使用的过滤器规则
/glob
(请参阅 CVE-2016-0957),以了解更多详细信息。 - 没有公开管理员功能。 例如,访问路径,如
/crx/de or /system/console
.
验证工具仅报告未被列入允许列表的Apache指令被禁止使用的情况。 它不会报告Apache配置的语法或语义问题,因为此信息仅对运行环境中的Apache模块可用。
下面提供了用于调试该工具输出的常见验证错误的故障排除技术:
无法定位 conf.dispatcher.d
存档中的子文件夹
您的存档应包含文件夹 conf.d
和 conf.dispatcher.d
。 请注意,您不应 在 存档 etc/httpd
中使用前缀。
在中找不到任何场conf.dispatcher.d/enabled_farms
您启用的场应位于所述子文件夹中。
包含的文件(…)必须命名为: …
您的场配置中有两个部分 必须 包含特定文件: /renders
和 /allowedClients
在 /cache
部分。 这些部分必须如下所示:
/renders {
$include "../renders/default_renders.any"
}
和:
/allowedClients {
$include "../cache/default_invalidate.any"
}
文件包含在未知位置: …
在您的场配置中有四个部分,允许您包含自己的文件: /clientheaders
, filters
, /rules
在 /cache
部分和 /virtualhosts
. 包含的文件必须按如下方式命名:
/clientheaders
../clientheaders/clientheaders.any
/filters
../filters/filters.any
/rules
../cache/rules.any
/virtualhosts
../virtualhosts/virtualhosts.any
或者,您也可以包含 默认 这些文件的版本,其名称前面加有单词 default_
例如, ../filters/default_filters.any
.
Include语句位于(…),位于任何已知位置之外: …
除上述六节外,严禁使用 $include
语句,例如,以下语句将生成此错误:
/invalidate {
$include "../cache/invalidate.any"
}
不包括……中允许的客户端/渲染
如果不为指定“包含”,则会生成此错误 /renders
和 /allowedClients
在 /cache
部分。 请参阅
包含的文件(…)必须命名为: … 部分以了解更多信息。
过滤器不得使用glob模式来允许请求
如果允许请求具有,则将不安全 /glob
样式规则,该规则与完整的请求行匹配,例如,
/0100 {
/type "allow" /glob "GET *.css *"
}
此语句用于允许请求 css
文件,但它也允许请求 任意 后跟查询字符串的资源 ?a=.css
. 因此,禁止使用此类过滤器(另见CVE-2016-0957)。
包含的文件(…)不匹配任何已知文件
默认情况下,可以将Apache虚拟主机配置中的两种文件类型指定为包含:重写和变量。
conf.d/rewrites/rewrite.rules
conf.d/variables/custom.vars
在灵活模式下,还可以包含其他文件,只要它们位于的子目录(在任何级别)中 conf.d
以下为前缀的目录。
conf.d/includes
conf.d/modsec
conf.d/rewrites
例如,您可以将文件包含在 conf.d/includes
目录,如下所示:
Include conf.d/includes/mynewdirectory/myincludefile.conf
或者,您也可以包含 默认 重写规则的版本,其名称为 conf.d/rewrites/default_rewrite.rules
.
请注意,变量文件没有默认版本。
检测到已弃用的配置布局,正在启用兼容模式
此消息指示您的配置具有已弃用的版本1布局,其中包含完整的Apache配置和文件,其中 ams_
前缀。 虽然此配置仍然支持向后兼容性,但您应该切换到新布局。
第一阶段还可以 单独运行,而不是来自包装器 validate.sh
脚本。
针对您的maven工件或您的 dispatcher/src
子目录,报告验证失败:
$ validator full -relaxed dispatcher/src
Cloud manager validator 1.0.4
2019/06/19 15:41:37 Apache configuration uses non-allowlisted directives:
conf.d/enabled_vhosts/aem_publish.vhost:46: LogLevel
2019/06/19 15:41:37 Dispatcher configuration validation failed:
conf.dispatcher.d/enabled_farms/999_ams_publish_farm.any: filter allows access to CRXDE
在Windows上,Dispatcher验证器区分大小写。 因此,如果您不遵守配置所在路径的大小写,例如:
bin\validator.exe -relaxed full src
Cloud manager validator 2.0.xx
2021/03/15 18:15:40 Dispatcher configuration validation failed:
conf.dispatcher.d\available_farms\default.farm:15: parent directory outside server root: c:\k\a\aem-dispatcher-sdk-windows-symlinks-testing3\dispatcher\src
从Windows资源管理器复制并粘贴路径,然后在命令提示符下使用 cd
命令进入该路径。
阶段2 second-phase
此阶段通过在Docker容器中启动Apache HTTPD来检查Apache语法。 必须本地安装Docker,但请注意,AEM不需要运行。
对于Windows和macOS,Adobe建议使用Docker桌面。
此阶段也可以独立运行 bin/docker_run.sh src/dispatcher host.docker.internal:4503 8080
.
在Cloud Manager部署期间, httpd -t
语法检查也会运行,所有错误都包含在Cloud Manager构建图像步骤失败日志中。
阶段3 third-phase
如果在此阶段失败,则表示Adobe更改了一个或多个不可变文件。 在这种情况下,您必须将相应的不可变文件替换为 src
SDK的目录。 以下日志示例说明了此问题:
Phase 3: Immutability check
reading immutable file list from /etc/httpd/immutable.files.txt
(...)
checking existing 'conf.dispatcher.d/clientheaders/default_clientheaders.any' for changes
immutable file 'conf.dispatcher.d/clientheaders/default_clientheaders.any' has been changed:
--- /etc/httpd/conf.dispatcher.d/clientheaders/default_clientheaders.any
+++ /etc/httpd-actual/conf.dispatcher.d/clientheaders/default_clientheaders.any
@@ -40,4 +40,3 @@
"Sling-uploadmode"
"x-requested-with"
"If-Modified-Since"
-"Authorization"
** error: immutable file 'conf.dispatcher.d/clientheaders/default_clientheaders.any' has been changed!
此阶段也可以独立运行 bin/docker_immutability_check.sh src/dispatcher
.
通过运行 bin/update_maven.sh src/dispatcher
Dispatcher文件夹中的脚本,其中 src/dispatcher
是您的Dispatcher配置目录。 此脚本还将更新 pom.xml
文件,以便maven不可变性检查也会更新。
调试Apache和Dispatcher配置 debugging-apache-and-dispatcher-configuration
您可以使用在本地运行Apache Dispatcher ./bin/docker_run.sh src/dispatcher docker.for.mac.localhost:4503 8080
.
如前所述,必须本地安装Docker,AEM不需要运行。 Windows用户必须使用支持Docker的Windows 10 Professional或其他分发。 此要求是在本地计算机上运行和调试Dispatcher的先决条件。
以下策略可用于增加Dispatcher模块的日志输出并查看结果 RewriteRule
在本地和云环境中进行评估。
这些模块的日志级别由变量定义 DISP_LOG_LEVEL
和 REWRITE_LOG_LEVEL
. 可以在文件中设置这些参数 conf.d/variables/global.vars
. 其相关部分如下:
# Log level for the dispatcher
#
# Possible values are: error, warn, info, debug and trace1
# Default value: warn
#
# Define DISP_LOG_LEVEL warn
# Log level for mod_rewrite
#
# Possible values are: error, warn, info, debug and trace1 - trace8
# Default value: warn
#
# To debug your RewriteRules, it is recommended to raise your log
# level to trace2.
#
# More information can be found at:
# https://httpd.apache.org/docs/current/mod/mod_rewrite.html#logging
#
# Define REWRITE_LOG_LEVEL warn
在本地运行Dispatcher时,日志将直接打印到终端输出。 大多数情况下,希望这些日志处于DEBUG状态,可通过在运行Docker时将Debug级别作为参数传递来完成此操作。 例如:DISP_LOG_LEVEL=Debug ./bin/docker_run.sh src docker.for.mac.localhost:4503 8080
。
云环境的日志通过Cloud Manager中提供的日志记录服务公开。
自动重新加载和验证 automatic-reloading
不要运行本地验证(validate.sh
)并启动docker容器(docker_run.sh
)每次修改配置时,您也可以运行 docker_run_hot_reload.sh
脚本。 该脚本会监视对配置的任何更改,并自动重新加载它并重新运行验证。 通过使用此选项,您可以在调试时节省大量时间。
可以使用以下命令运行脚本: ./bin/docker_run_hot_reload.sh src/dispatcher host.docker.internal:4503 8080
输出的第一行看起来与运行的目标类似 docker_run.sh
. 例如:
~ bin/docker_run_hot_reload.sh src host.docker.internal:8081 8082
opt-in USE_SOURCES_DIRECTLY marker file detected
Running script /docker_entrypoint.d/10-check-environment.sh
Running script /docker_entrypoint.d/15-check-pod-name.sh
Running script /docker_entrypoint.d/20-create-docroots.sh
Running script /docker_entrypoint.d/30-wait-for-backend.sh
Waiting until host.docker.internal is available
host.docker.internal resolves to 192.168.65.2
Running script /docker_entrypoint.d/40-generate-allowed-clients.sh
Running script /docker_entrypoint.d/50-check-expiration.sh
Running script /docker_entrypoint.d/60-check-loglevel.sh
Running script /docker_entrypoint.d/70-check-forwarded-host-secret.sh
Running script /docker_entrypoint.d/80-frontend-domain.sh
Running script /docker_entrypoint.d/zzz-import-sdk-config.sh
WARN Mon Jul 4 09:53:54 UTC 2022: Pseudo symlink conf.d seems to point to a non-existing file!
INFO Mon Jul 4 09:53:55 UTC 2022: Copied customer configuration to /etc/httpd.
INFO Mon Jul 4 09:53:55 UTC 2022: Start testing
Cloud manager validator 2.0.43
2022/07/04 09:53:55 No issues found
INFO Mon Jul 4 09:53:55 UTC 2022: Testing with fresh base configuration files.
INFO Mon Jul 4 09:53:55 UTC 2022: Apache httpd informationServer version: Apache/2.4.54 (Unix)
注入自定义环境变量 environment-variables
通过在单独的文件中设置自定义环境变量并在中引用它,可以将其与Dispatcher SDK一起使用 ENV_FILE
环境变量。
包含自定义环境变量的文件如下所示:
COMMERCE_ENDPOINT=commerce-host
AEM_HTTP_PROXY_HOST=host.docker.internal
AEM_HTTP_PROXY_PORT=8000
并且它可以通过以下命令在本地Dispatcher SDK中使用:
export ENV_FILE=custom.env
./bin/docker_run.sh src/dispatcher docker.for.mac.localhost:4503 8080
每个环境不同的Dispatcher配置 different-dispatcher-configurations-per-environment
目前,相同的Dispatcher配置会应用于AEMas a Cloud Service上的所有环境。 运行时有一个环境变量 ENVIRONMENT_TYPE
包含当前运行模式(开发、暂存或生产)和“定义”的运行模式。 “define”可以是 ENVIRONMENT_DEV
, ENVIRONMENT_STAGE
,或 ENVIRONMENT_PROD
. 在Apache配置中,可直接在表达式中使用变量。 或者,“define”可用于构建逻辑:
# Simple usage of the environment variable
ServerName ${ENVIRONMENT_TYPE}.company.com
# When more logic is required
<IfDefine ENVIRONMENT_STAGE>
# These statements are for stage
Define VIRTUALHOST stage.example.com
</IfDefine>
<IfDefine ENVIRONMENT_PROD>
# These statements are for production
Define VIRTUALHOST prod.example.com
</IfDefine>
在Dispatcher配置中,相同的环境变量可用。 如果需要更多逻辑,请定义上述示例中显示的变量,然后在Dispatcher配置部分中使用它们:
/virtualhosts {
{ "${VIRTUALHOST}" }
}
或者,您可以在httpd/dispatcher配置中使用Cloud Manager环境变量,但不要使用环境密钥。 如果某个程序具有多个开发环境,并且其中某些开发环境的httpd/dispatcher配置值不同,则此方法尤为重要。 相同的${VIRTUALHOST} 将如上述示例中那样使用语法,但不使用上述变量文件中的Define声明。 阅读 Cloud Manager文档 有关配置Cloud Manager环境变量的说明。
在本地测试配置时,您可以通过传递变量来模拟不同的环境类型 DISP_RUN_MODE
到 docker_run.sh
直接脚本:
$ DISP_RUN_MODE=stage docker_run.sh src docker.for.mac.localhost:4503 8080
不传入DISP_RUN_MODE的值时的缺省运行模式为“dev”。
有关可用选项和变量的完整列表,请运行脚本 docker_run.sh
没有参数。
查看Docker容器正在使用的Dispatcher配置 viewing-dispatcher-configuration-in-use-by-docker-container
使用特定于环境的配置,可能很难确定实际的Dispatcher配置是什么样的。 使用启动Docker容器后 docker_run.sh
,可以按如下方式转储:
- 确定正在使用的Docker容器ID:
$ docker ps
CONTAINER ID IMAGE
d75fbd23b29 adobe/aem-ethos/dispatcher-publish:...
- 使用该容器ID执行以下命令行:
$ docker exec d75fbd23b29 httpd-test
# Dispatcher configuration: (/etc/httpd/conf.dispatcher.d/dispatcher.any)
/farms {
/publishfarm {
/clientheaders {
...
从旧模式迁移到灵活模式 migrating
在Cloud Manager 2021.7.0版本中,新的Cloud Manager程序使用生成maven项目结构 AEM原型28 或更高版本,其中包括文件 opt-in/USE_SOURCES_DIRECTLY. 它删除了以前的 旧模式 文件的数量和大小,这也会导致SDK和运行时以改进的方式验证和部署配置。 如果您的Dispatcher配置没有此文件,强烈建议您迁移。 请使用以下步骤确保安全过渡:
-
本地测试。 使用最新的Dispatcher tools SDK,添加文件夹和文件
opt-in/USE_SOURCES_DIRECTLY
. 按照本文中的“本地验证”说明进行操作,以便测试Dispatcher是否可以在本地工作。 -
云开发测试:
- 提交文件
opt-in/USE_SOURCES_DIRECTLY
到由非生产管道部署到云开发环境的Git分支。 - 使用Cloud Manager部署到云开发环境。
- 彻底测试。 在将更改部署到更高环境之前,务必要验证Apache和Dispatcher配置是否按预期运行。 检查与自定义配置相关的所有行为。 如果您认为部署的Dispatcher配置未反映您的自定义配置,请提交客户支持工单。
note note NOTE 在灵活模式下,您应该使用相对路径而不是绝对路径。 1. **部署到生产:** * 提交文件 `opt-in/USE_SOURCES_DIRECTLY` 到由生产管道部署到云暂存和生产环境的Git分支。 * 使用Cloud Manager部署到暂存环境。 * 彻底测试。 在将更改部署到更高环境之前,务必要验证Apache和Dispatcher配置是否按预期运行。 检查与自定义配置相关的所有行为。 如果您认为部署的Dispatcher配置未反映您的自定义配置,请提交客户支持工单。 * 使用Cloud Manager继续部署到生产环境。
- 提交文件