Erstellen von Variablen

Die folgenden build -Variablen steuern -Aktionen in der Build-Phase und können Werte von der Globale Variablen. Fügen Sie diese Variablen in die build der .magento.env.yaml Datei:

stage:
  build:
    BUILD_VARIABLE_NAME: value

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

Die folgenden Variablen wurden in Version 2.2 entfernt:

  • skip_di_clearing
  • skip_di_compilation

ERROR_REPORT_DIR_NESTING_LEVEL

  • Standard1
  • Version—Adobe Commerce 2.1.4 und höher

Legen Sie die Verzeichnisverschachtelungsebene zum Speichern von Fehlerberichtsdateien fest, um zu vermeiden, dass der Berichtordner mit Zehntausenden von Dateien gefüllt wird, wodurch die Verwaltung und Überprüfung der Daten erschwert werden kann. Diese Einstellung ist standardmäßig auf 1. Normalerweise müssen Sie den Standardwert nur ändern, wenn Sie Probleme bei der Verwaltung von Fehlerberichtsdateien im <magento_root>/var/report/ Verzeichnis.

stage:
  build:
    ERROR_REPORT_DIR_NESTING_LEVEL: 2

QUALITY_PATCHES

  • StandardNicht festgelegt
  • Version—Adobe Commerce 2.1.4 und höher

Geben Sie eine Liste der Adobe Commerce-Qualitäts-Patches an, die während der Bereitstellung angewendet werden sollen.

stage:
  build:
    QUALITY_PATCHES: [ ]

Im folgenden Beispiel werden drei Patches aufgeführt, die während der Bereitstellung angewendet werden sollen.

stage:
  build:
    QUALITY_PATCHES:
      - MC-31387
      - MDVA-4567
      - MC-456345

Siehe Anwenden von Patches.

SCD_COMPRESSION_LEVEL

  • Standard6
  • Version—Adobe Commerce 2.1.4 und höher

Gibt an, gzip Komprimierungsstufe (0 nach 9) für die Komprimierung von statischem Inhalt; 0 Deaktiviert die Komprimierung.

stage:
  build:
    SCD_COMPRESSION_LEVEL: 4

SCD_COMPRESSION_TIMEOUT

  • Standard600
  • Version—Adobe Commerce 2.1.4 und höher

Wenn die zum Komprimieren der statischen Assets benötigte Zeit das Zeitlimit für die Komprimierung überschreitet, wird der Bereitstellungsprozess unterbrochen. Legen Sie die maximale Ausführungszeit in Sekunden für den Befehl zur statischen Inhaltskomprimierung fest.

stage:
  build:
    SCD_COMPRESSION_TIMEOUT: 800

SCD_NO_PARENT

  • Standardfalse
  • Version—Adobe Commerce 2.4.2 und höher

Legen Sie true , um zu verhindern, dass statische Inhalte für übergeordnete Designs während der Build-Phase generiert werden.

Satz SCD_NO_PARENT: false während der Build-Phase, sodass das Generieren von statischem Inhalt für die übergeordneten Designs keine Auswirkungen auf die Site-Bereitstellung hat oder zu unnötigen Site-Ausfallzeiten führt. Siehe Statische Inhaltsbereitstellung.

stage:
  build:
    SCD_NO_PARENT: false

SCD_MATRIX

  • StandardNicht festgelegt
  • Version—Adobe Commerce 2.1.4 und höher

Sie können mehrere Gebietsschemata pro Design konfigurieren. Diese Anpassung beschleunigt den Build-Prozess, indem die Anzahl unnötiger Designdateien verringert wird. Sie können beispielsweise die Magento/Backend Thema auf Englisch und ein benutzerdefiniertes Thema in anderen Sprachen.

Im folgenden Beispiel wird die Magento/backend Design mit drei Gebietsschemata:

stage:
  build:
    SCD_MATRIX:
      "Magento/backend":
        language:
          - en_US
          - fr_FR
          - af_ZA

Im folgenden Beispiel werden drei Designs mit drei Gebietsschemas erstellt:

stage:
  build:
    SCD_MATRIX:
      "Magento/backend":
        language:
          - en_US
          - fr_FR
          - af_ZA
      "Magento/blank":
        language:
          - en_US
          - fr_FR
          - af_ZA
      "Magento/luma":
        language:
          - en_US
          - fr_FR
          - af_ZA

Sie können auch auswählen, not Bereitstellen eines Designs:

stage:
  build:
    SCD_MATRIX:
      "Magento/backend": [ ]

SCD_MAX_EXECUTION_TIME

  • StandardNicht festgelegt
  • Version—Adobe Commerce 2.2.0 und höher

Ermöglicht Ihnen, die maximale erwartete Ausführungszeit für die Bereitstellung statischer Inhalte zu erhöhen.

Standardmäßig setzt Adobe Commerce in der Cloud-Infrastruktur die maximal erwartete Ausführung auf 900 Sekunden. In einigen Szenarien benötigen Sie jedoch möglicherweise mehr Zeit, um die Bereitstellung statischer Inhalte für ein Cloud-Projekt abzuschließen.

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

SCD_STRATEGY

  • Standardquick
  • Version—Adobe Commerce 2.2.0 und höher

