Erstellen von Variablen

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

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 eingestellt. In der Regel müssen Sie den Standardwert nur ändern, wenn Sie Probleme bei der Verwaltung von Fehlerberichtsdateien im Verzeichnis <magento_root>/var/report/ haben.

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, welche gzip-Komprimierungsstufe (0 bis 9) beim Komprimieren statischen Inhalts verwendet werden soll. 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

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

Legen Sie während der Build-Phase den Wert "SCD_NO_PARENT: false"fest, damit 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 Bereitstellung statischer Inhalte.

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 das Design magento/backend auf Englisch und ein benutzerdefiniertes Design in anderen Sprachen erstellen.

Im folgenden Beispiel wird das Magento/backend -Design mit drei Gebietsschemas erstellt:

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 festlegen, dass nicht ein Design bereitstellt:

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

Passen Sie die Bereitstellungsstrategie für statischen Inhalt an. Siehe Bereitstellen von statischen Ansichtsdateien.

Verwenden Sie diese Optionen nur , 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

Um die Bereitstellungszeit weiter zu verkürzen, verwenden Sie Konfigurationsverwaltung mit dem Befehl scd-dump , 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 Ihren 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 diese Einstellung auf "true"fest, 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

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

Wenn Adobe Commerce composer dump-autoload ausführt, werden automatische Dateien mit Links zu generierten Klassen im Ordner generated erstellt, was in Produktionsumgebungen mit schreibgeschützten Dateisystemen kein Problem darstellt. Bei Cloud Docker-Installationen mit beschreibbaren Dateisystemen (die nur zum Testen und Entwickeln mit ./vendor/bin/ece-docker build:compose --with-test erstellt wurden) können Sie jedoch den Befehl bin/magento -n setup:upgrade ohne die Option --keep-generated ausführen, wodurch der Ordner generated gelöscht wird. Wenn das Verzeichnis gelöscht wird, schlägt der Befehl composer dump-autoload 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

Setzen Sie dies auf "true", um die Bereitstellung statischer Inhalte während der Build-Phase zu überspringen.

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

Setzen Sie in der Erstellungsphase SKIP_SCD: false so, dass der statische Inhaltserstellung während der Erstellungsphase erfolgt, wobei der Prozess keine Auswirkungen auf die Site-Bereitstellung hat oder zu unnötigen Site-Ausfallzeiten führt. Siehe Bereitstellung statischer Inhalte.

stage:
  build:
    SKIP_SCD: false

VERBOSE_COMMANDS

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

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

NOTE
Um VERBOSE_COMMANDS zur Steuerung der Details in der Befehlsausgabe für erfolgreiche und fehlgeschlagene bin/magento CLI-Befehle zu verwenden, müssen Sie MIN_LOGGING_LEVEL debug festlegen.

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