Technische Details

In diesem Thema 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, anhand derer Sie verstehen können, wie er funktioniert.

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

Konfigurationsverwaltung

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

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 Adobe Commerce in der Cloud-Infrastruktur integration) fest und schreiben Sie die Konfiguration mit dem Befehl magento app:config:dump in config.php.

Systemspezifische Konfiguration verwalten

Die systemspezifische Konfiguration wird in app/etc/env.php gespeichert, wobei nicht im Quell-Code sein sollte.

Legen Sie die systemspezifische Konfiguration im Admin-System Ihres Entwicklungs- (oder Adobe Commerce-Integrationssystems der Cloud-Infrastruktur) fest und schreiben Sie die Konfiguration mit dem Befehl magento app:config:dump auf env.php.

Dieser Befehl schreibt auch vertrauliche Einstellungen in env.php.

Vertrauliche Konfiguration verwalten

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

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

In Admin gesperrte Konfigurationseinstellungen

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

Der Commerce-Administrator

Der Administrator weist im Produktionsmodus folgendes Verhalten auf:

Installieren und Entfernen von Cron

In Version 2.2 helfen wir Ihnen beim erstmaligen Einrichten Ihres Cron-Auftrags durch Bereitstellung des Befehls magento cron:install. Mit diesem Befehl wird eine Crontab als der Benutzer eingerichtet, der den Befehl ausführt.

Sie können die Registerkarte auch mit dem Befehl magento cron:remove entfernen.

Empfohlener Pipeline-Bereitstellungs-Workflow

Das folgende Diagramm zeigt, wie wir empfehlen, die Pipeline-Implementierung zur Verwaltung der Konfiguration zu verwenden.

Entwicklungssystem

Auf Ihrem Entwicklungssystem nehmen Sie Konfigurationsänderungen im Admin vor und generieren die freigegebene Konfiguration 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 pushen Sie ihn an den Build-Server.

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

Auf Ihrem Entwicklungssystem:

Nachdem Sie die Befehle zum Löschen der Assets ausgeführt haben, generiert Commerce Arbeitsdateien.

Build-System

Das Build-System kompiliert Code und generiert statische Ansichtsdateien für Designs, die in Commerce registriert sind. Es ist keine Verbindung zur Commerce-Datenbank erforderlich, sondern nur die Commerce-Codebasis.

Auf Ihrem Build-System:

Produktionssystem

Auf Ihrem Produktionssystem (d. h. Ihrem Live Store) rufen Sie generierte Assets und Codeaktualisierungen aus der Quellcodeverwaltung ab und legen systemspezifische und vertrauliche Konfigurationseinstellungen mithilfe der Befehlszeile oder Umgebungsvariablen fest.

In Ihrem Produktionssystem:

Konfigurationsverwaltungsbefehle

Wir stellen die folgenden Befehle bereit, um Sie bei der Verwaltung der Konfiguration zu unterstützen:

Beispiele für die Konfigurationsverwaltung

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

Standardgebietsschema ändern

In diesem Abschnitt wird die Änderung an config.php angezeigt, wenn Sie die Standardgewichtseinheit mithilfe des Administrators ändern (Geschäfte > Einstellungen > Konfiguration > Allgemein > Allgemein > Gebietsschemaoptionen).

Nachdem Sie die Änderung im 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 Array general unter locale geschrieben, wie das folgende Codefragment aus config.php zeigt:

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

Mehrere Konfigurationseinstellungen ändern

In diesem Abschnitt werden die folgenden Konfigurationsänderungen besprochen:

Nachdem Sie die Änderung im 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 Snippets zeigen.

config.php

config.php enthält:

websites array:

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

groups array:

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

stores array:

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

payment array:

      '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 standardmäßige systemspezifische Konfigurationseinstellung der E-Mail-Domain wird in app/etc/env.php geschrieben.

Die PayPal-Einstellungen werden in keine der beiden Dateien geschrieben, da der Befehl bin/magento app:config:dump keine vertraulichen Einstellungen schreibt. Sie müssen die PayPal-Einstellungen im 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>