全局变量
全局变量控制Commerce部署过程的每个阶段的操作:生成、部署和部署后。 由于全局变量会影响每个阶段,因此您必须在.magento.env.yaml
文件的global
阶段中设置它们:
stage:
global:
GLOBAL_VARIABLE_NAME: value
有关自定义生成和部署过程的详细信息:
ENABLE_EVENTING
- 默认值-未设置
- 版本—Adobe Commerce 2.4.5及更高版本
当设置为true
时,允许cron运行消息队列使用者。 Adobe Commerce的Adobe I/O事件使用消息队列来加快关键事件的交付。
Adobe建议您还将CRON_CONSUMERS_RUNNER
变量添加到.magento.env.yaml
文件的deploy
阶段(其中cron_run
设置为true
)。
以下示例显示完全配置的ENABLE_EVENTING
变量。
stage:
global:
ENABLE_EVENTING: true
deploy:
CRON_CONSUMERS_RUNNER:
cron_run: true
max_messages: 0
consumers: []
ENABLE_WEBHOOKS
- 默认值-未设置
- 版本—Adobe Commerce 2.4.4及更高版本
当设置为true
时,启用Commerce Webhook。 webhook在外部端点上运行,例如App Builder运行时操作或第三方清单管理系统。 Webhooks指南 详细描述了此功能。
stage:
global:
ENABLE_WEBHOOKS: true
MIN_LOGGING_LEVEL
- 默认值—未设置
- 版本—Adobe Commerce 2.1.4及更高版本
覆盖所有输出流的最低日志记录级别,而不更改代码,这在排除部署问题时很有用。 例如,如果您的部署失败,则可以使用此变量全局增加日志记录粒度。 请参阅日志级别。 日志记录处理程序中的min_level
值将覆盖此设置。
stage:
global:
MIN_LOGGING_LEVEL: debug
MIN_LOGGING_LEVEL
变量的设置不会更改文件处理程序的日志级别配置,默认情况下设置为debug
。SCD_ON_DEMAND
- 默认值—未设置
- 版本—Adobe Commerce 2.1.4及更高版本
在用户请求时启用生成静态内容(SCD)。 按需静态内容由于缩短了部署时间,因此非常适合用于开发和测试工作流。
使用post_deploy
挂接预加载缓存可减少网站停机时间。 缓存预热仅适用于Cloud Console中包含暂存和生产环境的Pro项目以及入门项目。 将SCD_ON_DEMAND
环境变量添加到.magento.env.yaml
文件中的global
阶段:
stage:
global:
SCD_ON_DEMAND: true
SCD_ON_DEMAND
变量在两个阶段(生成和部署)都跳过SCD,清除pub/static
和var/view_preprocessed
文件夹,并将以下内容写入app/etc/env.php
文件:
return array(
...
'static_content_on_demand_in_production' => 1,
...
);
SCD_MAX_EXECUTION_TIME
- 默认值—未设置
- 版本—Adobe Commerce 2.2.0及更高版本
允许您增加静态内容部署的最大预期执行时间。
默认情况下,Adobe Commerce将最大预期执行时间设置为900秒,但在某些情况下,您可能需要更多时间来完成Cloud项目的静态内容部署。
stage:
global:
SCD_MAX_EXECUTION_TIME: 3600
SCD_NO_PARENT
- 默认值—未设置
- 版本—Adobe Commerce 2.4.2及更高版本
设置为true
以防止在生成和部署阶段为父主题生成静态内容。 当此选项设置为true
时,生成的静态内容较少,这缩短了总体生成和部署时间。
stage:
global:
SCD_NO_PARENT: true
SCD_USE_BALER
- 默认值—未设置
- 版本—Adobe Commerce 2.3.0及更高版本
Baler是一个模块,用于扫描生成的JavaScript代码并创建优化的JavaScript捆绑包。 将优化的捆绑包部署到您的站点可以减少加载您的站点时的网络请求数并缩短页面加载时间。
设置为true
可在执行静态内容部署后运行过滤器。
stage:
build:
SCD_USE_BALER: true
SKIP_HTML_MINIFICATION
-
默认值:
true
— 适用于ece-tools
2002.0.13及更高版本false
— 适用于早期版本的ece-tools
-
版本—Adobe Commerce 2.1.4及更高版本
启用或禁用在生成阶段结束时将静态视图文件复制到<magento_root>/init/
目录。 如果设置为true
,将不会复制文件,并且HTML缩小功能可应请求使用。 将此值设置为true
可减少部署到暂存和生产环境时的停机时间。
false
— 在生成阶段结束时将view_preprocessed
目录复制到<magento_root>/init/
目录,并在部署阶段开始时恢复<magento_root>/var
目录中的目录。true
— 启用随选HTML缩小;在生成阶段结束时 不 将<magento_root>var/view_preprocessed
复制到<magento_root>/init/
目录。
将SKIP_HTML_MINIFICATION
环境变量添加到.magento.env.yaml
文件中的global
阶段:
stage:
global:
SKIP_HTML_MINIFICATION: true
X_FRAME_CONFIGURATION
- 默认值—未设置
- 版本—Adobe Commerce 2.1.4及更高版本
使用X_FRAME_CONFIGURATION
变量更改Adobe Commerce站点的X-Frame-Options
标头配置。 此配置控制浏览器如何呈现<frame>
、<iframe>
或<object>
中的页面。 使用以下选项之一:
DENY
— 页面无法显示在框架中。SAMEORIGIN
—(默认Adobe Commerce设置。) 页面只能在与页面本身同源的框架中显示。
ALLOW-FROM <uri>
选项已被弃用,因为Adobe Commerce支持的浏览器不再支持它。 查看浏览器兼容性。将X_FRAME_CONFIGURATION
环境变量添加到.magento.env.yaml
文件中的global
阶段:
stage:
global:
X_FRAME_CONFIGURATION: SAMEORIGIN