Anpassen der Implementierungsstrategie für statischen Inhalt. Siehe Bereitstellen von statischen Ansichtsdateien.

Verwenden Sie diese Optionen only wenn Sie mehr als ein Gebietsschema haben:

  • standard—stellt alle statischen Ansichtsdateien für alle Pakete bereit.
  • quick—(default) minimiert die Bereitstellungszeit.
  • compact—speichert Speicherplatz auf dem Server. In Adobe Commerce Version 2.2.4 und früher überschreibt diese Einstellung den Wert für scd_threads mit dem Wert 1.
stage:
  build:
    SCD_STRATEGY: "compact"

SCD_THREADS

  • Standard—Automatisch
  • Version—Adobe Commerce 2.1.4 und höher

Legt die Anzahl der Threads für die Bereitstellung statischer Inhalte fest. Der Standardwert wird basierend auf der erkannten CPU-Thread-Anzahl festgelegt und überschreitet nicht den Wert 4. Durch die Erhöhung der Thread-Anzahl wird die Bereitstellung statischer Inhalte beschleunigt, und die Verringerung der Thread-Anzahl verlangsamt die Bereitstellung. Sie können den Thread-Wert festlegen, beispielsweise:

stage:
  build:
    SCD_THREADS: 2

Verwenden Sie zur weiteren Verkürzung der Bereitstellungszeit Konfigurationsverwaltung mit dem scd-dump -Befehl, um die statische Bereitstellung in die Build-Phase zu verschieben.

SCD_USE_BALER

  • StandardNicht festgelegt
  • Version—Adobe Commerce 2.3.0 und höher

Baler scannt den generierten JavaScript-Code und erstellt ein optimiertes JavaScript-Bundle. Wenn Sie das optimierte Bundle auf Ihrer Site bereitstellen, kann sich die Anzahl der Netzwerkanforderungen beim Laden Ihrer Site verringern und die Seitenladezeiten verbessern.

Legen Sie true , um Baler nach der Bereitstellung statischer Inhalte auszuführen.

stage:
  build:
    SCD_USE_BALER: true
NOTE
Da Baler in der Alpha-Version verfügbar ist, ist es nicht ratsam, es in Produktionsumgebungen zu verwenden.

SKIP_COMPOSER_DUMP_AUTOLOAD

  • StandardNicht festgelegt
  • Version—Adobe Commerce 2.1.4 und höher

Legen Sie true , um die composer dump-autoload -Befehl während einer Cloud Docker-Installation. Diese Variable ist nur für Cloud Docker-Container mit beschreibbaren Dateisystemen relevant. In solchen Fällen verhindert das Überspringen des Befehls Fehler durch andere Befehle, die versuchen, auf den Code aus dem gelöschten generated Verzeichnis.

Wenn Adobe Commerce ausgeführt wird composer dump-autoload, erstellt es automatische Dateien mit Links zu generierten Klassen in der generated -Ordner, was in Produktionsumgebungen mit schreibgeschützten Dateisystemen kein Problem darstellt. Für Cloud Docker-Installationen mit beschreibbaren Dateisystemen (nur für Tests und Entwicklung mit ./vendor/bin/ece-docker build:compose --with-test), können Sie die bin/magento -n setup:upgrade -Befehl ohne --keep-generated -Option, mit der die generated Verzeichnis. Wenn das Verzeichnis gelöscht wird, wird die composer dump-autoload schlägt fehl, da die automatische Aktualisierung Links zu Dateien im gelöschten Verzeichnis enthält.

stage:
  build:
    SKIP_COMPOSER_DUMP_AUTOLOAD: true

SKIP_SCD

  • StandardNicht festgelegt
  • Version—Adobe Commerce 2.1.4 und höher

Legen Sie true , um die Bereitstellung statischer Inhalte während der Build-Phase zu überspringen.

Wenn Sie statischen Inhalt bereits während der Build-Phase mit Konfigurationsverwaltungkönnen Sie die Bereitstellung statischer Inhalte für einen schnellen Build-Test überspringen.

Legen Sie in der Build-Phase SKIP_SCD: false sodass der Aufbau statischer Inhalte während der Build-Phase erfolgt, in der der Prozess keine Auswirkungen auf die Site-Bereitstellung hat oder zu unnötigen Site-Ausfallzeiten führt. Siehe Statische Inhaltsbereitstellung.

stage:
  build:
    SKIP_SCD: false

VERBOSE_COMMANDS

  • StandardNicht festgelegt
  • Version—Adobe Commerce 2.1.4 und höher

Aktivieren oder deaktivieren Sie die Symfony Debug-Ausführlichkeitsstufe für bin/magento CLI-Befehle, die während der Bereitstellungsphase ausgeführt werden.

NOTE
So steuern Sie mit VERBOSE_COMMANDS die Details in der Befehlsausgabe für erfolgreich und fehlgeschlagen bin/magento CLI-Befehle, müssen Sie festlegen MIN_LOGGING_LEVEL debug.

Wählen Sie den Detailgrad aus, der in den Protokollen angegeben wird:

  • -v= normale Ausgabe
  • -vv= ausführlichere Ausgabe
  • -vvv = ausführliche Ausgabe, ideal für das Debugging
stage:
  build:
    VERBOSE_COMMANDS: "-vv"
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26