Technische Details

In diesem Abschnitt werden technische Implementierungsdetails zur Pipeline-Bereitstellung in Commerce 2.2 und höher erläutert. Die Verbesserungen lassen sich in folgende Bereiche unterteilen:

In diesem Thema wird auch der empfohlene Workflow für die Pipeline-Bereitstellung erläutert und einige Beispiele bereitgestellt, die Ihnen dabei helfen, die Funktionsweise zu verstehen.

Bevor Sie beginnen, lesen Sie die Voraussetzungen für Ihre Entwicklungs-, Build- und Produktionssysteme.

Konfigurationsverwaltung

Verwenden Sie das folgende Überschreibungsschema, um die Konfiguration Ihrer Entwicklungs- und Produktionssysteme synchronisieren und verwalten zu können.

Wie das Diagramm zeigt, werden die Konfigurationswerte in der folgenden Reihenfolge verwendet:

Verwalten der freigegebenen Konfiguration

Die freigegebene Konfiguration wird in app/etc/config.php gespeichert, das sich in der Quell-Code-Verwaltung befinden sollte.

Legen Sie die freigegebene Konfiguration im Admin-System in Ihrer Entwicklungsumgebung (oder im Adobe Commerce--) fest und schreiben Sie die Konfiguration mithilfe des magento app:config:dump-Befehls in config.php.

Verwalten der systemspezifischen Konfiguration

Die systemspezifische Konfiguration wird in app/etc/env.php gespeichert, das nicht der Quell-Code-Verwaltung sein sollte.

Legen Sie die systemspezifische Konfiguration im Admin-System in Ihrem Entwicklungssystem (oder in Adobe Commerce für die Cloud-Infrastrukturintegration) fest und schreiben Sie die Konfiguration mithilfe des magento app:config:dump-Befehls in env.php.

Dieser Befehl schreibt auch vertrauliche Einstellungen in env.php.

Verwalten der sensiblen Konfiguration

Die vertrauliche Konfiguration wird auch in app/etc/env.php gespeichert.

Sie können die vertrauliche Konfiguration auf eine der folgenden Arten verwalten:

Konfigurationseinstellungen im Administrator gesperrt

Alle Konfigurationseinstellungen in config.php oder env.php sind im Administrator gesperrt, d. h. diese Einstellungen können im Administrator nicht geändert werden.
Verwenden Sie den Befehl magento config:set oder magento config:set --lock, um die Einstellungen in den config.php- oder env.php-Dateien zu ändern.

Der Commerce-Administrator

Der Administrator zeigt im Produktionsmodus das folgende Verhalten:

Installieren und Entfernen von Cron

In Version 2.2 helfen wir Ihnen zum ersten Mal, Ihren Cron-Auftrag einzurichten, indem wir den magento cron:install Befehl bereitstellen. Mit diesem Befehl wird eine crontab als Benutzer eingerichtet, der den Befehl ausführt.

Außerdem können Sie die crontab mit dem Befehl magento cron:remove entfernen.

Empfohlener Workflow zur Pipeline-Bereitstellung

Das folgende Diagramm zeigt, wie die Pipeline-Bereitstellung zur Verwaltung der Konfiguration empfohlen wird.

Entwicklungssystem

Auf Ihrem Entwicklungssystem nehmen Sie Konfigurationsänderungen in der Admin Console vor und generieren die freigegebene Konfiguration, die app/etc/config.php und die systemspezifische Konfiguration, app/etc/env.php. Überprüfen Sie den Commerce-Code und die freigegebene Konfiguration in die Quell-Code-Verwaltung und übertragen Sie sie auf den Build-Server.

Sie sollten auch Erweiterungen installieren und den Commerce-Code im Entwicklungssystem anpassen.

Auf Ihrem Entwicklungssystem:

Nach Ausführung der Befehle zum Löschen der Assets generiert Commerce Arbeitsdateien.

Build-System

Das Build-System kompiliert Code und generiert statische Ansichtsdateien für Designs, die in Commerce registriert sind. Sie benötigt keine Verbindung zur Commerce-Datenbank, sondern nur die Commerce-Code-Basis.

