全局变量

全局变量控制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
WARNING
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/staticvar/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
WARNING
如果在部署后应用程序中遇到静态内容文件问题(例如缺少自定义主题文件),请将最大预期执行时间增加到900秒或更高。

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
NOTE
在使用此功能之前,请安装和配置栏位模块。 由于包是在Alpha版本中,因此仅在暂存环境中启用此选项。

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设置。) 页面只能在与页面本身同源的框架中显示。
WARNING
ALLOW-FROM <uri>选项已被弃用,因为Adobe Commerce支持的浏览器不再支持它。 查看浏览器兼容性

X_FRAME_CONFIGURATION环境变量添加到.magento.env.yaml文件中的global阶段:

stage:
  global:
    X_FRAME_CONFIGURATION: SAMEORIGIN
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26