Speicherkonfigurationsverwaltung

Die Standardkonfigurationen für Ihren Store werden in einem config.xml für das entsprechende Modul gespeichert. Wenn Sie die Einstellungen im Commerce Admin- oder CLI bin/magento config:set-Befehl ändern, werden die Änderungen in der Hauptdatenbank, insbesondere in der Tabelle core_config_data, übernommen. Diese Einstellungen überschreiben die Standardkonfigurationen, die in der Datei config.xml gespeichert sind.

Speichereinstellungen, die auf die Konfigurationen im Abschnitt Admin Stores > Einstellungen > Konfiguration verweisen, werden je nach Konfigurationstyp in den Konfigurationsdateien der Bereitstellung gespeichert:

Das Konfigurationsmanagement bietet eine Möglichkeit, konsistente Speichereinstellungen in all Ihren Umgebungen bereitzustellen, ohne dass die Pipeline-Bereitstellung zu minimalen Ausfallzeiten führt. Das Projekt Adobe Commerce on Cloud-Infrastruktur umfasst den Build-Server, das Erstellen und Bereitstellen von Skripten sowie Bereitstellungsumgebungen, die unter Berücksichtigung der Pipeline-Bereitstellungsstrategie entwickelt wurden.

Konfigurationsüberschreibungsschema

Alle Systemkonfigurationen werden während der Build- und Bereitstellungsphasen gemäß dem folgenden Überschreibungsschema festgelegt:

Zusammenfassend lässt sich sagen, dass Umgebungsvariablen alle anderen Werte außer Kraft setzen.

Wenn dieselbe Einstellung an mehreren Stellen konfiguriert ist, verlässt sich die Anwendung auf die folgende Konfigurationshierarchie, um zu bestimmen, welcher Wert auf die Umgebung angewendet werden soll:

Konfigurations-Dump

Sie können den folgenden ece-tools-Befehl verwenden, um eine config.php -Datei zu generieren, die alle aktuellen Speicherkonfigurationen enthält:

./vendor/bin/ece-tools config:dump

Die in die Datei "app/etc/config.php" übertragenen Daten werden zu "locked", was bedeutet, dass das entsprechende Feld im Commerce-Admin "schreibgeschützt" wird. Die Datei config.php enthält nur die Einstellungen, die Sie konfigurieren. Die Standardwerte werden nicht gesperrt. Durch das Sperren nur der von Ihnen aktualisierten Werte wird außerdem sichergestellt, dass alle in der Staging- und Produktionsumgebung verwendeten Erweiterungen aufgrund schreibgeschützter Konfigurationen nicht beschädigt werden, insbesondere schnell.

Sensible Daten

Alle sensiblen Konfigurationen werden in die Datei app/etc/env.php exportiert, wenn Sie den Befehl bin/magento app:config:dump verwenden. Sie können sensible Werte mithilfe des CLI-Befehls festlegen: bin/magento config:sensitive:set. Unter Vertrauliche und umgebungsspezifische Einstellungen im Handbuch Commerce PHP Extensions erfahren Sie, wie Konfigurationseinstellungen als vertraulich oder systemspezifisch gekennzeichnet werden.

Eine Liste der vertraulichen oder systemspezifischen Einstellungen finden Sie im Konfigurationshandbuch.

SCD-Leistung

Abhängig von der Größe Ihres Stores können Sie eine große Anzahl statischer Inhaltsdateien bereitstellen. Normalerweise werden statische Inhalte während der Bereitstellungsphase bereitgestellt, wenn sich die Anwendung im Wartungsmodus befindet. Die optimale Konfiguration besteht darin, während der Build-Phase statischen Inhalt zu generieren. Siehe Auswählen einer Bereitstellungsstrategie.

Wenn Sie Configuration Management nach dem Ablegen der Konfigurationen aktiviert haben, sollten Sie die SCD_*-Variablen aus der Bereitstellungsphase in die Build-Phase verschieben, um während der Build-Phase die statische Inhaltserstellung ordnungsgemäß zu aktivieren. Siehe Umgebungsvariablen.

Vor der Konfigurationsverwaltung:

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...
    REDIS_USE_SLAVE_CONNECTION: 1

Nach Aktivierung der Konfigurationsverwaltung:

Verschieben Sie die SCD_*-Variablen in die Build-Phase:

  deploy:
    CRON_CONSUMERS_RUNNER:
      cron_run: true
      consumers: []
    REDIS_USE_SLAVE_CONNECTION: 1
  build:
    SCD_STRATEGY: compact
    SCD_MATRIX:
      ...

Verfahren zur Verwaltung Ihrer Einstellungen

Die folgende Abbildung zeigt einen allgemeinen Überblick über diesen Prozess:

So konfigurieren Sie Ihren Speicher und generieren eine Konfigurationsdatei:

Melden Sie sich nach Abschluss der Bereitstellung beim Administrator für die aktualisierte Umgebung an, um die Einstellungen zu überprüfen. Führen Sie bei Bedarf weitere Konfigurationen mit den Staging- und Produktionsumgebungen zusammen.

Konfigurationen aktualisieren

Wenn Sie Ihre Umgebung über den Admin ändern und den Befehl erneut ausführen, werden neue Konfigurationen an den Code in der Datei config.php angehängt.

Konfigurationsdateien wiederherstellen

Kopien der ursprünglichen app/etc/env.php - und app/etc/config.php -Dateien wurden während des Bereitstellungsprozesses erstellt und im selben Ordner gespeichert. Im Folgenden werden die BAK (Backup-Dateien) und PHP (Originaldateien) im selben Ordner app/etc dargestellt:

...
config.php.bak
di.xml
env.php.bak
vendor_path.php
config.php
db_schema.xml
env.php
...

Ältere Konfigurationen verwendeten die Datei "app/etc/config.local.php". Siehe Migration älterer Konfigurationen.

So stellen Sie Konfigurationsdateien wieder her:

Migration älterer Konfigurationen

Wenn Sie auf Adobe Commerce in der Cloud-Infrastruktur 2.2 oder höher aktualisieren, sollten Sie Einstellungen aus der config.local.php -Datei in Ihre neue config.php -Datei migrieren. Wenn die Konfigurationseinstellungen in Ihrem Admin mit dem Inhalt der Datei übereinstimmen, befolgen Sie die Anweisungen zum Generieren und Hinzufügen der Datei "config.php".

Wenn sie sich unterscheiden, können Sie Inhalt aus der config.local.php-Datei an Ihre neue config.php-Datei anhängen:

Sie führen diese Migration nur einmal durch. Verwenden Sie nach der Migration die Datei "config.php".

Gebietsschemata ändern

Sie können Ihre Store-Gebietsschemata ändern, ohne einen komplexen Konfigurationsimport- und -export-Prozess zu befolgen, wenn Sie SCD_ON_DEMAND aktiviert haben. Sie können die Gebietsschemata mithilfe des Administrators aktualisieren.

Sie können der Staging- oder Produktionsumgebung ein anderes Gebietsschema hinzufügen, indem Sie in einer Integrationsverzweigung die Option SCD_ON_DEMAND aktivieren, eine aktualisierte config.php -Datei mit den neuen Gebietsschemainformationen generieren und die Konfigurationsdatei in die Zielumgebung kopieren.