Globale Variablen

Letzte Aktualisierung: 31. Januar 2025

Erstellt für:

  • Entwickler

Globale Variablen steuern Aktionen in jeder Phase des Commerce-Bereitstellungsprozesses: Erstellen, Bereitstellen und Nachbereitstellen. Da sich globale Variablen auf jede Phase auswirken, müssen Sie sie im global der .magento.env.yaml festlegen:

stage:
  global:
    GLOBAL_VARIABLE_NAME: value

Weitere Informationen zum Anpassen des Build- und Bereitstellungsprozesses finden Sie unter:

ENABLE_EVENTING

  • default-not set
  • Version—Adobe Commerce 2.4.5 und höher

Bei Festlegung auf true wird Cron aktiviert, um die Nachrichtenwarteschlange von Nutzern auszuführen. Adobe I/O Events für Adobe Commerce verwendet Nachrichtenwarteschlangen, um den Versand kritischer Ereignisse zu beschleunigen.

Adobe empfiehlt, auch die Variable CRON_CONSUMERS_RUNNER zum deploy der .magento.env.yaml hinzuzufügen, wobei cron_run auf true gesetzt ist.

Das folgende Beispiel zeigt eine vollständig konfigurierte ENABLE_EVENTING.

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 und höher

Wenn auf true gesetzt, werden Commerce-Webhooks aktiviert. Der Webhook wird über einen externen Endpunkt ausgeführt, z. B. eine App Builder-Laufzeitaktion oder ein Inventarverwaltungssystem eines Drittanbieters. Im Webhooks-Handbuch wird diese Funktion ausführlich beschrieben.

stage:
  global:
    ENABLE_WEBHOOKS: true

MIN_LOGGING_LEVEL

  • Standard—Nicht festgelegt
  • Version—Adobe Commerce 2.1.4 und höher

Überschreibt die minimale Protokollierungsstufe für alle Ausgabe-Streams, ohne den Code zu ändern, was bei der Fehlerbehebung bei Bereitstellungsproblemen hilfreich ist. Wenn beispielsweise Ihre Bereitstellung fehlschlägt, können Sie diese Variable verwenden, um die Protokollierungsgranularität global zu erhöhen. Siehe Protokollebenen. Der min_level Wert in Logging Handlern überschreibt diese Einstellung.

stage:
  global:
    MIN_LOGGING_LEVEL: debug
WARNING
Die Einstellung für die Variable MIN_LOGGING_LEVEL ändert nichts an der Konfiguration auf Protokollebene für den Datei-Handler, der standardmäßig auf debug festgelegt ist.

SCD_ON_DEMAND

  • Standard—Nicht festgelegt
  • Version—Adobe Commerce 2.1.4 und höher

Aktivieren der Generierung statischer Inhalte auf Anfrage eines Benutzers (SCD). Statische Inhalte bei Bedarf eignen sich ideal für den Entwicklungs- und Test-Workflow, da sie die Bereitstellungszeit verkürzen.

Vorausfüllen des Cache mithilfe des post_deploy Hooksdie Ausfallzeit der Site. Der Cache-Warming ist nur für Pro-Projekte verfügbar, die Staging- und Produktionsumgebungen im Cloud Console enthalten, sowie für Starter-Projekte. Fügen Sie die Umgebungsvariable SCD_ON_DEMAND zum global in der .magento.env.yaml hinzu:

stage:
  global:
    SCD_ON_DEMAND: true

Die Variable SCD_ON_DEMAND überspringt die SCD in beiden Phasen (Erstellen und Bereitstellen), löscht die pub/static und var/view_preprocessed Ordner und schreibt Folgendes in die app/etc/env.php:

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

SCD_MAX_EXECUTION_TIME

  • Standard—Nicht festgelegt
  • Version—Adobe Commerce 2.2.0 und höher

Ermöglicht die Verlängerung der maximal erwarteten Ausführungszeit für die Bereitstellung statischer Inhalte.

Standardmäßig legt Adobe Commerce die maximal erwartete Ausführung auf 900 Sekunden fest. In einigen Szenarien benötigen Sie jedoch möglicherweise mehr Zeit, um die statische Inhaltsbereitstellung für ein Cloud-Projekt abzuschließen.

stage:
  global:
    SCD_MAX_EXECUTION_TIME: 3600
WARNING
Wenn Sie nach der Bereitstellung Probleme mit statischen Inhaltsdateien in Ihrer Anwendung haben, z. B. fehlende benutzerdefinierte Design-Dateien, erhöhen Sie die erwartete maximale Ausführungszeit auf 900 Sekunden oder höher.

SCD_NO_PARENT

  • Standard—Nicht festgelegt
  • Version—Adobe Commerce 2.4.2 und höher

Wenn auf true gesetzt, wird verhindert, dass während der Build- und Bereitstellungsphase statische Inhalte für übergeordnete Designs generiert werden. Wenn diese Option auf true festgelegt ist, wird weniger statischer Inhalt generiert, wodurch die Erstellungs- und Bereitstellungszeiten insgesamt verbessert werden.

stage:
  global:
    SCD_NO_PARENT: true

SCD_USE_BALER

  • Standard—Nicht festgelegt
  • Version—Adobe Commerce 2.3.0 und höher

Baler ist ein Modul, das Ihren generierten JavaScript-Code scannt und ein optimiertes JavaScript-Bundle erstellt. Durch die Bereitstellung des optimierten Bundles auf Ihrer Site kann die Anzahl der Netzwerkanfragen beim Laden Ihrer Site reduziert und die Seitenladezeiten verbessert werden.

Legen Sie diese Option auf true fest, um die Ballenpresse nach der Bereitstellung statischer Inhalte auszuführen.

stage:
  build:
    SCD_USE_BALER: true
NOTE
Installieren und konfigurieren Sie das Ballenmodul, bevor Sie diese Funktion verwenden. Da Baller in der Alpha-Version vorliegt, aktivieren Sie diese Option nur in Staging-Umgebungen.