Global variables

Last update: February 3, 2025

CREATED FOR:

  • Developer

Global variables control actions across each phase of the Commerce deployment process: build, deploy, and post-deploy. Because global variables impact every phase, you must set them in the global stage of the .magento.env.yaml file:

stage:
  global:
    GLOBAL_VARIABLE_NAME: value

For more information about customizing the build and deploy process:

ENABLE_EVENTING

  • Default-Not set
  • Version—Adobe Commerce 2.4.5 and later

When set to true, enables cron to run message queue consumers. Adobe I/O Events for Adobe Commerce use message queues to expedite the delivery of critical events.

Adobe recommends that you also add the CRON_CONSUMERS_RUNNER variable to the deploy stage of the .magento.env.yaml file with cron_run set to true.

The following example shows a fully configured ENABLE_EVENTING variable.

stage:
  global:
    ENABLE_EVENTING: true
  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      max_messages: 0
      consumers: []

ENABLE_WEBHOOKS

  • Default-Not set
  • Version—Adobe Commerce 2.4.4 and later

When set to true, enables Commerce webhooks. The webhook runs on an external endpoint, such as an App Builder runtime action or a third-party inventory management system. The Webhooks Guide describes this feature in detail.

stage:
  global:
    ENABLE_WEBHOOKS: true

MIN_LOGGING_LEVEL

  • Default—Not set
  • Version—Adobe Commerce 2.1.4 and later

Overrides the minimum logging level for all output streams without changing the code, which helps when troubleshooting problems with deployment. For example, if your deployment fails, you can use this variable to increase the logging granularity globally. See Log levels. The min_level value in Logging handlers overwrites this setting.

stage:
  global:
    MIN_LOGGING_LEVEL: debug
WARNING
The setting for the MIN_LOGGING_LEVEL variable does not change the log level configuration for the file handler, which is set to debug by default.

SCD_ON_DEMAND

  • Default—Not set
  • Version—Adobe Commerce 2.1.4 and later

Enable generation of static content when requested by a user (SCD). Static content on demand is ideal for the development and testing workflow, because it decreases the deployment time.

Pre-loading the cache using the post_deploy hook reduces site downtime. The cache warming is available only for Pro projects that contain Staging and Production environments in the Cloud Console and for Starter projects. Add the SCD_ON_DEMAND environment variable to the global stage in the .magento.env.yaml file:

stage:
  global:
    SCD_ON_DEMAND: true

The SCD_ON_DEMAND variable skips the SCD in both phases (build and deploy), clears the pub/static and var/view_preprocessed folders, and writes the following to the app/etc/env.php file:

return array(
   ...
   'static_content_on_demand_in_production' => 1,
   ...
);

SCD_MAX_EXECUTION_TIME

  • Default—Not set
  • Version—Adobe Commerce 2.2.0 and later

Allows you to increase the maximum expected execution time for static content deployment.

By default, Adobe Commerce sets the maximum expected execution to 900 seconds, but in some scenarios you might need more time to complete the static content deployment for a Cloud project.

stage:
  global:
    SCD_MAX_EXECUTION_TIME: 3600
WARNING
If you have issues with static content files in your application after deployment, such as missing custom theme files, increase the maximum expected execution time to 900 seconds or higher.

SCD_NO_PARENT

  • Default—Not set
  • Version—Adobe Commerce 2.4.2 and later

Set to true to prevent generating static content for parent themes during the build and deployment phases. When this option is set to true, less static content is generated, which improves your overall build and deployment times.

stage:
  global:
    SCD_NO_PARENT: true

SCD_USE_BALER

  • Default—Not set
  • Version—Adobe Commerce 2.3.0 and later

Baler is a module that scans your generated JavaScript code and creates an optimized JavaScript bundle. Deploying the optimized bundle to your site can reduce the number of network requests when loading your site and improve page load times.

Set to true to run Baler after performing static content deployment.

stage:
  build:
    SCD_USE_BALER: true
NOTE
Install and configure the Baler module before using this feature. Because Baler is in alpha release, enable this option only on Staging environments.