Erstellen von Variablen
Die folgenden Build-Variablen steuern Aktionen in der Build-Phase und können Werte von den globalen Variablen erben und überschreiben. Fügen Sie diese Variablen in den build
Schritt der .magento.env.yaml
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
- default—
1
- Version—Adobe Commerce 2.1.4 und höher
Legen Sie die Ebene der Verzeichnisverschachtelung für das Speichern von Fehlerberichtsdateien fest, um zu vermeiden, dass das Berichtsverzeichnis mit Zehntausenden von Dateien gefüllt wird, was die Verwaltung und Überprüfung der Daten erschweren kann. Die Standardeinstellung ist 1
. In der Regel müssen Sie den Standardwert nur ändern, wenn Sie Probleme bei der Verwaltung von Fehlerberichtsdateien im <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
Liste mit Adobe Commerce-Qualitäts-Patches angeben, die während der Bereitstellung angewendet werden sollen.
stage:
build:
QUALITY_PATCHES: [ ]
Im folgenden Beispiel werden drei Patches angegeben, die während der Bereitstellung angewendet werden sollen.
stage:
build:
QUALITY_PATCHES:
- MC-31387
- MDVA-4567
- MC-456345
Siehe Patches anwenden.
SCD_COMPRESSION_LEVEL
- default—
6
- Version—Adobe Commerce 2.1.4 und höher
Gibt an welche GZIP-Komprimierungsstufe (0
zu 9
) beim Komprimieren statischer Inhalte verwendet werden soll; 0
deaktiviert die Komprimierung.
stage:
build:
SCD_COMPRESSION_LEVEL: 4
SCD_COMPRESSION_TIMEOUT
- default—
600
- Version—Adobe Commerce 2.1.4 und höher
Wenn die Zeit, die zum Komprimieren der statischen Assets benötigt wird, das Komprimierungs-Timeout überschreitet, wird der Bereitstellungsprozess unterbrochen. Legen Sie die maximale Ausführungszeit in Sekunden für den Befehl zur Komprimierung statischer Inhalte fest.
stage:
build:
SCD_COMPRESSION_TIMEOUT: 800
SCD_NO_PARENT
- default—
false
- Version—Adobe Commerce 2.4.2 und höher
Wenn auf true
gesetzt, wird verhindert, dass während der Erstellungsphase statische Inhalte für übergeordnete Designs generiert werden.
Legen Sie während der Build-Phase SCD_NO_PARENT: false
fest, damit das Generieren statischer Inhalte 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
- 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 der unnötigen Design-Dateien reduziert 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 Gebietsschemata erstellt:
stage:
build:
SCD_MATRIX:
"Magento/backend":
language:
- en_US
- fr_FR
- af_ZA
Im folgenden Beispiel werden drei Designs mit drei Gebietsschemata 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 wählen, ob Design bereitgestellt soll:
stage:
build:
SCD_MATRIX:
"Magento/backend": [ ]
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 in der Cloud-Infrastruktur die maximal erwartete Ausführung auf 900 Sekunden fest. 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
- default—
quick
- Version—Adobe Commerce 2.2.0 und höher
Passen Sie die Bereitstellungsstrategie für statische Inhalte 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
- (Standard) minimiert die Bereitstellungszeit.compact
- Spart 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
- default—automatic
- Version—Adobe Commerce 2.1.4 und höher
Legt die Anzahl der Threads für die Bereitstellung statischer Inhalte fest. Der Standardwert wird anhand der erkannten CPU-Thread-Anzahl festgelegt und überschreitet den Wert 4 nicht. Eine Erhöhung der Thread-Anzahl beschleunigt die Bereitstellung statischer Inhalte; eine Verringerung der Thread-Anzahl verlangsamt die Bereitstellung. Sie können den Thread-Wert festlegen, z. B.:
stage:
build:
SCD_THREADS: 2
Um die Bereitstellungszeit weiter zu verkürzen, verwenden 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. 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
SKIP_COMPOSER_DUMP_AUTOLOAD
- Standard— Nicht festgelegt
- Version—Adobe Commerce 2.1.4 und höher
Legen Sie true
fest, um den composer dump-autoload
-Befehl 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, dass andere Befehle auf Code aus dem gelöschten generated
zugreifen.
Wenn Adobe Commerce composer dump-autoload
ausgeführt wird, werden automatisch geladene Dateien mit Links zu generierten Klassen im generated
erstellt, was in Produktionsumgebungen mit schreibgeschützten Dateisystemen kein Problem darstellt. Bei Cloud Docker-Installationen mit beschreibbaren Dateisystemen (die nur für Tests und die Entwicklung mit ./vendor/bin/ece-docker build:compose --with-test
erstellt wurden) können Sie den bin/magento -n setup:upgrade
-Befehl jedoch ohne die Option --keep-generated
ausführen, wodurch das generated
gelöscht wird. Wenn das Verzeichnis gelöscht wird, schlägt der composer dump-autoload
-Befehl fehl, da der Autoload 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
Wenn auf true
gesetzt, wird die statische Inhaltsbereitstellung während der Erstellungsphase übersprungen.
Wenn Sie bereits während der Build-Phase mit Konfigurationsverwaltung statische Inhalte bereitstellen, können Sie die Bereitstellung statischer Inhalte für einen schnellen Build-Test überspringen.
Legen Sie in der Build-Phase SKIP_SCD: false
so fest, dass der statische Inhaltserstellungsprozess während der Build-Phase stattfindet, in der der Prozess keine Auswirkungen auf die Site-Bereitstellung hat oder unnötige Site-Ausfallzeiten verursacht. Siehe Statische Inhaltsbereitstellung.
stage:
build:
SKIP_SCD: false
VERBOSE_COMMANDS
- Standard—Nicht 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.
bin/magento
CLI-Befehle zu verwenden, müssen Sie MIN_LOGGING_LEVEL debug
festlegen.Wählen Sie den Detaillierungsgrad der Protokolle aus:
-v
= Normalausgabe-vv
= Ausführlichere Ausgabe-vvv
= ausführliche Ausgabe Ideal für die Fehlersuche
stage:
build:
VERBOSE_COMMANDS: "-vv"