Auf Ihrem Build-System:

Produktionssystem

Auf Ihrem Produktionssystem (d. h. Ihrem Live Store) rufen Sie generierte Assets und Code-Aktualisierungen von der Versionsverwaltung ab und legen Sie systemspezifische und vertrauliche Konfigurationseinstellungen mithilfe der Befehlszeile oder von Umgebungsvariablen fest.

Auf Ihrem Produktionssystem:

Konfigurationsverwaltungsbefehle

Die folgenden Befehle helfen Ihnen bei der Verwaltung der Konfiguration:

Beispiele für die Konfigurationsverwaltung

Dieser Abschnitt zeigt Beispiele für die Verwaltung der Konfiguration, sodass Sie sehen können, wie Änderungen an config.php und env.php vorgenommen werden.

Standardgebietsschema ändern

Dieser Abschnitt zeigt die Änderung, die an config.php vorgenommen wurde, wenn Sie die standardmäßige Gewichtungseinheit mithilfe von Admin ändern (Stores > Einstellungen > Configuration > Allgemein Allgemein > Gebietsschema-Optionen).

Nachdem Sie die Änderung in der Admin vorgenommen haben, führen Sie bin/magento app:config:dump aus, um den Wert in config.php zu schreiben. Der Wert wird in das general-Array unter locale geschrieben, wie der folgende Ausschnitt aus config.php zeigt:

'general' =>
    array (
        'locale' =>
        array (
            'code' => 'en_US',
            'timezone' => 'America/Chicago',
            'weight_unit' => 'kgs'
        )
    )

Ändern mehrerer Konfigurationseinstellungen

In diesem Abschnitt werden die folgenden Konfigurationsänderungen erläutert:

Nachdem Sie die Änderung in der Admin vorgenommen haben, führen Sie bin/magento app:config:dump auf Ihrem Entwicklungssystem aus. Diesmal werden nicht alle Ihre Änderungen in config.php geschrieben. Tatsächlich werden nur die Website-, Store- und Store-Ansicht in diese Datei geschrieben, wie die folgenden Ausschnitte zeigen.

config.php

config.php enthält:

websites:

      'new' =>
      array (
        'website_id' => '2',
        'code' => 'new',
        'name' => 'New website',
        'sort_order' => '0',
        'default_group_id' => '2',
        'is_default' => '0',
      ),

groups:

      2 =>
      array (
        'group_id' => '2',
        'website_id' => '2',
        'code' => 'newstore',
        'name' => 'New store',
        'root_category_id' => '2',
        'default_store_id' => '2',
      ),

stores:

     'newview' =>
      array (
        'store_id' => '2',
        'code' => 'newview',
        'website_id' => '2',
        'group_id' => '2',
        'name' => 'New store view',
        'sort_order' => '0',
        'is_active' => '1',
      ),

payment:

      'payment' =>
      array (
        'paypal_express' =>
        array (
          'active' => '0',
          'in_context' => '0',
          'title' => 'PayPal Express Checkout',
          'sort_order' => NULL,
          'payment_action' => 'Authorization',
          'visible_on_product' => '1',
          'visible_on_cart' => '1',
          'allowspecific' => '0',
          'verify_peer' => '1',
          'line_items_enabled' => '1',
          'transfer_shipping_options' => '0',
          'solution_type' => 'Mark',
          'require_billing_address' => '0',
          'allow_ba_signup' => 'never',
          'skip_order_review_step' => '1',
        ),

env.php

Die systemspezifische Konfigurationseinstellung der Standard-E-Mail-Domain wird in app/etc/env.php geschrieben.

Die PayPal-Einstellungen werden in keine der Dateien geschrieben, da der bin/magento app:config:dump-Befehl keine sensiblen Einstellungen schreibt. Sie müssen die PayPal-Einstellungen auf dem Produktionssystem mit den folgenden Befehlen festlegen:

bin/magento config:sensitive:set paypal/wpp/api_username <username>

bin/magento config:sensitive:set paypal/wpp/api_password <password>