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
- Standard—
1
- 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
- Standard—Nicht 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
- Standard—
6
- 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
- Standard—
600
- 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
- Standard—
false
- 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
- Standard—Nicht 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
- Standard—Nicht 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
SCD_STRATEGY
- Standard—
quick
- 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ürscd_threads
mit dem Wert1
.
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
- Standard—Nicht 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
SKIP_COMPOSER_DUMP_AUTOLOAD
- Standard— Nicht 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
- Standard— Nicht 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
- Standard—Nicht 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.🔗
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"